[docs][chore] add documentation for the api surface

[BeauBouchard]

The API should be a learning utility and well documented.

Programableweb no longer exists as of Feb 2023, We previously had a lot of exposure from their listing as a learning resource, and would like to document the free api on other platforms. rapidapi is a robust platform which has a lot of good free resources for small teams, it also gets people started using the api with code snippets and allows for people to query the api in a postman like web panel.

Tasks

• Create a swagger/oapi3.0 document for the API
• Create organization on rapidapi
• Create shrewd documentation as apart of the org
• update README.md with new link to the rapidapi page