Get DataForSEO keyword metrics: pay per use, no API key
Use DataForSEO from Claude, Claude Code, Cursor, ChatGPT, and other agents through one Cralo balance.
Return search volume, CPC, competition, and monthly trends through DataForSEO.
Price and execution
- Price
- $0.07
- Pricing model
- Fixed price per successful call
- Execution class
- fast
Limits
No additional limits are published for this tool.
Parameters
Fields dataforseo.keyword-metrics accepts as JSON input.
keywordsarray of stringRequiredSEO search terms to retrieve metrics for, with at most 1,000 unique terms.
language_codestringOptionalLanguage code for keyword metrics, such as `en` or `en-US`.
location_codeintegerOptionalDataForSEO numeric location code, defaulting to 2840 for the United States.
Raw input JSON Schema
{
"type": "object",
"required": [
"keywords"
],
"properties": {
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 1000,
"minItems": 1,
"uniqueItems": true,
"description": "SEO search terms to retrieve metrics for, with at most 1,000 unique terms."
},
"language_code": {
"type": "string",
"default": "en",
"pattern": "^[A-Za-z-]{2,12}quot;,
"description": "Language code for keyword metrics, such as `en` or `en-US`."
},
"location_code": {
"type": "integer",
"default": 2840,
"minimum": 1,
"description": "DataForSEO numeric location code, defaulting to 2840 for the United States."
}
},
"additionalProperties": false
}Returns
Fields a successful dataforseo.keyword-metrics call returns.
metricsarray of objectRequiredcpc_usdnumber | nullRequiredkeywordstringRequiredcompetitionnumber | nullRequiredsearch_volumenumber | nullRequiredmonthly_searchesarray of objectRequired
retrieved_atstring (date-time)Requiredprovider_cost_usdnumber | nullRequiredprovider_credits_usednumber | nullRequired
Raw output JSON Schema
{
"type": "object",
"required": [
"metrics",
"provider_cost_usd",
"provider_credits_used",
"retrieved_at"
],
"properties": {
"metrics": {
"type": "array",
"items": {
"type": "object",
"required": [
"keyword",
"search_volume",
"cpc_usd",
"competition",
"monthly_searches"
],
"properties": {
"cpc_usd": {
"type": [
"number",
"null"
],
"minimum": 0
},
"keyword": {
"type": "string"
},
"competition": {
"type": [
"number",
"null"
],
"minimum": 0
},
"search_volume": {
"type": [
"number",
"null"
],
"minimum": 0
},
"monthly_searches": {
"type": "array",
"items": {
"type": "object",
"required": [
"year",
"month",
"volume"
],
"properties": {
"year": {
"type": "integer",
"minimum": 2000
},
"month": {
"type": [
"string",
"integer"
]
},
"volume": {
"type": "number",
"minimum": 0
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"maxItems": 1000
},
"retrieved_at": {
"type": "string",
"format": "date-time"
},
"provider_cost_usd": {
"type": [
"number",
"null"
],
"minimum": 0
},
"provider_credits_used": {
"type": [
"number",
"null"
],
"minimum": 0
}
},
"additionalProperties": false
}Run this tool
Copy this instruction to your agent to set up Cralo and call this tool with the example input.
Set up Cralo by following https://cralo.ai/SKILL.md, then call the dataforseo.keyword-metrics tool with this input: {"keywords":["Cralo"],"location_code":2840,"language_code":"en"}Safety notes
- Side Effect
- read_only
How this compares to using DataForSEO directly
You do not need a separate DataForSEO account or subscription for this call. Cralo uses one prepaid balance across all tools and shows the per-call price before you run the command.