{"id":1574,"date":"2019-11-28T11:12:17","date_gmt":"2019-11-28T11:12:17","guid":{"rendered":"https:\/\/docs_v3.dataforseo.com\/v3\/?page_id=1574"},"modified":"2026-08-13T14:23:58","modified_gmt":"2026-08-13T14:23:58","slug":"appendix-errors","status":"publish","type":"page","link":"https:\/\/docs.dataforseo.com\/v3\/appendix-errors\/","title":{"rendered":"appendix\/errors"},"content":{"rendered":"

[vc_row][vc_column][vc_column_text]<\/p>\n

Errors<\/h2>\n

[\/vc_column_text][vc_column_text]<\/p>\n

This endpoint returns a list of possible DataForSEO API errors and general status codes. Below you will find a list of HTTP response codes and internal messages. We recommend storing the data connected to error codes in your application log and designing a necessary system for handling related exceptional or error conditions.<\/p>\n

Note:<\/strong> DataForSEO API servers always return the 200<\/code> HTTP response code, except for the following cases.<\/p>\n

HTTP response codes:<\/strong><\/p>\n\n\n\n\n\n\n\n\n
Code<\/th>\nMessage<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
401<\/code><\/td>\nUnauthorized<\/td>\nYou are not authorized to access this resource. See your login details here: https:\/\/app.dataforseo.com\/api-access<\/em><\/td>\n<\/tr>\n
402<\/code><\/td>\nPayment Required<\/td>\nWe had a problem billing your account. Please, check your account’s balance.<\/em><\/td>\n<\/tr>\n
404<\/code><\/td>\nNot Found<\/td>\nRequested endpoint not found<\/i><\/td>\n<\/tr>\n
500<\/code><\/td>\nInternal Server Error<\/td>\nSorry, we could not process your request due to the internal server error. Please, try again later.<\/i><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

 <\/p>\n

Alongside the 200<\/code> HTTP code, our system also generates internal status codes which you may find in status_code<\/code> and status_message<\/code> fields of the API response.<\/p>\n

Note:<\/strong> status messages can be expanded in the API response and may vary depending on the event that triggered them.<\/p>\n

Internal status codes and messages: <\/strong>
\n

Field name<\/th>Type<\/th>Description<\/th><\/tr><\/thead>
20000<\/code><\/td>ok.<\/td>

the request has been successfully completed<\/p><\/td><\/tr>

20100<\/code><\/td>task created.<\/td>

as a result of the successful request, the task has been created<\/p><\/td><\/tr>

40000<\/code><\/td>you can set only one task at a time.<\/td>

you cannot specify more than one task in the POST array<\/p><\/td><\/tr>

40001<\/code><\/td>this id is used by another client, check the id.<\/td>

the task identifier id<\/code> is unique to the client used to send the request<\/p><\/td><\/tr>

40002<\/code><\/td>this id is used by another search engine, check the path.<\/td>

the task identifier id<\/code> is unique to the search engine used in the URL path of the request<\/p><\/td><\/tr>

40003<\/code><\/td>this id is used by another search type, check the path.<\/td>

the task identifier id<\/code> is unique to the search type used in the URL path of the request<\/p><\/td><\/tr>

40004<\/code><\/td>this id is used by another function, check the id.<\/td>

the task identifier id<\/code> is unique to the function used in the URL path of the request<\/p><\/td><\/tr>

40006<\/code><\/td>you can set no more than 100 tasks at a time.<\/td>

each POST request can contain up to 100 tasks<\/p><\/td><\/tr>

40100<\/code><\/td>you are not authorized to access this resource. see your login details here: https:\/\/app.dataforseo.com\/api-dashboard .<\/td>

check if the specified credentials match those in your account dashboard<\/a><\/p><\/td><\/tr>

40101<\/code><\/td>internal se server error.<\/td>

the requested search engine was unable to process your request and responded with an error;
learn more on our help center<\/a><\/p><\/td><\/tr>

40102<\/code><\/td>no search results.<\/td>

no results matching the details of your request have been found;
learn more on our help center<\/a><\/p><\/td><\/tr>

40103<\/code><\/td>task execution failed, please try to resubmit the task.<\/td>

the task could not be executed, try posting another task with similar parameters<\/p><\/td><\/tr>

40104<\/code><\/td>please verify your account before using the api. you can complete the verification in the user panel: https:\/\/app.dataforseo.com\/ .<\/td>

email and\/or phone verification is required for new users; to use DataForSEO APIs, you have to complete the account verification process in the User Panel<\/a><\/p><\/td><\/tr>

40200<\/code><\/td>payment required.<\/td>

the request cannot be completed until the balance is recharged;
check your balance in the account dashboard<\/a><\/p><\/td><\/tr>

40201<\/code><\/td>we noticed some unusual activity in your dataforseo account, so we\u2019ve temporarily paused access as a precaution. please, reach out to our support team at support@dataforseo.com for more details, and we\u2019ll work with you to resolve this quickly.<\/td>

unusual activity detected in your account may result from the creation of several trial<\/strong> accounts or violation of the DataForSEO Terms of Service in some other way;
therefore, your account access and DataForSEO API access have been temporarily paused;
contact our support team to resolve the issue<\/p><\/td><\/tr>

40202<\/code><\/td>the rate-limit per minute has been exceeded.<\/td>

you can make up to 2000 requests per minute;
contact our support team if you need to increase the limit<\/p><\/td><\/tr>

40203<\/code><\/td>the cost limit has been exceeded. you can modify your cost limit in the user panel https:\/\/app.dataforseo.com\/api-settings.<\/td>

you can modify daily cost limits for APIs and endpoints in your account dashboard<\/p><\/td><\/tr>

40204<\/code><\/td>access denied. visit plans and subscriptions to activate your subscription and get access to this api: https:\/\/app.dataforseo.com\/users\/getrows .<\/td>

the access to Backlinks API is limited by a minimal commitment. Learn more.<\/a><\/p><\/td><\/tr>

40205<\/code><\/td>the duplicate task limit per hour has been exceeded. you can modify your limits in the user panel https:\/\/app.dataforseo.com\/api-settings.<\/td>

you can modify the duplicate task limit in your account dashboard. Learn more.<\/a><\/p><\/td><\/tr>

40206<\/code><\/td>the duplicate task limit per day has been exceeded. you can modify your limits in the user panel https:\/\/app.dataforseo.com\/api-settings .<\/td>

you can modify the duplicate task limit in your account dashboard. Learn more.<\/a><\/p><\/td><\/tr>

40207<\/code><\/td>access denied. your ip is not whitelisted. you can modify your ip whitelist in the user panel https:\/\/app.dataforseo.com\/api-access .<\/td>

you can whitelist all the necessary IPs in the account dashboard. Learn more.<\/a><\/p><\/td><\/tr>

40209<\/code><\/td>too many simultaneous queries.<\/td>

the limit for simultaneous requests made by a single user is 30<\/p><\/td><\/tr>

40210<\/code><\/td>insufficient funds. your account's balance is too low to complete this request.<\/td>

visit your account dashboard<\/a> to add funds; learn more about making payments<\/a><\/p><\/td><\/tr>

40400<\/code><\/td>not found.<\/td>

the requested resource doesn\u2019t exist;
check the URL of the request<\/p><\/td><\/tr>

40401<\/code><\/td>task not found.<\/td>

the requested task does not exist<\/p><\/td><\/tr>

40402<\/code><\/td>invalid path.<\/td>

the URL path of your request is invalid<\/p><\/td><\/tr>

40403<\/code><\/td>results expired.<\/td>

it\u2019s not possible to retrieve the results of a task that was created more than a month ago<\/p><\/td><\/tr>

40404<\/code><\/td>no prepared data found.please contact our support team.<\/td>

the Sandbox does not contain prepared data for the task you set<\/p><\/td><\/tr>

40405<\/code><\/td>textual content on the target page is insufficient.<\/td>

target page does not have enough textual data, please try specifying a different page<\/p><\/td><\/tr>

40406<\/code><\/td>requested page was not submitted for crawling.<\/td>

the page was not submitted for crawling in Task POST<\/p><\/td><\/tr>

40407<\/code><\/td>duplicate host.<\/td>

duplicate hosts detected in request<\/p><\/td><\/tr>

40408<\/code><\/td>target url is invalid.<\/td>

website resource at the target URL returned a 404 status code or is invalid<\/p><\/td><\/tr>

40501<\/code><\/td>invalid field.<\/td>

one of the fields in the POST request is invalid<\/p><\/td><\/tr>

40502<\/code><\/td>post data is empty.<\/td>

the body of your POST request is empty, please check the body structure and validity<\/p><\/td><\/tr>

40503<\/code><\/td>post data is invalid.<\/td>

the structure of the POST request is invalid<\/p><\/td><\/tr>

40504<\/code><\/td>the number of intersecting keywords for the specified domains exceeds 10 million. try specifying different domains.<\/td>

there are too many intersecting keywords for the specified domains, please try again with different domain names<\/p><\/td><\/tr>

40505<\/code><\/td>you are using old data.<\/td>

location parameters you are using are outdated, please check our documentation or call the relevant locations endpoint for up-tp-date parameters<\/p><\/td><\/tr>

40506<\/code><\/td>unknown fields in post data.<\/td>

the body of your POST request contains unknown fields, please consult the documentation of the requested endpoint and use available fields<\/p><\/td><\/tr>

40601<\/code><\/td>task handed.<\/td>

the task has been received but has not yet been enqueued for processing<\/p><\/td><\/tr>

40602<\/code><\/td>task in queue.<\/td>

the task has been enqueued for processing<\/p><\/td><\/tr>

50000<\/code><\/td>internal error.<\/td>

our system encountered an unexpected condition;
please contact our support team<\/p><\/td><\/tr>

50001<\/code><\/td>error while checking the balance.<\/td>

our system failed to check your account balance;
please contact our support team<\/p><\/td><\/tr>

50100<\/code><\/td>not implemented.<\/td>

you specified a non-existing task or parameter, please check the body of your POST request<\/p><\/td><\/tr>

50301<\/code><\/td>3rd party api service unavailable.<\/td>

one of our external data sources is currently unavailable or responded with an error;
the error can be triggered by Google Ads API or other third-party services used by DataForSEO API;
message of the error may vary depending on the third-party service status;
corresponding message examples:
Too many requests<\/code>
Could not connect to host<\/code>
3rd Party API Service Unavailable<\/code><\/p><\/td><\/tr>

50303<\/code><\/td>update is in progress. please try after a few minutes<\/td>

the API you\u2019re requesting is being updated;
this can take a few minutes<\/p><\/td><\/tr>

50304<\/code><\/td>this function is temporarily unavailable. please contact support for more information.<\/td>

the function you\u2019re requesting failed to respond;
please contact our support team for more information<\/p><\/td><\/tr>

50401<\/code><\/td>internal error - timeout.<\/td>

our system failed to process a live-mode task in 120 seconds;
please try setting a task one more time<\/p><\/td><\/tr>

50402<\/code><\/td>target page took too long to respond.<\/td>

target page took longer than 50 seconds to respond, please try again later or specify a different page<\/p><\/td><\/tr><\/tbody><\/table><\/div>
\nYou can also get the list of internal error codes by calling the ‘Errors’ endpoint:<\/strong>
\n\t

\n\t\t
\n\t\t\t
\n\t\t\t\t\n\t\t\t\t\t<\/use>\n\t\t\t\t<\/svg>\n\t\t\t<\/div>\n\t\t\t
Pricing<\/div>\n\t\t<\/header>\n\t\t
\n\t\t\t

Your account will not be charged for using this API<\/p>\n\t\t<\/div>\n\t<\/article>\n\t

\n \"checked\"\n\n GET