Google organic results for a keyword — full SERP features

Inputs

• osstring, optional

  p em device operating system /em p optional field p if you specify code desktop /code in the code device /code field, choose from the following values: code windows /code , code macos /code p default value: code windows /code p if you specify code mobile /code in the code device /code

• tagstring, optional

  p em user-defined task identifier /em p optional field p em the character limit is 255 /em p you can use this parameter to identify the task and match it with the result p you will find the specified code tag /code value in the code data /code object of the response /p

• urlstring, optional

  p em direct URL of the search query /em p optional field p you can specify a direct URL and we will sort it out to the necessary fields. Note that this method is the most difficult for our API to process and also requires you to specify the exact language and location in the URL. In most cases, w

• depthinteger, optional

  p em parsing depth /em p optional field p number of results in SERP p strong default value: code 10 /code /strong p max value: code 200 /code /p br strong Your account will be billed per each SERP containing up to 10 results; /strong p Setting depth above 10 may result in additional char

• devicestring, optional

  p em device type /em p optional field p return results for a specific device type p can take the values: code desktop /code , code mobile /code p default value: code desktop /code /p

• targetstring, optional

  p em target domain, subdomain, or webpage to get results for /em p optional field p a domain or a subdomain should be specified without code https:// /code and code www. /code p note that the results of code target /code -specific tasks will only include SERP elements that contain a code ur

• keywordstring, optional

  p em keyword /em p strong required field /strong p you can specify strong up to 700 characters /strong in the code keyword /code field p all %## will be decoded (plus character ‘+’ will be decoded to a space character) p if you need to use the “%” character for your code keyword /code , pl

• se_domainstring, optional

  p em search engine domain /em p optional field p we choose the relevant search engine domain automatically according to the location and language you specify p however, you can set a custom search engine domain in this field p example: p em google.co.uk /em , code code /code /code em google

• match_typestring, optional

  p em target match type /em p strong required field if code stop_crawl_on_match /code is specified /strong p type of match for the code match_value /code p possible values: p code domain /code – specific domain or subdomain p code with_subdomains /code – main domain and subdomains p cod

• match_valuestring, optional

  p em target domain, subdomain, or wildcard value /em p strong required field if code stop_crawl_on_match /code is specified /strong p specify a target domain, subdomain, or wildcard value; p strong Note: /strong domain or subdomain must be specified without a request protocol; p example: c

• search_paramstring, optional

  p em additional parameters of the search query /em p optional field p a href="https://dataforseo.com/help-center/google-search-engine-parameters-and-how-to-use-them" get the list of available parameters and additional details here /a /p br strong Note: /strong the following search engine par

• language_codestring, optional

  p em search engine language code /em p optional field if you specify code language_name /code p strong if you use this field, you don't need to specify code language_name /code /strong p you can receive the list of available languages of the search engine with their code language_code /cod

• language_namestring, optional

  p em full name of search engine language /em p optional field if you specify code language_code /code p strong if you use this field, you don't need to specify code language_code /code /strong p you can receive the list of available languages of the search engine with their code language_n

• location_codeinteger, optional

  p em search engine location code /em p strong required field if you don't specify /strong code location_name /code  or code location_coordinate /code p strong if you use this field, you don't need to specify code location_name /code or code location_coordinate /code /strong p you

• location_namestring, optional

  p em full name of search engine location /em p strong required field if you don't specify /strong code location_code /code or code location_coordinate /code p strong if you use this field, you don't need to specify code location_code /code or code location_coordinate /code /strong p y

• find_targets_inarray, optional

  p em SERP element types to check for targets /em p optional field p to enable this parameter, code stop_crawl_on_match /code must also be enabled p specifies which SERP element types should be checked for target matches p if not specified, all first-level elements with code url /code and cod

• max_crawl_pagesinteger, optional

  p em page crawl limit /em p optional field p number of search results pages to crawl p max value: code 100 /code p strong Note: /strong you will be charged for each page crawled (10 organic results per page); p learn more about pricing on our a href="https://dataforseo.com/pricing/serp/googl

• remove_from_urlarray, optional

  p em remove specific parameters from URLs /em p optional field p using this field, you can specify up to 10 parameters to remove from URLs in the result p example: p code "remove_from_url": ["srsltid"] /code p strong Note: /strong if the code target /code field is specified, the specified U

• ignore_targets_inarray, optional

  p em SERP element types to exclude from target search /em p optional field p to enable this parameter, code stop_crawl_on_match /code must also be enabled p specifies which SERP element types should be excluded when searching for target matches p possible values: code organic /code , code pai

• target_search_modestring, optional

  p em target matching mode /em p optional field p to enable this parameter, code stop_crawl_on_match /code must also be enabled p defines how the crawl should stop when multiple targets are specified in code stop_crawl_on_match /code p possible values: code all /code , code any /code p cod

• location_coordinatestring, optional

  p em GPS coordinates of a location /em p optional field if you specify code location_name /code  or code location_code /code p strong if you use this field, you don't need to specify code location_name /code or code location_code /code /strong p code location_coordinate /code para

• stop_crawl_on_matcharray, optional

  array of targets to stop crawling optional field if specified, the response will contain SERP results up to and including the specified match_value; you can specify up to 10 target values in this array example: "stop_crawl_on_match":[{"match_value":"dataforseo.com","match_type":"with_subdomains"}] l

• browser_screen_widthinteger, optional

  p em browser screen width /em p optional field p you can set a custom browser screen width to calculate pixel rankings for a particular device; p can be specified within the following range: code 240-9999 /code ; p by default, the parameter is set to: p code 1920 /code for code desktop /code

• calculate_rectanglesboolean, optional

  p em calcualte pixel rankings for SERP elements in advanced results /em p optional field p pixel ranking refers to the distance between the result snippet and top left corner of the screen; p a href="https://dataforseo.com/help-center/pixel-ranking-in-serp-api" Visit Help Center to learn more&gt

• browser_screen_heightinteger, optional

  p em browser screen height /em p optional field p you can set a custom browser screen height to calculate pixel rankings for a particular device; p can be specified within the following range: code 240-9999 /code ; p by default, the parameter is set to: p code 1080 /code for code desktop /cod

• group_organic_resultsboolean, optional

  p em display related results /em p optional field p if set to code true /code , the code related_result /code element in the response will be provided as a snippet of its parent organic result; p if set to code false /code , the code related_result /code element will be provided as a separa

• load_async_ai_overviewboolean, optional

  p em load asynchronous ai overview /em p optional field p set to code true /code to obtain code ai_overview /code items is SERPs even if they are loaded asynchronously; p if set to code false /code , you will only obtain code ai_overview /code items from cache; p default value: code false

• people_also_ask_click_depthinteger, optional

  p em clicks on the corresponding element /em p optional field p specify the click depth on the code people_also_ask /code element to get additional code people_also_ask_element /code items; p strong Note /strong your account will be billed $0.00015 extra for each click; p if the element is

• browser_screen_resolution_ratiointeger, optional

  p em browser screen resolution ratio /em p optional field p you can set a custom browser screen resolution ratio to calculate pixel rankings for a particular device; p can be specified within the following range: code 0.5-3 /code ; p by default, the parameter is set to: p code 1 /code for cod