Overview - v3

This is the current major version of the API.

Making an API Call

The base path to the latest version of our API is:
https://api.commonsense.org/api/v3

API Keys

API keys are granted upon initiation of a partnership agreement. If you do not have a partnership agreement with us, please contact us.

The API key is preferred be passed via an HTTP header:
x-api-key: [$your_api_key]

Requests

  • All requests must use HTTPS.
  • Our API is rate limited to 100 unique requests per minute. If you pull our data from multiple data centers, please stagger your pulls.
  • All requests must use the GET method unless otherwise specified.

Updated Content

New content and changes to existing content are available in the API regularly. However, there is no need to pull changes any more frequently than once an hour.