Skip to main content
CreatorDB communicates request status through HTTP response codes. A response in the 2xx range means the request was successful, while a 4xx response suggests an error caused by invalid credentials, insufficient API credits, or missing parameters.

Error types and HTTP status codes

The following table shows the different error types based on the status code of the HTTP response:
HTTP STATUS CODEERROR TYPEDESCRIPTION
403ForbiddenThis request is prohibited because it is not supported. For example, the feature may only be available for selected social media platforms, like YouTube, Instagram, and TikTok.

List of error codes

The following table shows the different error_codes for errors of specific API requests:
ERROR_CODEDescription
NotFoundNo results found.
CategoryNotFoundRequested category was not found.
TopicNotFoundRequested topic was not found.
NicheNotFoundRequested niche was not found.
ValueEmptyRequested value is invalid or cannot be found.
CreateFailedFailed to create a task.
UpdateFailedFailed to update data.
RemoveFailedFailed to remove data.
AlreadyDoneRequested task already exists.
UserNotFoundRequested creator account was not found.
UserExpiredRequested creator account does not exist.
UserHasNoEmailRequested creator account email cannot be found.
UserNotAdminThe creator is not an admin.
QuotaNotPaidRequested CreatorDB account is on the free plan. Only paid subscribers can access the CreatorDB API.
QuotaValueEntered quota value is invalid, please purchase more API credits.
QuotaKeyYour API key is invalid.
QuotaNotEnoughYou have insufficient API credits to make this API call. Please purchase more API credits.
NoEmailRequested YouTube channel does not have a contact email.
ChannelNotFoundRequested YouTube channel cannot be found.
ChannelVideoNotFoundRequested video cannot be found on this YouTube channel.
TopicReportNotFoundRequested topic report cannot be found.
CustomerIdNotFoundRequested Stripe customerID cannot be found.
PlanCanNotChangeFailed to change your CreatorDB subscription plan. Please check if you are already subscribed to this plan tier.
AuthFailedFailed to authenticate the API call.
APIKeyNotMatchRequested API key is invalid. Check your API credentials.
APIKeyOnlyForTestingRequested API key is only used for testing and has access to limited features.
SearchFilterKeyNotMatchRequested search filter key is invalid. Please check the search filter details are correct.
ParamsNotCorrectRequested API parameters are invalid. Please check your configured parameters.
AdvancedSearchSortByNotExistOrInvalidRequested advanced search filter does not exist or is invalid.
TopicTableUnknownErrorAn unknown error occurred when calling the topic table.
HashtagEmptyRequested Instagram hashtag does not exist.
IGIdNotFoundRequested Instagram ID cannot be found.
IGPostNotFoundRequested Instagram post cannot be found.
TikTokIdNotFoundRequested TikTok ID cannot be found.
TikTokVideoNotFoundRequested TikTok video cannot be found.
FBIdNotFoundRequested Facebook ID cannot be found.
ThreadsIdNotFoundRequested Threads ID cannot be found.
The provided information should be sufficient to identify and troubleshoot errors. However, if the issue you encounter persists, please get in touch with our sales team or write to us at support@creatordb.app.
Last modified on February 9, 2026