# DataForSEO Google Historical Keyword Data API

> Get month-by-month history of search volume, CPC and competition for up to 100 Google keywords, going back to 2019.

Source: https://www.sandbase.ai/model/dataforseo/v3/dataforseo_labs/google/historical_keyword_data/live
API reference: https://www.sandbase.ai/model/dataforseo/v3/dataforseo_labs/google/historical_keyword_data/live/docs

## Facts

- Provider: DataForSEO
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/dataforseo/v3/dataforseo_labs/google/historical_keyword_data/live`
- Price: $0.04 per call
- Capabilities: labs, keywords, google, trends
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/dataforseo/v3/dataforseo_labs/google/historical_keyword_data/live` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

## FAQ

### How do I use the DataForSEO Google Historical Keyword Data API?

Send a POST request to https://api.sandbase.ai/v1/api/dataforseo/v3/dataforseo_labs/google/historical_keyword_data/live with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

### How much does the DataForSEO Google Historical Keyword Data API cost?

$0.04 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the DataForSEO Google Historical Keyword Data API accept?

DataForSEO Google Historical Keyword Data takes no input parameters; send an empty JSON body.

### What does the DataForSEO Google Historical Keyword Data API return?

A JSON response returned in the same HTTP request (synchronous).

### Do I need a DataForSEO developer account or API key?

No. DataForSEO Google Historical Keyword Data runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for DataForSEO API access separately.

## README

### Google Historical Keyword Data API

Get month-by-month history of search volume, CPC and competition for up to 100 Google keywords, going back to 2019.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/dataforseo/v3/dataforseo_labs/google/historical_keyword_data/live" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keywords": ["openai api"], "location_code": 2840, "language_code": "en"}'
```

#### Parameters

The body is passed through to DataForSEO. See the [official documentation](https://docs.dataforseo.com/v3/dataforseo_labs/google/historical_keyword_data/live/) for every field.

#### Pricing

Flat price per call. One task per request; `limit` is capped at 100 and input lists (`keywords`, `targets`, `asins`, `app_ids` ...) accept at most 100 items. Failed calls are not charged.