Error Codes

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 CODE	ERROR `TYPE`	DESCRIPTION
403	`Forbidden`	This 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_CODE`	Description
NotFound	No results found.
CategoryNotFound	Requested category was not found.
TopicNotFound	Requested topic was not found.
NicheNotFound	Requested niche was not found.
ValueEmpty	Requested value is invalid or cannot be found.
CreateFailed	Failed to create a task.
UpdateFailed	Failed to update data.
RemoveFailed	Failed to remove data.
AlreadyDone	Requested task already exists.
UserNotFound	Requested creator account was not found.
UserExpired	Requested creator account does not exist.
UserHasNoEmail	Requested creator account email cannot be found.
UserNotAdmin	The creator is not an admin.
QuotaNotPaid	Requested CreatorDB account is on the free plan. Only paid subscribers can access the CreatorDB API.
QuotaValue	Entered quota value is invalid, please purchase more API credits.
QuotaKey	Your API key is invalid.
QuotaNotEnough	You have insufficient API credits to make this API call. Please purchase more API credits.
NoEmail	Requested YouTube channel does not have a contact email.
ChannelNotFound	Requested YouTube channel cannot be found.
ChannelVideoNotFound	Requested video cannot be found on this YouTube channel.
TopicReportNotFound	Requested topic report cannot be found.
CustomerIdNotFound	Requested Stripe customerID cannot be found.
PlanCanNotChange	Failed to change your CreatorDB subscription plan. Please check if you are already subscribed to this plan tier.
AuthFailed	Failed to authenticate the API call.
APIKeyNotMatch	Requested API key is invalid. Check your API credentials.
APIKeyOnlyForTesting	Requested API key is only used for testing and has access to limited features.
SearchFilterKeyNotMatch	Requested search filter key is invalid. Please check the search filter details are correct.
ParamsNotCorrect	Requested API parameters are invalid. Please check your configured parameters.
AdvancedSearchSortByNotExistOrInvalid	Requested advanced search filter does not exist or is invalid.
TopicTableUnknownError	An unknown error occurred when calling the topic table.
HashtagEmpty	Requested Instagram hashtag does not exist.
IGIdNotFound	Requested Instagram ID cannot be found.
IGPostNotFound	Requested Instagram post cannot be found.
TikTokIdNotFound	Requested TikTok ID cannot be found.
TikTokVideoNotFound	Requested TikTok video cannot be found.
FBIdNotFound	Requested Facebook ID cannot be found.
ThreadsIdNotFound	Requested Threads ID cannot be found.

The provided information should be sufficient to identify and troubleshoot errors. However, if the issue you encounter persists, contact our team at product@creatordb.app.

Getting Started

User Guides

API Endpoints

Filter Value References

Troubleshooting and FAQs

Error types and HTTP status codes

List of error codes

​Error types and HTTP status codes

​List of error codes

Error types and HTTP status codes

List of error codes