\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\tPricing<\/div>\n\t\t<\/header>\n\t\t\n\t\t\t Your account will be charged for each request.\nThe cost can be calculated on the Pricing<\/a> page.<\/p>\n\t\t<\/div>\n\t<\/article>\n\t[vc_column_text]All POST data should be sent in the JSON<\/a> format (UTF-8 encoding). The task setting is done using the POST method. When setting a task, you should send all task parameters in the task array of the generic POST array. You can send up to 2000 API calls per minute. The maximum number of requests that can be sent simultaneously is limited to 30.<\/p>\nYou can specify the number of results you want to retrieve, filter and sort them.<\/p>\nBelow you will find a detailed description of the fields you can use for setting a task.<\/p>\nDescription of the fields for setting a task:<\/strong><\/p>\n\n\n\nField name<\/th>\nType<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n\n\nkeyword<\/code><\/td>\nstring<\/td>\nkeyword<\/em>\nrequired field<\/strong>\nUTF-8 encoding\nthe keywords should be specified in the lowercase format<\/p>\nlearn more about rules and limitations of keyword<\/code> and keywords<\/code> fields in DataForSEO APIs in this Help Center article<\/a><\/td>\n<\/tr>\n\nlocation_name<\/code><\/td>\nstring<\/td>\nfull name of the location<\/em>\nrequired field if you don’t specify<\/strong> location_code<\/code>\nNote:<\/strong> it is required to specify either location_name<\/code> or location_code<\/code>\nyou can receive the list of available locations with their location_name<\/code> by making a separate request to\nhttps:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/code>;\nNote:<\/strong> this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;\nexample:\nUnited States<\/code><\/td>\n<\/tr>\n\nlocation_code<\/code><\/td>\ninteger<\/td>\nlocation code<\/em>\nrequired field if you don’t specify<\/strong> location_name<\/code>\nNote:<\/strong> it is required to specify either location_name<\/code> or location_code<\/code>\nyou can receive the list of available locations with their location_code<\/code> by making a separate request to\nhttps:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/code>;\nNote:<\/strong> this endpoint currently supports the US, Egypt, Saudi Arabia, and the United Arab Emirates locations only;\nexample:\n2840<\/code><\/td>\n<\/tr>\n\nlanguage_name<\/code><\/td>\nstring<\/td>\nfull name of the language<\/em>\nrequired field if you don’t specify<\/strong> language_code<\/code>\nNote:<\/strong> it is required to specify either language_name<\/code> or language_code<\/code>\nyou can receive the list of available locations with their language_name<\/code> by making a separate request to https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/code>\nexample:\nEnglish<\/code><\/td>\n<\/tr>\n\nlanguage_code<\/code><\/td>\nstring<\/td>\nlanguage code<\/em>\nrequired field if you don’t specify<\/strong> language_name<\/code>\nNote:<\/strong> it is required to specify either language_name<\/code> or language_code<\/code>\nyou can receive the list of available locations with their language_code<\/code> by making a separate request to https:\/\/api.dataforseo.com\/v3\/dataforseo_labs\/locations_and_languages<\/code>\nexample:\nen<\/code><\/td>\n<\/tr>\n\ndepth<\/code><\/td>\ninteger<\/td>\nkeyword search depth<\/em>\noptional field\ndefault value: 1<\/code>;\nnumber of the returned results depends on the value you set in this field;\nyou can specify a level from 0 to 4;\nestimated number of keywords for each level (maximum):\n0 – the keyword set in the keyword<\/code> field\n1 \u2013 6 keywords\n2 \u2013 42 keywords\n3 \u2013 258 keywords\n4 \u2013 1554 keywords\n<\/td>\n<\/tr>\n\ninclude_seed_keyword<\/code><\/td>\nboolean<\/td>\ninclude data for the seed keyword<\/em>\noptional field\nif set to true<\/code>, data for the seed keyword specified in the keyword<\/code> field will be provided in the seed_keyword_data<\/code> array of the response\ndefault value: false<\/code><\/td>\n<\/tr>\n\nignore_synonyms<\/code><\/td>\nboolean<\/td>\nignore highly similar keywords<\/em>\noptional field\nif set to\u00a0true<\/code> only core keywords will be returned, all highly similar keywords will be excluded;\ndefault value: false<\/code><\/td>\n<\/tr>\n\nlimit<\/code><\/td>\ninteger<\/td>\nthe maximum number of returned keywords<\/em>\noptional field\ndefault value: 100<\/code>\nmaximum value: 1000<\/code><\/td>\n<\/tr>\n\noffset<\/code><\/td>\ninteger<\/td>\noffset in the results array of returned keywords<\/em>\noptional field\ndefault value: 0<\/code>\nif you specify the 10<\/code> value, the first ten keywords in the results array will be omitted and the data will be provided for the successive keywords<\/td>\n<\/tr>\n\ntag<\/code><\/td>\nstring<\/td>\nuser-defined task identifier<\/em>\noptional field\nthe character limit is 255<\/em>\nyou can use this parameter to identify the task and match it with the result\nyou will find the specified tag<\/code> value in the data<\/code> object of the response<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n\u200c<\/p>\nAs a response of the API server, you will receive JSON<\/a>-encoded data containing a tasks<\/code> array with the information specific to the set tasks.<\/p>\nDescription of the fields in the results array:<\/strong><\/p>\n\n\n\nField name<\/th>\nType<\/th>\nDescription<\/th>\n<\/tr>\n<\/thead>\n\n\nversion<\/code><\/td>\nstring<\/td>\nthe current version of the API<\/em><\/td>\n<\/tr>\n\nstatus_code<\/code><\/td>\ninteger<\/td>\ngeneral status code<\/i>\nyou can find the full list of the response codes here<\/a>\nNote:<\/strong> we strongly recommend designing a necessary system for handling related exceptional or error conditions<\/td>\n<\/tr>\n\nstatus_message<\/code><\/td>\nstring<\/td>\ngeneral informational message<\/em>\nyou can find the full list of general informational messages here<\/a><\/td>\n<\/tr>\n\ntime<\/code><\/td>\nstring<\/td>\nexecution time, seconds<\/em><\/td>\n<\/tr>\n\ncost<\/code><\/td>\nfloat<\/td>\ntotal tasks<\/i> cost, USD<\/em><\/td>\n<\/tr>\n\ntasks_count<\/code><\/td>\ninteger<\/td>\nthe number of tasks in the tasks<\/code><\/strong> array<\/em><\/td>\n<\/tr>\n\ntasks_error<\/code><\/td>\ninteger<\/td>\nthe number of tasks in the tasks<\/code><\/strong> array returned with an error<\/em><\/td>\n<\/tr>\n\ntasks<\/code><\/strong><\/td>\narray<\/td>\narray of tasks<\/em><\/td>\n<\/tr>\n\n\u00a0 \u00a0 \u00a0 \u00a0 id<\/code><\/td>\nstring<\/td>\ntask identifier<\/em>\nunique task identifier in our system in the UUID<\/a> format<\/strong><\/td>\n<\/tr>\n\n\u00a0 \u00a0 \u00a0 \u00a0 status_code<\/code><\/td>\ninteger<\/td>\nstatus code of the task <\/em>\ngenerated by DataForSEO; can be within the following range: 10000-60000\nyou can find the full list of the response codes here<\/a><\/td>\n<\/tr>\n\n\u00a0 \u00a0 \u00a0 \u00a0 status_message<\/code><\/td>\nstring<\/td>\ninformational message of the task<\/em>\nyou can find the full list of general informational messages here<\/a><\/td>\n<\/tr>\n\n\u00a0 \u00a0 \u00a0 \u00a0 time<\/code><\/td>\nstring<\/td>\nexecution time, seconds<\/em><\/td>\n<\/tr>\n\n\u00a0 \u00a0 \u00a0 \u00a0 cost<\/code><\/td>\nfloat<\/td>\ncost of the task, USD<\/em><\/td>\n<\/tr>\n\n\u00a0 \u00a0 \u00a0 \u00a0 result_count<\/code><\/td>\ninteger<\/td>\nnumber of elements in the result<\/code> array<\/em><\/td>\n<\/tr>\n\n\u00a0 \u00a0 \u00a0 \u00a0 path<\/code><\/td>\narray<\/td>\nURL path<\/em><\/td>\n<\/tr>\n\n\u00a0 \u00a0 \u00a0 \u00a0 data<\/code><\/td>\nobject<\/td>\ncontains the same parameters that you specified in the POST request<\/em><\/td>\n<\/tr>\n\n\u00a0 \u00a0 \u00a0 \u00a0 result<\/code><\/strong><\/td>\narray<\/td>\narray of results<\/em><\/td>\n<\/tr>\n\n\u00a0 \u00a0 \u00a0 \u00a0 \u00a0 \u00a0 se_type<\/code><\/td>\nstring<\/td>\n
![](\"https:\/\/dataforseo.com\/wp-content\/uploads\/2022\/02\/Screenshot_10.jpg\")
<\/span><\/a><\/p>\n![\"checked\"](\"https:\/\/docs.dataforseo.com\/v3\/wp-content\/themes\/dataforseo\/assets\/img\/icons\/checked-circle.svg\")
\n\n POST