| target | string | domain or URL required field
 the URL of the webpage or the domain to scan for possible keywords
 | 
| location_name | string | full name of search engine location required field if you don’t specify
 location_codeorlocation_coordinateif you use this field, you don’t need to specify
 location_codeorlocation_coordinateyou can receive the list of available locations of the search engine with their
 location_nameby making a separate request tohttps://api.dataforseo.com/v3/keywords_data/bing/locationsexample:
 
 London,England,United Kingdom | 
| location_code | integer | search engine location code required field if you don’t specify
 location_nameorlocation_coordinateif you use this field, you don’t need to specify
 location_nameorlocation_coordinateyou can receive the list of available locations of the search engines with their
 location_codeby making a separate request tohttps://api.dataforseo.com/v3/keywords_data/bing/locationsexample:
 
 2840 | 
| location_coordinate | string | GPS coordinates of a location required field if you don’t specify
 location_nameorlocation_codeif you use this field, you don’t need to specify
 location_nameorlocation_code
 location_coordinateparameter should be specified in the “latitude,longitude” formatthe data will be provided for the country the specified coordinates belong to
 example:
 
 52.6178549,-155.352142 | 
| language_name | string | full name of search engine language required field if you don’t specify
 language_codeif you use this field, you don’t need to specify
 language_codesupported languages:
 
 English,French,German | 
| language_code | string | search engine language code required field if you don’t specify
 language_nameif you use this field, you don’t need to specify
 language_namesupported languages:
 
 en,fr,de | 
| keywords_negative | array | keywords negative array optional field
 These keywords will be ignored in the results array;
 You can specify a maximum of 200 terms that you want to exclude from the results;
 the specified keywords will be converted to lowercase format
 | 
| device | string | device type optional field
 specify this field if you want to get the data for a particular device type
 possible values:
 all,mobile,desktop,tabletdefault value:
 all | 
| sort_by | string | results sorting parameters optional field
 Use these parameters to sort the results by
 search_volume,cpc,competitionorrelevancein the descending orderdefault value:
 relevance | 
| date_from | string | starting date of the time range optional field
 if you don’t specify this field, data will be provided for the last 12 months
 date format:
 "yyyy-mm-dd"example:
 
 "2020-01-01"Note: we do not recommend using a custom time range for the past year’s dates | 
| date_to | string | ending date of the time range optional field
 if you don’t specify this field, data will be provided for the last 12 months;
 minimum value: two years back from today’s date;
 maximum value: one month from today’s date;
 date format:
 "yyyy-mm-dd"example:
 
 "2020-03-15"Note: we do not recommend using a custom time range for the past year’s dates | 
| postback_url | string | return URL for sending task results optional field
 once the task is completed, we will send a POST request with its results compressed in the
 gzipformat to thepostback_urlyou specifiedyou can use the ‘$id’ string as a
 $idvariable and ‘$tag’ as urlencoded$tagvariable. We will set the necessary values before sending the request.example:
 
 http://your-server.com/postbackscript?id=$id
 http://your-server.com/postbackscript?id=$id&tag=$tagNote: special characters in
 postback_urlwill be urlencoded;i.a., the
 #character will be encoded into%23learn more on our Help Center | 
| pingback_url | string | notification URL of a completed task optional field
 when a task is completed we will notify you by GET request sent to the URL you have specified
 you can use the ‘$id’ string as a
 $idvariable and ‘$tag’ as urlencoded$tagvariable. We will set the necessary values before sending the request.example:
 
 http://your-server.com/pingscript?id=$id
 http://your-server.com/pingscript?id=$id&tag=$tagNote: special characters in
 pingback_urlwill be urlencoded;i.a., the
 #character will be encoded into%23learn more on our Help Center | 
| search_partners | boolean | Bing search partners type optional field
 if you specify
 true, the results will be delivered for owned, operated, and syndicated networks across Bing, Yahoo, AOL and partner sites that host Bing, AOL, and Yahoo search.default value:
 false– results are returned for Bing, AOL, and Yahoo search networks | 
| tag | string | user-defined task identifier optional field
 the character limit is 255
 you can use this parameter to identify the task and match it with the result
 you will find the specified
 tagvalue in thedataobject of the response |