Keyword overview

Returns core metrics for a keyword: average monthly search volume, difficulty, cost-per-click, classified search intent and a 12-month volume trend. Pass a single keyword, or up to 100 comma-separated keywords in one request.

GET/keywords/overview

Query parameters

ParameterTypeDescription
keywordrequiredstringThe keyword to look up. Provide a comma-separated list (max 100) for batch lookups.
countrystring2-letter ISO country code. Defaults to `us`.
languagestring2-letter ISO language code. Defaults to `en`.

Example request

cURL
curl "https://api.oneclickseo.ai/v1/keywords/overview?keyword=seo%20tools&country=us" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Each keyword object contains the fields below. `trend` is an array of the last 12 monthly search volumes, oldest first.

200Keyword metrics
Response
{
  "data": [
    {
      "keyword": "seo tools",
      "volume": 49500,
      "difficulty": 78,
      "cpc": 12.4,
      "competition": 64,
      "intent": "COMPARISON",
      "type": "STANDARD",
      "trend": [40500, 44100, 49500, 49500, 49500, 49500,
                49500, 49500, 49500, 49500, 49500, 49500]
    }
  ],
  "meta": { "request_id": "req_8f2c1a", "credits_charged": 0 }
}
Response fields
ParameterTypeDescription
keywordstringThe keyword these metrics describe.
volumeintegerAverage monthly search volume.
difficultyintegerKeyword difficulty, 0-100 (higher is harder to rank for).
cpcfloatAverage cost-per-click in USD, or `null` if unavailable.
competitionintegerPaid competition score, 0-100 (Google Ads).
intentstringSearch intent: `NAVIGATIONAL`, `HIGH_INTENT`, `PRE_PURCHASE`, `POST_PURCHASE` or `COMPARISON`.
typestring`STANDARD` or `QUESTION`.
trendinteger[]Last 12 monthly search volumes, oldest first.