{"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-03-24T16:04:16","modified_gmt":"2026-03-24T16:04:16","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><\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Code<\/th>\nMessage<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n
20000<\/code><\/td>\nOk.<\/td>\nthe request has been successfully completed<\/td>\n<\/tr>\n
20100<\/code><\/td>\nTask Created.<\/td>\nas a result of the successful request, the task has been created<\/td>\n<\/tr>\n
40000<\/code><\/td>\nYou can set only one task at a time.<\/td>\nyou cannot specify more than one task in the POST array<\/td>\n<\/tr>\n
40001<\/code><\/td>\nThis id is used by another client, check the id.<\/td>\nthe task identifier id<\/code> is unique to the client used to send the request<\/td>\n<\/tr>\n
40002<\/code><\/td>\nThis id is used by another search engine, check the Path.<\/td>\nthe task identifier id<\/code> is unique to the search engine used in the URL path of the request<\/td>\n<\/tr>\n
40003<\/code><\/td>\nThis id is used by another search type, check the Path.<\/td>\nthe task identifier id<\/code> is unique to the search type used in the URL path of the request<\/td>\n<\/tr>\n
40004<\/code><\/td>\nThis id is used by another function, check the id.<\/td>\nthe task identifier id<\/code> is unique to the function used in the URL path of the request<\/td>\n<\/tr>\n
40006<\/code><\/td>\nYou can set no more than 100 tasks at a time.<\/td>\neach POST request can contain up to 100 tasks<\/td>\n<\/tr>\n
40100<\/code><\/td>\nYou are not authorized to access this resource. See your login details here: https:\/\/app.dataforseo.com\/api-access .<\/td>\ncheck if the specified credentials match those in your account dashboard <\/a><\/td>\n<\/tr>\n
40101<\/code><\/td>\nInternal SE server error.<\/td>\nthe requested search engine was unable to process your request and responded with an error<\/td>\n<\/tr>\n
40102<\/code><\/td>\nNo Search Results.<\/td>\nno results matching the details of your request have been found<\/td>\n<\/tr>\n
40103<\/code><\/td>\nTask execution failed, please try to resubmit the task.<\/td>\nthe task could not be executed, try posting another task with similar parameters<\/td>\n<\/tr>\n
40104<\/code><\/td>\nPlease verify your account before using the API. You can complete the verification in the user panel: https:\/\/app.dataforseo.com\/ .<\/td>\nemail 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><\/td>\n<\/tr>\n
40200<\/code><\/td>\nPayment Required.<\/td>\nthe request cannot be completed until the balance is recharged;
\ncheck your balance in the account dashboard<\/a><\/td>\n<\/tr>\n
40201<\/code><\/td>\nWe 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>\nunusual 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;
\ntherefore, your account access and DataForSEO API access have been temporarily paused;
\ncontact our support team to resolve the issue<\/td>\n<\/tr>\n
40202<\/code><\/td>\nThe rate-limit per minute has been exceeded.<\/td>\nyou can make up to 2000 requests per minute;
\ncontact our support team if you need to increase the limit<\/td>\n<\/tr>\n
40203<\/code><\/td>\nThe cost limit has been exceeded. You can modify your cost limit in the user panel https:\/\/app.dataforseo.com\/api-settings.<\/td>\nyou can modify daily cost limits for APIs and endpoints in your account dashboard<\/td>\n<\/tr>\n
40204<\/code><\/td>\nAccess denied. Visit Plans and Subscriptions to activate your subscription and get access to this API: https:\/\/app.dataforseo.com\/users\/getrows .<\/td>\nthe access to Backlinks API is limited by a minimal commitment. Learn more.<\/a><\/td>\n<\/tr>\n
40205<\/code><\/td>\nThe duplicate task limit per hour has been exceeded. You can modify your limits in the user panel https:\/\/app.dataforseo.com\/api-settings.<\/td>\nyou can modify the duplicate task limit in your account dashboard. Learn more.<\/a><\/td>\n<\/tr>\n
40206<\/code><\/td>\nThe duplicate task limit per day has been exceeded. You can modify your limits in the user panel https:\/\/app.dataforseo.com\/api-settings .<\/td>\nyou can modify the duplicate task limit in your account dashboard. Learn more.<\/a><\/td>\n<\/tr>\n
40207<\/code><\/td>\nAccess denied. Your IP is not whitelisted. You can modify your IP whitelist in the user panel https:\/\/app.dataforseo.com\/api-access .<\/td>\nyou can whitelist all the necessary IPs in the account dashboard. Learn more.<\/a><\/td>\n<\/tr>\n
40209<\/code><\/td>\nToo many simultaneous queries.<\/td>\nthe limit for simultaneous requests made by a single user is 30<\/td>\n<\/tr>\n
40210<\/code><\/td>\nInsufficient Funds. Your account’s balance is too low to complete this request.<\/td>\nvisit your account dashboard<\/a> to add funds; learn more about making payments<\/a><\/td>\n<\/tr>\n
40400<\/code><\/td>\nNot found.<\/td>\nthe requested resource doesn\u2019t exist;
\ncheck the URL of the request<\/td>\n<\/tr>\n
40401<\/code><\/td>\nTask Not Found.<\/td>\nthe requested task does not exist<\/td>\n<\/tr>\n
40402<\/code><\/td>\nInvalid Path.<\/td>\nthe URL path of your request is invalid<\/td>\n<\/tr>\n
40403<\/code><\/td>\nResults Expired.<\/td>\nit\u2019s not possible to retrieve the results of a task that was created more than a month ago<\/td>\n<\/tr>\n
40404<\/code><\/td>\nNo Prepared Data Found.Please Contact Our Support Team.<\/td>\nthe Sandbox does not contain prepared data for the task you set<\/td>\n<\/tr>\n
40405<\/code><\/td>\nTextual content on the target page is insufficient.<\/td>\ntarget page does not have enough textual data, please try specifying a different page<\/td>\n<\/tr>\n
40406<\/code><\/td>\nRequested page was not submitted for crawling.<\/td>\nthe page was not submitted for crawling in Task POST<\/td>\n<\/tr>\n
40501<\/code><\/td>\nInvalid Field.<\/td>\none of the fields in the POST request is invalid<\/td>\n<\/tr>\n
40502<\/code><\/td>\nPOST Data Is Empty.<\/td>\nthe body of your POST request is empty, please check the body structure and validity<\/td>\n<\/tr>\n
40503<\/code><\/td>\nPOST Data is Invalid.<\/td>\nthe structure of the POST request is invalid<\/td>\n<\/tr>\n
40504<\/code><\/td>\nThe number of intersecting keywords for the specified domains exceeds 10 million. Try specifying different domains.<\/td>\nthere are too many intersecting keywords for the specified domains, please try again with different domain names<\/td>\n<\/tr>\n
40505<\/code><\/td>\nYou are using old data.<\/td>\nlocation parameters you are using are outdated, please check our documentation or call the relevant locations endpoint for up-tp-date parameters<\/td>\n<\/tr>\n
40506<\/code><\/td>\nUnknown Fields in POST Data.<\/td>\nthe body of your POST request contains unknown fields, please consult the documentation of the requested endpoint and use available fields<\/td>\n<\/tr>\n
40601<\/code><\/td>\nTask Handed.<\/td>\nthe task has been received but has not yet been enqueued for processing<\/td>\n<\/tr>\n
40602<\/code><\/td>\nTask in Queue.<\/td>\nthe task has been enqueued for processing<\/td>\n<\/tr>\n
50000<\/code><\/td>\nInternal Error.<\/td>\nour system encountered an unexpected condition;
\nplease contact our support team<\/td>\n<\/tr>\n
50001<\/code><\/td>\nError While Checking the Balance.<\/td>\nour system failed to check your account balance;
\nplease contact our support team<\/td>\n<\/tr>\n
50100<\/code><\/td>\nNot Implemented.<\/td>\nyou specified a non-existing task or parameter, please check the body of your POST request<\/td>\n<\/tr>\n
50301<\/code><\/td>\n3rd Party API Service Unavailable.<\/td>\none of our external data sources is currently unavailable or responded with an error;
\nthe error can be triggered by Google Ads API or other third-party services used by DataForSEO API;
\nmessage of the error may vary depending on the third-party service status;
\ncorresponding message examples:
\nToo many requests<\/code>
\nCould not connect to host<\/code>
\n3rd Party API Service Unavailable<\/code>\n<\/td>\n<\/tr>\n
50303<\/code><\/td>\nUpdate is in progress. Please try after a few minutes<\/td>\nthe API you\u2019re requesting is being updated;
\nthis can take a few minutes<\/td>\n<\/tr>\n
50304<\/code><\/td>\nThis function is temporarily unavailable. Please contact support for more information.<\/td>\nthe function you\u2019re requesting failed to respond;
\nplease contact our support team for more information<\/td>\n<\/tr>\n
50401<\/code><\/td>\nInternal Error – Timeout.<\/td>\nour system failed to process a live-mode task in 120 seconds;
\nplease try setting a task one more time<\/td>\n<\/tr>\n
50402<\/code><\/td>\nTarget page took too long to respond.<\/td>\ntarget page took longer than 50 seconds to respond, please try again later or specify a different page<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

You 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