/keyword-overviewMetrics for specific keywords
Keywords
Cost / request
$0.01
Response format
JSON
Protocol
REST
Description
Returns full metrics for the exact keywords you pass: search volume, CPC and competition (keyword_info), keyword difficulty (keyword_properties.keyword_difficulty), trend history and SERP characteristics. Use this when you already know the keywords and need their numbers; use keyword_ideas when you need to discover keywords.
Parameters
bodyRequest Bodyrequired
Content type: application/json
{
"type": "object",
"required": [
"keywords"
],
"properties": {
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 700,
"description": "The exact keywords to look up (1-700). Cost scales with the number of keywords."
},
"location_code": {
"type": "integer",
"description": "Geo target as a location code. Default 2840 (United States).",
"default": 2840
},
"language_code": {
"type": "string",
"description": "Two-letter language code. Default 'en'.",
"default": "en"
}
}
}Responses
Per-keyword metrics in `result[0].items`.
{
"type": "object"
}Agent / Developer Schema
Machine-readable formats for integrating this endpoint into AI agents and toolchains.
{
"operationId": "keyword_overview",
"method": "post",
"path": "/keyword-overview",
"summary": "Metrics for specific keywords",
"description": "Returns full metrics for the exact keywords you pass: search volume, CPC and competition (keyword_info), keyword difficulty (keyword_properties.keyword_difficulty), trend history and SERP characteristics. Use this when you already know the keywords and need their numbers; use keyword_ideas when you need to discover keywords.",
"parameters": [],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"keywords"
],
"properties": {
"keywords": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 700,
"description": "The exact keywords to look up (1-700). Cost scales with the number of keywords."
},
"location_code": {
"type": "integer",
"description": "Geo target as a location code. Default 2840 (United States).",
"default": 2840
},
"language_code": {
"type": "string",
"description": "Two-letter language code. Default 'en'.",
"default": "en"
}
}
},
"example": {
"keywords": [
"crm migration",
"hubspot alternative"
]
}
}
}
},
"responses": [
{
"statusCode": "200",
"description": "Per-keyword metrics in `result[0].items`.",
"content": {
"application/json": {
"schema": {
"type": "object"
}
}
}
},
{
"statusCode": "400",
"description": "Bad request or upstream task error."
},
{
"statusCode": "401",
"description": "Unauthorized."
},
{
"statusCode": "429",
"description": "Too many requests."
},
{
"statusCode": "5XX",
"description": "Upstream error."
}
]
}Pricing
$0.01per successful request
Credits are deducted from your agntdata balance on each successful API call. Failed requests (4xx/5xx) are not charged.
Start using this endpoint
Generate your API key and make your first call in under a minute. Free tier available with transparent pricing.