Authentication
The API uses keys for authentication, and your key is similar to a password. Avoid distributing your API key to other users, or hard-coding it. Generate a new key whenever you think your account may have been compromised.
For security reasons, your API key automatically expires every 90 days. When your key has expired, you must generate a new one to continue using the API.
Note
If your policies require you to rotate keys more often, you can always generate a new key. If you want to pause using the API without deleting your account, you can revoke your API key.
Before you begin, sign up for a free account, or if you already have one, sign in.
The process of managing your API key can be divided into the following tasks:
- Retrieve your API key: Go to the API Key page, and select the Copy icon to the right of the key to copy it to your clipboard.
- Generate a new API key: Go to the API Key page, and then select the Regenerate Key button under the API Key section.
- Revoke an API key: Go to the API Key page, and then select the Revoke Key button under the API Key section.
You can interact with the platform using an available SDK or an HTTP client like requests
or axios
. Follow the steps in one of the sections below, depending on your use case.
Use an SDK
If you are using an SDK client, provide your API key when instantiating the client.
Below are complete code examples for Python and Node.js, integrating all the steps outlined above:
Use an HTTP client
If you are making HTTP requests using clients such as requests
or axios
, include the API key in the header of each request.
Below are complete code examples for Python and Node.js, integrating all the steps outlined above: