# DataForSEO · Keyword search volume

Get SEO and search ranking data with DataForSEO · Keyword search volume from Alexandria through one Spiral API key. Google Ads monthly search volume, CPC, bids, and paid competition for up to 1000 keywords in one call. Limited to 12 calls a minute on the shared account. Omit location for worldwide figures. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: SEO
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `dataforseo/keywords/search-volume`
- Page: https://spiral.ai/tools/alexandria/dataforseo/keywords/search-volume

## Pricing

Up to $0.0768196 per run.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `keywords` (required) | list |  | — | Up to 1000 keywords, each at most 80 characters and 10 words. The price is the same for 1 or 1000. |
| `date_to` | text |  | — | End of the range, yyyy-mm-dd. Google Ads has no data for the current month. |
| `sort_by` | one of | relevance, search_volume, competition_index, low_top_of_page_bid, high_top_of_page_bid | — | Sort order, descending. Default relevance. |
| `date_from` | text |  | — | Start of the range, yyyy-mm-dd, up to 4 years back. Default is the last 12 months. |
| `language_code` | text |  | — | Language code, such as en. Use this or language_name. |
| `language_name` | text |  | — | Full language name, such as English. Use this or language_code. |
| `location_code` | number |  | — | DataForSEO location code, such as 2840 for the United States. Use this or location_name. |
| `location_name` | text |  | — | Full location name, such as United States or London,England,United Kingdom. Use this or location_code. |
| `search_partners` | true or false |  | — | Include Google search partner sites. Default false. |
| `include_adult_keywords` | true or false |  | — | Include adult keywords. Default false. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "dataforseo/keywords/search-volume",
    "input": {
      "keywords": [
        "<keywords>"
      ]
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=dataforseo%2Fkeywords%2Fsearch-volume

## Common questions

### DataForSEO · Keyword search volume

**How much does DataForSEO · Keyword search volume cost?**

Up to $0.0768196 per run. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use DataForSEO · Keyword search volume through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "dataforseo/keywords/search-volume"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use DataForSEO · Keyword search volume?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use DataForSEO · Keyword search volume?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

