Skip to content
Eden Engine

Google Organic and Paid Ranking Overview of a Domain (US, English)

omnial/domain-google-ranking-overview-us-english

Given a domain, returns its Google search ranking overview for the United States in English, separately for organic and paid results: how many keywords it ranks for, how many rank at position 1, 2 to 3, 4 to 10 and each further band of ten up to 100, the estimated monthly traffic and what that traffic would cost as ads, and how many of its rankings are new, moved up, moved down or were lost since the previous update.

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 and keyword traffic 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/domain-google-ranking-overview-us-english" })

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

// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/domain-google-ranking-overview-us-english", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/domain-google-ranking-overview-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.

ChargePrice
Base price
Charged once per request
$0.0164
Per result
Charged for every result returned
$0.000164
Updated
Oct 14, 2026

Input and output schemas

Input schema
input_schema.json
{
  "type": "object",
  "required": [
    "target",
    "location_code",
    "language_code"
  ],
  "properties": {
    "limit": {
      "enum": [
        1,
        100
      ],
      "type": "integer",
      "default": 100,
      "description": "The most overview rows to return: 100 (the default) or 1. With one market and language there is one row."
    },
    "target": {
      "type": "string",
      "maxLength": 255,
      "minLength": 1,
      "description": "The domain to look up, without a scheme or www."
    },
    "language_code": {
      "enum": [
        "en"
      ],
      "type": "string",
      "default": "en",
      "description": "The search language; only en (English) is offered."
    },
    "location_code": {
      "enum": [
        2840
      ],
      "type": "integer",
      "default": 2840,
      "description": "The search market; only 2840 (the United States) is offered."
    },
    "ignore_synonyms": {
      "enum": [
        false
      ],
      "type": "boolean",
      "default": false,
      "description": "Whether very similar keywords are left out; only false, the default, 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": {
                "metrics": {
                  "type": "object",
                  "properties": {
                    "paid": {
                      "type": "object",
                      "properties": {
                        "etv": {
                          "type": "number"
                        },
                        "count": {
                          "type": "number"
                        },
                        "is_up": {
                          "type": "number"
                        },
                        "pos_1": {
                          "type": "number"
                        },
                        "is_new": {
                          "type": "number"
                        },
                        "is_down": {
                          "type": "number"
                        },
                        "is_lost": {
                          "type": "number"
                        },
                        "pos_2_3": {
                          "type": "number"
                        },
                        "pos_4_10": {
                          "type": "number"
                        },
                        "pos_11_20": {
                          "type": "number"
                        },
                        "pos_21_30": {
                          "type": "number"
                        },
                        "pos_31_40": {
                          "type": "number"
                        },
                        "pos_41_50": {
                          "type": "number"
                        },
                        "pos_51_60": {
                          "type": "number"
                        },
                        "pos_61_70": {
                          "type": "number"
                        },
                        "pos_71_80": {
                          "type": "number"
                        },
                        "pos_81_90": {
                          "type": "number"
                        },
                        "pos_91_100": {
                          "type": "number"
                        },
                        "estimated_paid_traffic_cost": {
                          "type": "number"
                        }
                      },
                      "description": "Figures for paid results, with the same fields as organic."
                    },
                    "organic": {
                      "type": "object",
                      "properties": {
                        "etv": {
                          "type": "number",
                          "description": "Estimated monthly traffic from these rankings."
                        },
                        "count": {
                          "type": "number",
                          "description": "How many keywords the domain ranks for."
                        },
                        "is_up": {
                          "type": "number",
                          "description": "Rankings that moved up since the previous update."
                        },
                        "pos_1": {
                          "type": "number",
                          "description": "Keywords ranking at position 1."
                        },
                        "is_new": {
                          "type": "number",
                          "description": "Rankings that are new since the previous update."
                        },
                        "is_down": {
                          "type": "number",
                          "description": "Rankings that moved down since the previous update."
                        },
                        "is_lost": {
                          "type": "number",
                          "description": "Rankings lost since the previous update."
                        },
                        "pos_2_3": {
                          "type": "number",
                          "description": "Keywords ranking at positions 2 to 3."
                        },
                        "pos_4_10": {
                          "type": "number",
                          "description": "Keywords ranking at positions 4 to 10."
                        },
                        "pos_11_20": {
                          "type": "number",
                          "description": "Positions 11 to 20."
                        },
                        "pos_21_30": {
                          "type": "number",
                          "description": "Positions 21 to 30."
                        },
                        "pos_31_40": {
                          "type": "number",
                          "description": "Positions 31 to 40."
                        },
                        "pos_41_50": {
                          "type": "number",
                          "description": "Positions 41 to 50."
                        },
                        "pos_51_60": {
                          "type": "number",
                          "description": "Positions 51 to 60."
                        },
                        "pos_61_70": {
                          "type": "number",
                          "description": "Positions 61 to 70."
                        },
                        "pos_71_80": {
                          "type": "number",
                          "description": "Positions 71 to 80."
                        },
                        "pos_81_90": {
                          "type": "number",
                          "description": "Positions 81 to 90."
                        },
                        "pos_91_100": {
                          "type": "number",
                          "description": "Positions 91 to 100."
                        },
                        "estimated_paid_traffic_cost": {
                          "type": "number",
                          "description": "Estimated cost of that traffic if bought as ads (USD)."
                        }
                      },
                      "description": "Figures for organic results."
                    }
                  },
                  "description": "The ranking figures, for organic and for paid results."
                }
              }
            },
            "description": "The overview rows; one for the market and language."
          },
          "target": {
            "type": "string",
            "description": "The domain, as sent."
          },
          "items_count": {
            "type": "number",
            "description": "The number of entries in items."
          },
          "total_count": {
            "type": "number",
            "description": "How many overview rows match."
          },
          "language_code": {
            "type": "string",
            "description": "The search language code, as sent."
          },
          "location_code": {
            "type": "number",
            "description": "The search market code, as sent."
          }
        }
      },
      "description": "One result for the call."
    }
  },
  "description": "The call's result, wrapped as results."
}