# Google organic results for a keyword — full SERP features

Live SERP provides real-time data on top search engine results for the specified keyword, search engine, and location.

|  |  |
| --- | --- |
| Tool id | `dataforseo.x-serp-google-organic-live-advanced` |
| Platform | [Google](https://www.orcarouter.ai/tools/google.md) |
| Capability | [Keyword research](https://www.orcarouter.ai/tools/google/keywords-research.md) |
| Price | $0.0044 per call |
| Health | OK |
| p50 latency | 4.9 s |
| Success (7 days) | 100% |
| Runs (30 days) | 40 |
| Idempotent | no |
| Data class | unclassified |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `browser_screen_height` | integer | no | \<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 |
| `browser_screen_resolution_ratio` | integer | no | \<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 |
| `browser_screen_width` | integer | no | \<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_rectangles` | boolean | no | \<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 |
| `depth` | integer | no | \<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 |
| `device` | string | no | \<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> |
| `find_targets_in` | array | no | \<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 |
| `group_organic_results` | boolean | no | \<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 |
| `ignore_targets_in` | array | no | \<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 |
| `keyword` | string | no | \<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 |
| `language_code` | string | no | \<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_name` | string | no | \<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 |
| `load_async_ai_overview` | boolean | no | \<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 |
| `location_code` | integer | no | \<p>\<em>search engine location code\</em>\<p>\<strong>required field if you don't specify\</strong> \<code>location_name\</code>\&nbsp;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_coordinate` | string | no | \<p>\<em>GPS coordinates of a location\</em>\<p>optional field if you specify \<code>location_name\</code>\&nbsp;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 |
| `location_name` | string | no | \<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 |
| `match_type` | string | no | \<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_value` | string | no | \<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 |
| `max_crawl_pages` | integer | no | \<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 |
| `os` | string | no | \<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 |
| `people_also_ask_click_depth` | integer | no | \<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 |
| `remove_from_url` | array | no | \<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 |
| `se_domain` | string | no | \<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 |
| `search_param` | string | no | \<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 |
| `stop_crawl_on_match` | array | no | 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 |
| `tag` | string | no | \<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> |
| `target` | string | no | \<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 |
| `target_search_mode` | string | no | \<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 |
| `url` | string | no | \<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 |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/dataforseo.x-serp-google-organic-live-advanced/run \
  -H "Authorization: Bearer $ORCAROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{}}'
```

```python
import os, requests

resp = requests.post(
    "https://api.orcarouter.ai/v1/tools/dataforseo.x-serp-google-organic-live-advanced/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [Past Google search results for a keyword, by date range](https://www.orcarouter.ai/tools/google/keywords-research/x-dataforseo-labs-google-historical-serps-live.md) | — | $0.000132 per call | OK |
| [Search Google by keyword — organic results](https://www.orcarouter.ai/tools/google/keywords-research/x-v1-google-search.md) | — | $0.002068 per credit | OK |
| [Google organic search results for a keyword, live](https://www.orcarouter.ai/tools/google/keywords-research/google-serp-organic.md) | — | $0.0022 per call | OK |
| [Google Dataset search results for a keyword, live](https://www.orcarouter.ai/tools/google/keywords-research/x-serp-google-dataset-search-live-advanced.md) | — | $0.0022 per call | OK |
| [Google Events results for a keyword and location, live](https://www.orcarouter.ai/tools/google/keywords-research/x-serp-google-events-live-advanced.md) | — | $0.0022 per call | OK |
| [Google Images results for a keyword, live](https://www.orcarouter.ai/tools/google/keywords-research/x-serp-google-images-live-advanced.md) | — | $0.0022 per call | OK |
| [Google Local Finder results for a keyword, live](https://www.orcarouter.ai/tools/google/keywords-research/x-serp-google-local-finder-live-advanced.md) | — | $0.0022 per call | OK |
| [Google Maps results for a keyword and location, live](https://www.orcarouter.ai/tools/google/keywords-research/x-serp-google-maps-live-advanced.md) | — | $0.0022 per call | OK |
| [Google News results for a keyword, live](https://www.orcarouter.ai/tools/google/keywords-research/x-serp-google-news-live-advanced.md) | — | $0.0022 per call | OK |
| [Google Hotels search results for a keyword, live](https://www.orcarouter.ai/tools/google/keywords-research/x-business-data-google-hotel-searches-live.md) | — | $0.0044 per call | OK |

Showing the first 10 of 23.

## FAQ

### How much does Google organic results for a keyword — full SERP features cost?

Google organic results for a keyword — full SERP features costs $0.0044 per call: 1,000 calls cost $4.40.

### What does a $10 budget buy with Google organic results for a keyword — full SERP features?

About 2272 calls at $0.0044 per call.

### How fast is Google organic results for a keyword — full SERP features?

Its median response time over recent runs is 4877 ms.

### How reliable is Google organic results for a keyword — full SERP features?

100% of its runs succeeded over the last 7 days.

### What inputs does Google organic results for a keyword — full SERP features need?

It has no required inputs.

### How do I call Google organic results for a keyword — full SERP features?

Send POST /v1/tools/{id}/run with your OrcaRouter API key and a JSON body {"input": {…}}, where {id} is the tool id POST /v1/tools/discover returns for it.

---

Markdown version of https://www.orcarouter.ai/tools/google/keywords-research/x-serp-google-organic-live-advanced
