# Google Local Finder results for a keyword, live

Live Google Local_finder SERP provides real-time search engine results for the specified keyword and location.

|  |  |
| --- | --- |
| Tool id | `dataforseo.x-serp-google-local-finder-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 |
| --- | --- | --- | --- |
| `depth` | integer | no | \<p>\<em>parsing depth\</em>\<p>optional field\<p>number of results in SERP\<p>default value for \<code>desktop\</code>: \<code>20\</code>\<p>max value for \<code>desktop\</code>: \<code>100\</code>\</p>\<br>\<p>default value for \<code>mobile\</code>: \<code>10\</code>\<p>max value for \<code>mobile\</code>: \<code>100\</cod |
| `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>\<strong>required field if you don't specify\</strong> \<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 \< |
| `language_name` | string | no | \<p>\<em>full name of search engine language\</em>\<p>\<strong>required field if you don't specify\</strong> \<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 |
| `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 |
| `min_rating` | number | no | \<p>\<em>filter results by minimum rating\</em>\<p>optional field\<p>possible values for \<code>desktop\</code>: \<code>3.5\</code>, \<code>4\</code>, \<code>4.5\</code>;\<p>possible values for \<code>mobile\</code>: \<code>2\</code>, \<code>2.5\</code>, \<code>3\</code>, \<code>3.5\</code>, \<code>4\</code>, \<code>4.5\</code |
| `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 |
| `priority` | integer | no | \<p>\<em>task priority\</em>\<p>optional field\<p>can take the following values:\<p>1 – normal execution priority (set by default)\<p>2 – high execution priority\</p>\<br>You will be additionally charged for the tasks with high execution priority.\<p>The cost can be calculated on the \<a title="Pricing" href=" |
| `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> |
| `time_filter` | string | no | \<p>\<em>filter results by open hours\</em>\<p>optional field\<p>using this field, you can filter places in the results by the time a place is open for visitors\<p>note that Google may also provide results that do not match this filter\<p>possible values: \<code>"open_now"\</code>, \<code>"24_hours"\</code>, \< |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/dataforseo.x-serp-google-local-finder-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-local-finder-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 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 Local Finder results for a keyword, live cost?

Google Local Finder results for a keyword, live costs $0.0022 per call: 1,000 calls cost $2.20.

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

About 4545 calls at $0.0022 per call.

### What inputs does Google Local Finder results for a keyword, live need?

It has no required inputs.

### How do I call Google Local Finder 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/keywords-research/x-serp-google-local-finder-live-advanced
