# Google Events results for a keyword and location, live

Live Google Events SERP provides real-time data from Google Events Search for the specified keyword and location.

|  |  |
| --- | --- |
| Tool id | `dataforseo.x-serp-google-events-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.0022 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | no |
| Data class | unclassified |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `date_range` | string | no | \<p>\<em>date range to get events for\</em>\<p>optional field\<p>if you do not use this field, we will return all events\<p>possible values: \<code>today\</code>, \<code>tomorrow\</code>, \<code>week\</code>, \<code>weekend\</code>, \<code>next_week\</code>, \<code>month\</code>, \<code>next_month\</code>\</p> |
| `depth` | integer | no | \<p>\<em>parsing depth\</em>\<p>optional field\<p>number of results in SERP\<p>default value: \<code>10\</code>\<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 charges if the search |
| `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\<p>\<strong>if you use this field, you don't need to specify \<code>language_name\</code>\</strong>\<p>by default, language settings correspond to one of the local official languages of the specified location\<p>you can receive the list of available |
| `language_name` | string | no | \<p>\<em>full name of search engine language\</em>\<p>optional field\<p>\<strong>if you use this field, you don't need to specify \<code>language_code\</code>\</strong>\<p>by default, language settings correspond to one of the local official languages of the specified location\<p>you can receive the list of av |
| `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 |
| `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> the \<code>max_crawl_pages\</code> and \<code>depth\</code> parameters complement each other;\<p>learn more at \<a href="https://dataforseo.com/help-center/what-is |
| `os` | string | no | \<p>\<em>device operating system\</em>\<p>optional field\<p>\<strong>note that this API provides results for desktop only\</strong>\<p>choose from the following values: \<code>windows\</code>, \<code>macos\</code>\<p>default value: \<code>windows\</code>\</p> |
| `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 you specify\<p>however, you can set a custom search engine domain in this field\<p>example:\<p>\<code>\<em>google.co.uk\</em>\</code>, \<code>\<em>google.com.au\</em>\</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-events-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-events-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 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 |
| [Google organic results for a keyword — full SERP features](https://www.orcarouter.ai/tools/google/keywords-research/x-serp-google-organic-live-advanced.md) | — | $0.0044 per call | OK |

Showing the first 10 of 23.

## FAQ

### How much does Google Events results for a keyword and location, live cost?

Google Events results for a keyword and location, live costs $0.0022 per call: 1,000 calls cost $2.20.

### What does a $10 budget buy with Google Events results for a keyword and location, live?

About 4545 calls at $0.0022 per call.

### What inputs does Google Events results for a keyword and location, live need?

It has no required inputs.

### How do I call Google Events results for a keyword and location, 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/keywords-research/x-serp-google-events-live-advanced
