Google Keyword Difficulty Scores for a List of Keywords (US English)

omnial/google-keyword-difficulty-us-english

Given a list of keywords, returns a difficulty score from 0 to 100 for each one: an estimate of how hard it is to rank in Google's top organic results for it in the United States in English, higher meaning harder. Also returns how many keywords were scored.

activeper resultv1

Price

Up to $0.0164 base + $0.000164 per result; you pay what the call used

The price shown is the price you pay. No monthly minimum. Top-ups start at $5.

Data source

Google search ranking index

Data from an index of Google search rankings, with keyword difficulty estimates.

Use it

Five steps: search, inspect, learn, run, settle. No per-tool setup; your agent reaches this tool through the meta-tools it already has.

agent

// 1. search: find the tool
omnial_search({ query: "what you need" })

// 2. inspect: price and input schema
omnial_inspect({ tool: "omnial/google-keyword-difficulty-us-english" })

// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/google-keyword-difficulty-us-english" })

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/google-keyword-difficulty-us-english", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/google-keyword-difficulty-us-english", input: { /* ... */ } })

// 5. settle: the call is charged when it finishes, nothing to do

Not connected yet? Point your MCP client at https://mcp.eden-engine.com/mcp, then copy a config for your client.

Pricing

Every charge this tool can incur.

Charge	Price
Base price Charged once per request	$0.0164
Per result Charged for every result returned	$0.000164

Updated: Oct 15, 2026

Input and output schemas

Input schema

input_schema.json

{
  "type": "object",
  "required": [
    "keywords",
    "location_code",
    "language_code"
  ],
  "properties": {
    "keywords": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[^,]*$",
        "maxLength": 80,
        "minLength": 1
      },
      "maxItems": 1000,
      "minItems": 1,
      "description": "The keywords to score, each up to 80 characters. Maximum 1000 items. An item cannot contain a comma."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "description": "The search language; only \"en\" (English) is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "description": "The search market; only 2840 (the United States) is offered."
    }
  },
  "additionalProperties": false
}

Output schema

output_schema.json

{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "keyword": {
                  "type": "string",
                  "description": "The keyword, as scored."
                },
                "keyword_difficulty": {
                  "type": "number",
                  "description": "How hard it is to rank in the top organic results for the keyword, from 0 to 100; higher is harder."
                }
              }
            },
            "description": "One entry per keyword."
          },
          "items_count": {
            "type": "number",
            "description": "The number of entries in items."
          },
          "total_count": {
            "type": "number",
            "description": "How many keywords were scored."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}