[← Back to tools]
DFS
dataforseo.keyword-metrics

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 stringRequired

    SEO search terms to retrieve metrics for, with at most 1,000 unique terms.

  • language_codestringOptional

    Language code for keyword metrics, such as `en` or `en-US`.

  • location_codeintegerOptional

    DataForSEO 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 objectRequired
    • cpc_usdnumber | nullRequired
    • keywordstringRequired
    • competitionnumber | nullRequired
    • search_volumenumber | nullRequired
    • monthly_searchesarray of objectRequired
  • retrieved_atstring (date-time)Required
  • provider_cost_usdnumber | nullRequired
  • provider_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.