# Keyword difficulty scores for up to 1000 keywords

This endpoint will provide you with the Keyword Difficulty metric for a maximum of 1,000 keywords in one API request.

|  |  |
| --- | --- |
| Tool id | `dataforseo.x-dataforseo-labs-google-bulk-keyword-difficulty-live` |
| Platform | [Google](https://www.orcarouter.ai/tools/google.md) |
| Capability | [Keyword research](https://www.orcarouter.ai/tools/google/keywords-research.md) |
| Price | $0.013596 per call |
| Health | OK |
| p50 latency | — |
| Success (7 days) | — |
| Runs (30 days) | — |
| Idempotent | no |
| Data class | unclassified |

## Input

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `keywords` | array | no | target keywords required field UTF-8 encoding maximum number of keywords you can specify in this array: 1000 the keywords will be converted to lowercase format learn more about rules and limitations of keyword and keywords fields in DataForSEO APIs in this Help Center article |
| `language_code` | string | no | language code required field if don’t specify language_name you can receive the list of available languages with their language_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: en |
| `language_name` | string | no | full name of the language required field if don’t specify language_code you can receive the list of available languages with their language_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: English |
| `location_code` | integer | no | location code required field if don’t specify location_name you can receive the list of available locations with their location_code by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: 2840 |
| `location_name` | string | no | full name of the location required field if don’t specify location_code you can receive the list of available locations with their location_name by making a separate request to the https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages example: United Kingdom |
| `tag` | string | no | user-defined task identifier optional field the character limit is 255 you can use this parameter to identify the task and match it with the result you will find the specified tag value in the data object of the response |

## Call it

```bash
curl -sS https://api.orcarouter.ai/v1/tools/dataforseo.x-dataforseo-labs-google-bulk-keyword-difficulty-live/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-dataforseo-labs-google-bulk-keyword-difficulty-live/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 Keyword difficulty scores for up to 1000 keywords cost?

Keyword difficulty scores for up to 1000 keywords costs $0.013596 per call: 1,000 calls cost $13.596.

### What does a $10 budget buy with Keyword difficulty scores for up to 1000 keywords?

About 735 calls at $0.013596 per call.

### What inputs does Keyword difficulty scores for up to 1000 keywords need?

It has no required inputs.

### How do I call Keyword difficulty scores for up to 1000 keywords?

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-dataforseo-labs-google-bulk-keyword-difficulty-live