Skip to main content
Every API request to the CreatorDB API must be authenticated with an API key, a secure string like LE6DPZQkR3TQShxofXoD2j8qCBu1-f0jti665m1t50dwDD12W. The API key is the same as the api-key in the request header. Authentication requires the key in string format.

​
Getting an API key

API usage is billed to the account that owns the key, not the person making the calls. If you’re using a key issued by someone else, a teammate or a shared organization key, their account is charged for your usage.
You cannot create an API key if your account has no credits. Check your account’s credit balance and purchase additional credits if necessary.
You can get an API key through the CreatorDB app dashboard by following these steps:
  1. Log in to CreatorDB.
  2. Click API.
  3. Click + Create key.
The Create API key window appears.
Go to the API dashboard
  1. Enter an API key name.
  2. Optional: Set credit usage limit.
    a. Click Add credit usage limit.
    b. Enter the maximum number of credits that can be used with this API key.
  3. Click Create.
The Save your API key window appears.
Create an API key and set the credit usage limit
  1. Click Copy.
    The API key is now copied to your clipboard and can be used for API calls. Save the API key in a secure location, as it is required for all API requests.
  2. Click Done.
Copy the API key to your clipboard

​
Using an API key

Your API requests must include the API key in the authorization header. Below is an example of a cURL call to CreatorDB’s API:

​
Managing an API key

You can manage your API keys anytime through the CreatorDB API dashboard. You can set a credit usage limit, change an API key’s status, or delete an API key. An API key has one of the following statuses:
  • Active: The API key is enabled and can be used for API requests. A new API key is Active by default.
  • Inactive: The API key is disabled. Deactivation takes effect immediately, and any request that uses the API key fails with a 401 error until you reactivate it.
  • Limit reached: The API key has reached its credit usage limit. Any request that uses the API key fails with a 402 error until you reset the usage limit or remove it.
Reactivating a key that has reached the credit usage limit will return the status Limit reached and not Active.
To open the options for an API key, follow these steps:
  1. Log in to CreatorDB.
  2. Click API.
  3. Go to the API key and click the ⋮ (more options) icon on the right side of the API key.
    A drop-down menu appears with the options Add usage limit, Deactivate key, and Delete key.
Opening the more options menu for an API key on the API dashboard
API key options: Add usage limit, Deactivate key, and Delete key

​
Setting a credit usage limit

A credit usage limit is the maximum number of credits that can be used with an API key. The limit is the lifetime total for that API key.
A credit usage limit caps how much one API key can spend. It doesn’t set credits aside for that key: every API key draws from the same account balance. For example, if your account has 5,000 credits and you set a limit of 1,000 credits on one API key, that key can use up to 1,000 credits, and your other API keys can still use the full account balance.
To set a credit usage limit, follow these steps:
  1. In the API key’s options, click Add usage limit.
  2. Click Credit usage limit.
    A drop-down menu appears.
Selecting credit usage limit
  1. Select or enter the maximum number of credits that can be used with this API key.
Setting a credit usage limit
  1. Click Add.
    The credit usage limit is now set for the API key.
Confirming and adding the credit usage limit to the API key
Once a limit is set, the option changes to Reset usage limit. Use it to clear the accumulated credit usage and set a new limit, or select Remove usage limit to remove the limit.

​
Deactivating or reactivating an API key

To deactivate an API key, follow these steps:
  1. In the API key’s options, click Deactivate key. This option only appears when the API key is Active.
    A confirmation message appears.
Deactivate API key confirmation window
  1. Click Deactivate.
    The API key status changes to Inactive.
To reactivate an API key, in the API key’s options, click Reactivate. This option only appears when the API key is Inactive. The API key is reactivated immediately.
You cannot reactivate API keys if your account has reached the maximum number of active keys. Check your account’s active API key limit and delete any unused keys if necessary.

​
Deleting an API key

Deleting an API key permanently removes it from your account. This action can’t be undone.
Deleting a key does not affect your account’s credit balance.
To delete an API key, follow these steps:
  1. In the API key’s options, click Delete key.
    A confirmation message appears.
Delete API key confirmation window
  1. Click Delete.

​
Securing an API key

Exposing your API key to the public can result in unauthorized usage and potential charges to your account. To prevent unauthorized access, keep your API key private and secure.
For optimal security, follow these guidelines when managing API keys:
  • Restrict access to your API key. Applying restrictions helps limit unauthorized access and reduces the risk of misuse if the API keys are compromised.
  • Regularly review and remove unused API keys to limit potential exposure.
  • Rotate API keys periodically, remove outdated ones, and ensure all applications use the updated keys.
Last modified on November 3, 2026