Estimate AI search volume for a keyword
Synchronously estimate monthly LLM query volume for one keyword and country. Organization-scoped API keys only. Charges 40 prepaid credits per attempt (including cache hits and upstream no-data/errors after validation). Requires an Idempotency-Key header.
POST /search-volume
Estimate AI search volume for a keyword
Synchronously estimate monthly LLM query volume for one keyword and country. Organization-scoped API keys only. Charges 40 prepaid credits per attempt (including cache hits and upstream no-data/errors after validation). Requires an Idempotency-Key header.
Authentication: API key required (Bearer token)
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
keyword | string | Yes | Keyword or short phrase to estimate AI search demand for. |
country | string | Yes | ISO 3166-1 alpha-2 country code. |
Request Example
curl -X POST https://sellm.io/api/v1/search-volume \
-H "Authorization: Bearer sellm_your_api_key_here" \
-H "Content-Type: application/json"Responses
| Status | Description |
|---|---|
200 | Search-volume estimate |
400 | Bad request |
401 | Unauthorized |
403 | Organization key required or credits exceeded |
404 | No search-volume data |
409 | Idempotency key reused with different payload |
429 | Rate limited |
500 | Internal error |
502 | Upstream error |
503 | Service unavailable |
504 | Upstream timeout |