# Google AI Mode results for a keyword, live

Google AI Mode SERP API provides search results from the AI Mode feature of Google Search.

|  |  |
| --- | --- |
| Tool id | `dataforseo.x-serp-google-ai-mode-live-advanced` |
| Platform | [Google](https://www.orcarouter.ai/tools/google.md) |
| Capability | [AI answer visibility](https://www.orcarouter.ai/tools/google/ai-visibility.md) |
| Price | $0.0044 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| 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>calculate 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 |
| `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> |
| `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>required field if you don't specify \<code>language_name\</code>;\<p>if you use this field, you don't need to specify \<code>language_name\</code>;\<p>you can receive the list of available languages of the search engine with their \<code>language_code\</code>\&nbsp;b |
| `language_name` | string | no | \<p>\<em>full name of search engine language\</em>\<p>required field if you don't specify \<code>language_code\</code>;\<p>if you use this field, you don't need to specify \<code>language_code\</code>;\<p>you can receive the list of available languages of the search engine with their \<code>language_name\</code |
| `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>\<strong>required field if you don't specify\</strong> \<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 |
| `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 |
| `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 |
| `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> |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/dataforseo.x-serp-google-ai-mode-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-ai-mode-live-advanced/run",
    headers={"Authorization": f"Bearer {os.environ['ORCAROUTER_API_KEY']}"},
    json={"input":{}},
)
print(resp.json())
```

## Alternatives

| Tool | Source | Price | Health |
| --- | --- | --- | --- |
| [Google AI Mode](https://www.orcarouter.ai/tools/google/ai-visibility/google-ai-mode.md) | — | $0.00077 per call | OK |
| [Google AI Overview](https://www.orcarouter.ai/tools/google/ai-visibility/google-serp-ai-overview.md) | — | $0.00165 per call | OK |
| [Google AI Mode answer for a query](https://www.orcarouter.ai/tools/google/ai-visibility/x-google-ai-mode.md) | — | $0.0275 per call | OK |

## FAQ

### How much does Google AI Mode results for a keyword, live cost?

Google AI Mode results for a keyword, live costs $0.0044 per call: 1,000 calls cost $4.40.

### What does a $10 budget buy with Google AI Mode results for a keyword, live?

About 2272 calls at $0.0044 per call.

### What inputs does Google AI Mode results for a keyword, live need?

It has no required inputs.

### How do I call Google AI Mode results for a keyword, live?

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/ai-visibility/x-serp-google-ai-mode-live-advanced
