# Ahrefs Site Explorer Total Search Volume History API

[Tools](/tools) / [SEO And Marketing](/tools/category/seo-and-marketing) / [Ahrefs Site Explorer Total Search Volume History](/tools/ahrefs/site-explorer-total-search-volume-history)

Track total search volume of keywords a target ranks for over time.

Data from [Ahrefs](/providers/ahrefs).

Category: [SEO And Marketing](/tools/category/seo-and-marketing)

## Price

Variable: provider price plus 35% Inspect returns pricing metadata, not a quote. Use max_cost_usd caps where supported.

Input schema is not available in the local snapshot. Call inspect first; fill body and queryParams as required and replace any pathParams placeholders before running.

## Discover

```sh
curl https://keepbal.com/apis/v1/discover -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' -H 'Content-Type: application/json' -d '{"query":"Ahrefs"}'
```

## Inspect

```sh
curl https://keepbal.com/apis/v1/inspect -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' -H 'Content-Type: application/json' -d '{"publicId":"ahrefs/site-explorer-total-search-volume-history"}'
```

## curl

```sh
curl https://keepbal.com/apis/v1/ahrefs/site-explorer-total-search-volume-history \
  -H 'Authorization: Bearer YOUR_KEEPBAL_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'
```

## MCP run_tool

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "run_tool",
    "arguments": {
      "tool": "ahrefs/site-explorer-total-search-volume-history",
      "input": {}
    }
  }
}
```

## Python

```python
import json, os, requests

# Inspect first and replace input_data with the required parameters.
input_data = json.loads("{}")
response = requests.post(
    "https://keepbal.com/apis/v1/ahrefs/site-explorer-total-search-volume-history",
    headers={"Authorization": "Bearer " + os.environ["KEEPBAL_API_KEY"]},
    json=input_data,
)
response.raise_for_status()
print(response.json())
```

## Errors and billing

Failed provider calls are not charged. HTTP 400 invalid_request means invalid JSON or parameters, including missing pathParams. HTTP 401 missing_api_key or invalid_api_key means authentication is required. HTTP 402 insufficient_credits means insufficient balance; top up before retrying. HTTP 503 provider_unavailable means the provider is unavailable. A pending run can settle later; poll GET /apis/v1/runs/{id} instead of starting another execution.

## How much does this API cost?

Variable: provider price plus 35%

## How do I start?

Create a KeepBal account with $1 free credit, obtain an API key, and inspect this tool before running it.

## Related tools

- [Ahrefs Batch Analysis Batch Analysis](/tools/ahrefs/batch-analysis-batch-analysis) — Get Domain Rating, backlinks, and traffic metrics for up to 100 targets at once. — Variable: provider price plus 35%
- [Ahrefs Keywords Explorer Matching Terms](/tools/ahrefs/keywords-explorer-matching-terms) — Find keyword ideas containing seed terms, with volume and difficulty. — Variable: provider price plus 35%
- [Ahrefs Keywords Explorer Overview](/tools/ahrefs/keywords-explorer-overview) — Get volume, difficulty, traffic potential, intent, and CPC for up to 100 keywords. — Variable: provider price plus 35%
- [Ahrefs Keywords Explorer Related Terms](/tools/ahrefs/keywords-explorer-related-terms) — Find keywords related to seed terms, with volume and difficulty. — Variable: provider price plus 35%
- [Ahrefs Keywords Explorer Search Suggestions](/tools/ahrefs/keywords-explorer-search-suggestions) — Get autocomplete-style keyword suggestions for seeds, with volume and CPC. — Variable: provider price plus 35%
- [Ahrefs Keywords Explorer Volume By Country](/tools/ahrefs/keywords-explorer-volume-by-country) — Split a keyword's search volume across countries. — Variable: provider price plus 35%



[Start with $1 free credit](/sign-up)

[Tools](/tools) · [MCP documentation](/docs/mcp)