Google Rankings of a Domain's Subdomains (US, English)
omnial/domain-subdomain-rankings
Given a domain, returns how its subdomains rank on Google for the United States in English: how many subdomains match, plus 1 or 100 of them, each with organic and paid figures: 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, estimated monthly traffic, what that traffic would cost as ads, and how many 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-subdomain-rankings" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/domain-subdomain-rankings" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/domain-subdomain-rankings", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/domain-subdomain-rankings", input: { /* ... */ } })
// 5. settle: the call is charged when it finishes, nothing to doNot 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": [
"target",
"location_code",
"language_code"
],
"properties": {
"limit": {
"enum": [
1,
100
],
"type": "integer",
"default": 100,
"description": "The most subdomains to return: 100 (the default) or 1."
},
"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."
},
"include_clickstream_data": {
"enum": [
false
],
"type": "boolean",
"default": false,
"description": "Whether clickstream-based metrics are added; 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",
"description": "Estimated monthly traffic from paid rankings."
},
"count": {
"type": "number",
"description": "How many keywords rank in paid results."
},
"is_up": {
"type": "number",
"description": "Rankings that moved up since the previous update."
},
"pos_1": {
"type": "number",
"description": "Keywords ranking at positions 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 that were 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": "Keywords ranking at positions 11 to 20."
},
"pos_21_30": {
"type": "number",
"description": "Keywords ranking at positions 21 to 30."
},
"pos_31_40": {
"type": "number",
"description": "Keywords ranking at positions 31 to 40."
},
"pos_41_50": {
"type": "number",
"description": "Keywords ranking at positions 41 to 50."
},
"pos_51_60": {
"type": "number",
"description": "Keywords ranking at positions 51 to 60."
},
"pos_61_70": {
"type": "number",
"description": "Keywords ranking at positions 61 to 70."
},
"pos_71_80": {
"type": "number",
"description": "Keywords ranking at positions 71 to 80."
},
"pos_81_90": {
"type": "number",
"description": "Keywords ranking at positions 81 to 90."
},
"pos_91_100": {
"type": "number",
"description": "Keywords ranking at positions 91 to 100."
},
"estimated_paid_traffic_cost": {
"type": "number",
"description": "Estimated cost of that traffic if bought as ads (USD)."
}
}
},
"organic": {
"type": "object",
"properties": {
"etv": {
"type": "number",
"description": "Estimated monthly traffic from organic rankings."
},
"count": {
"type": "number",
"description": "How many keywords rank in organic results."
},
"is_up": {
"type": "number",
"description": "Rankings that moved up since the previous update."
},
"pos_1": {
"type": "number",
"description": "Keywords ranking at positions 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 that were 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": "Keywords ranking at positions 11 to 20."
},
"pos_21_30": {
"type": "number",
"description": "Keywords ranking at positions 21 to 30."
},
"pos_31_40": {
"type": "number",
"description": "Keywords ranking at positions 31 to 40."
},
"pos_41_50": {
"type": "number",
"description": "Keywords ranking at positions 41 to 50."
},
"pos_51_60": {
"type": "number",
"description": "Keywords ranking at positions 51 to 60."
},
"pos_61_70": {
"type": "number",
"description": "Keywords ranking at positions 61 to 70."
},
"pos_71_80": {
"type": "number",
"description": "Keywords ranking at positions 71 to 80."
},
"pos_81_90": {
"type": "number",
"description": "Keywords ranking at positions 81 to 90."
},
"pos_91_100": {
"type": "number",
"description": "Keywords ranking at positions 91 to 100."
},
"estimated_paid_traffic_cost": {
"type": "number",
"description": "Estimated cost of that traffic if bought as ads (USD)."
}
}
}
}
},
"subdomain": {
"type": "string",
"description": "The subdomain these figures describe."
}
}
}
},
"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 subdomains 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."
}