# DataForSEO Google Historical Search Volume API

> Get historical Google search volume for keywords from DataForSEO Labs: monthly searches, CPC, competition and keyword properties by location and language.

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

## Facts

- Provider: DataForSEO
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/dataforseo/v3/dataforseo_labs/google/historical_search_volume/live`
- Price: $0.02 per call
- Capabilities: labs, keywords, google, seo
- 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_search_volume/live` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

## FAQ

### How do I use the DataForSEO Google Historical Search Volume API?

Send a POST request to https://api.sandbase.ai/v1/api/dataforseo/v3/dataforseo_labs/google/historical_search_volume/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 Search Volume API cost?

$0.02 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 Search Volume API accept?

DataForSEO Google Historical Search Volume takes no input parameters; send an empty JSON body.

### What does the DataForSEO Google Historical Search Volume API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

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

No. DataForSEO Google Historical Search Volume 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 Search Volume API

Send keywords with a location and language and get their search volume history and keyword metrics.

#### Use cases

- Analyze seasonality and long-term demand.
- Compare keyword trends year over year.
- Prioritize SEO keywords.

#### Request

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

#### Parameters

The body is passed through to DataForSEO. Common fields:

| Name | Type | Description |
|---|---|---|
| `keywords` | array | Keywords to look up. |
| `location_code` | integer | DataForSEO location code, e.g. 2840 for the United States. |
| `language_code` | string | Language code, e.g. "en". |

#### Example response

Real response for the request above, trimmed to the main fields. User names and long IDs are masked.

```json
{
  "status_code": 20000,
  "tasks": [
    {
      "result": [
        {
          "items": [
            {
              "keyword": "openai api",
              "location_code": 2840,
              "keyword_info": {
                "search_volume": 49500,
                "cpc": 11.63,
                "competition": 0.07,
                "competition_level": "LOW",
                "last_updated_time": "2026-09-16 14:09:04 +00:00",
                "monthly_searches": [
                  {
                    "month": 8,
                    "search_volume": 49500,
                    "year": 2026
                  },
                  {
                    "month": 7,
                    "search_volume": 49500,
                    "year": 2026
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  ]
}
```

#### Pricing

Flat price per call. Failed calls are not charged.

#### Related APIs

- [DataForSEO Google Ads Keyword Search Volume](/model/dataforseo/v3/keywords_data/google_ads/search_volume/live): Get Google Ads search volume, CPC, competition and 12-month trend for up to 1,000 keywords per request, by location and language.
- [DataForSEO Google Trends](/model/dataforseo/v3/keywords_data/google_trends/explore/live): Get Google Trends interest over time for up to 5 keywords by location, language and time range, with weekly values on a 0–100 scale.
- [DataForSEO Website Screenshot](/model/dataforseo/v3/on_page/page_screenshot): Capture a full-page or viewport screenshot of any URL in desktop, mobile or tablet view.