Google Keyword Overview, United States English (One Keyword)
omnial/keyword-research-insights
Given one keyword, returns a Google keyword overview for the United States in English: average monthly search volume, each past month's searches (90 in testing) and the change over the last month, quarter and year; ad competition (0 to 1 and a level), cost per click and the top-of-page bid range; a keyword difficulty score; and the main and other search intents. With include_serp_info true it also returns the result types, result count and average backlink figures of the ranking pages.
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 search volume and ad metrics.
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/keyword-research-insights" })
// 3. learn: read the usage guide at runtime
omnial_learn({ tool: "omnial/keyword-research-insights" })
// 4. run: price the exact call first, then run it
omnial_execute({ tool: "omnial/keyword-research-insights", input: { /* see input_schema */ }, dry_run: true })
omnial_execute({ tool: "omnial/keyword-research-insights", 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": [
"keywords",
"location_code",
"language_code"
],
"properties": {
"keywords": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[^,]*$",
"maxLength": 80,
"minLength": 1
},
"maxItems": 1,
"minItems": 1,
"description": "The keyword to look up, as a one-item list; up to 80 characters and 10 words, with no 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."
},
"include_serp_info": {
"type": "boolean",
"default": false,
"description": "Whether to include the search results page figures (result count, result types and average backlink figures); the default is false."
},
"include_clickstream_data": {
"enum": [
false
],
"type": "boolean",
"default": false,
"description": "Clickstream metrics are not offered; only false, the default, is accepted."
}
},
"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 looked up."
},
"serp_info": {
"type": "object",
"properties": {
"serp_item_types": {
"type": "array",
"items": {
"type": "string"
},
"description": "The result types on the page, such as organic and ads."
},
"se_results_count": {
"type": "number",
"description": "The number of results."
},
"last_updated_time": {
"type": "string",
"description": "When the page data was last updated."
},
"previous_updated_time": {
"type": "string",
"description": "When the page data was updated before that."
}
},
"description": "The search results page. Returned when include_serp_info is true."
},
"keyword_info": {
"type": "object",
"properties": {
"cpc": {
"type": "number",
"description": "The average cost per click."
},
"competition": {
"type": "number",
"description": "Advertiser competition, from 0 to 1."
},
"search_volume": {
"type": "number",
"description": "The average monthly searches."
},
"monthly_searches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"year": {
"type": "number",
"description": "The year."
},
"month": {
"type": "number",
"description": "The month, 1 to 12."
},
"search_volume": {
"type": "number",
"description": "Searches that month."
}
}
},
"description": "Searches in each past month, newest first."
},
"competition_level": {
"type": "string",
"description": "The competition as a level."
},
"last_updated_time": {
"type": "string",
"description": "When the figures were last updated."
},
"low_top_of_page_bid": {
"type": "number",
"description": "The low end of the top-of-page ad bid range."
},
"search_volume_trend": {
"type": "object",
"properties": {
"yearly": {
"type": "number",
"description": "The percentage change over the last year."
},
"monthly": {
"type": "number",
"description": "The percentage change in volume over the last month."
},
"quarterly": {
"type": "number",
"description": "The percentage change over the last quarter."
}
},
"description": "The change in search volume."
},
"high_top_of_page_bid": {
"type": "number",
"description": "The high end of the top-of-page ad bid range."
}
},
"description": "Search volume and advertising metrics."
},
"avg_backlinks_info": {
"type": "object",
"properties": {
"rank": {
"type": "number",
"description": "Average rank."
},
"dofollow": {
"type": "number",
"description": "Average dofollow backlinks."
},
"backlinks": {
"type": "number",
"description": "Average backlinks."
},
"referring_pages": {
"type": "number",
"description": "Average referring pages."
},
"main_domain_rank": {
"type": "number",
"description": "Average rank of the main domain."
},
"last_updated_time": {
"type": "string",
"description": "When the figures were last updated."
},
"referring_domains": {
"type": "number",
"description": "Average referring domains."
},
"referring_main_domains": {
"type": "number",
"description": "Average referring root domains."
}
},
"description": "Average backlink figures of the pages that rank for the keyword. Returned when include_serp_info is true."
},
"keyword_properties": {
"type": "object",
"properties": {
"detected_language": {
"type": "string",
"description": "The detected language code."
},
"keyword_difficulty": {
"type": "number",
"description": "The keyword difficulty score."
},
"is_another_language": {
"type": "boolean",
"description": "Whether the keyword is in another language."
}
}
},
"search_intent_info": {
"type": "object",
"properties": {
"main_intent": {
"type": "string",
"description": "The main search intent, such as informational or transactional."
},
"foreign_intent": {
"type": "array",
"items": {
"type": "string"
},
"description": "Other intents of the keyword."
},
"last_updated_time": {
"type": "string",
"description": "When the intent was last updated."
}
},
"description": "What searchers of the keyword want."
}
}
},
"description": "One entry for the keyword sent."
},
"items_count": {
"type": "number",
"description": "The number of entries in items."
}
}
},
"description": "One result for the call."
}
},
"description": "The call's result, wrapped as results."
}