{"slug": "competitor-keywords-api-let-an-agent-pull-the-list", "title": "Competitor keywords API: let an agent pull the list", "summary": "SEOGEoAEO.ai has exposed its Competitor Keywords tool over both REST and MCP, letting agents in Claude Code, Cursor or Codex pull a rival domain's ranking keywords at 35 credits per run. The tool returns up to 100 keywords per call across 20 supported markets, ordered by estimated traffic, with a maxCredits cap that triggers a max_credits_exceeded error and an idempotencyKey to prevent double charges on retries. Credits start at $29 for 2,000 on a monthly plan, and runs that hit a 502 or 503 or target a site the provider has no record of are refunded.", "body_md": "If you want a competitor keywords API that a coding agent can call, the useful properties are a clear price per call, a hard cap the agent can set, and output structured enough to sort without scraping. seogeoaeo.ai exposes its Competitor Keywords tool over both REST and MCP with those three things, so an agent in Claude Code, Cursor or Codex can pull a rival's ranking keywords and hand you a shortlist.\n\n## What one call returns\n\nYou send a domain, or any URL on it, and an optional market code. The tool looks up the whole domain in Google data for that country and returns up to 100 keywords, ordered by estimated traffic. Each row carries:\n\n- keyword and the ranking URL\n- position\n- monthly search volume\n- difficulty\n- search intent\n- cost per click\n- estimated visits\n\nOn top of the rows it adds two derived lists and a page summary: blog topics (informational, difficulty 50 or less, at least 10 searches a month, competitor's own name excluded), keywords worth bidding on (commercial or buying searches with a CPC), and the pages bringing the site the most visits.\n\nSupported markets are us, gb, ca, au, ie, in, sg, nz, za, de, fr, es, it, nl, se, pl, br, mx, jp and ae.\n\n## The REST call\n\n```\ncurl -X POST https://seogeoaeo.ai/api/v1/tools/competitor-keywords/runs \\\n  -H \"Authorization: Bearer $SEOGEOAEO_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"input\":{\"url\":\"https://rival.example\",\"market\":\"gb\"},\"maxCredits\":35}'\n```\n\n`maxCredits` makes the server refuse the run if the price is above what you set, with a `max_credits_exceeded` error. Add an `idempotencyKey` and a retry after a timeout will not charge you twice. The full reference is in [llms-full.txt](https://seogeoaeo.ai/llms-full.txt).\n\n## The MCP route\n\nPoint your MCP client at `https://seogeoaeo.ai/api/mcp` with a workspace API key. The tool name is the slug, `competitor-keywords`, and it accepts the same `url`, `market`, `maxCredits` and `idempotencyKey` arguments. Agent runs cost the same as runs from the browser.\n\nA prompt that works well:\n\nRun competitor-keywords on rival.example for the US market with maxCredits 35. Drop brand searches. Return keywords where the rival ranks 8 to 20, grouped by ranking URL.\n\n## Cost and failure rules\n\n| Case | Charge | \n|---|---|\n| Normal run | 35 credits, shown before it starts | \n| Site found but no rankings | Charged; the report says nothing was found | \n| Provider has no record of the site | Refunded | \n| Run ends in a 502 or 503 | Refunded | \n\nCredits come from a monthly plan, starting at $29 for 2,000. Monthly credits reset at renewal; top-ups bought on an active plan never expire. Details on [the seogeoaeo.ai plans page](https://seogeoaeo.ai/pricing).\n\n## Limits to code around\n\n- **Whole domain only.** A URL is accepted as input, but the lookup is for the domain. Filter by ranking URL yourself if you care about one folder.\n- **One country per call.** Loop over markets if the rival sells in several, and keep the market in your output so numbers from different countries never get mixed.\n- **Estimates.** Volume, difficulty and visits come from a search data provider, not Google. Compare within one result set; do not diff totals against another vendor's API.\n- **No ad bids.** It does not return keywords a competitor bids on in Google Ads. Google does not publish them.\n- **No history.** Each call is a snapshot. It is not a rank tracker; if you need daily positions for your own site over months, a product with rank tracking, such as Semrush Position Tracking, fits that better. You can still store snapshots yourself and diff them month to month.\n\n## Chaining it\n\nTwo neighbours make the call more useful in an agent loop. Competitor Finder (38 credits) returns the 30 sites sharing the most Google keywords with a domain, so the agent can pick which rivals to look up instead of guessing. Keyword Metrics (33 credits) takes up to 100 keywords you already have and returns volume, difficulty, CPC and yearly trend, which is handy for re-checking a shortlist built from several competitors.\n\nA full loop for three rivals costs about 38 + 3 × 35 = 143 credits, and with `maxCredits` on each call the agent cannot overspend.", "url": "https://wpnews.pro/news/competitor-keywords-api-let-an-agent-pull-the-list", "canonical_source": "https://usageatlas.com/guides/other/competitor-keywords-api-for-agents", "published_at": "2026-10-26 05:09:22+00:00", "updated_at": "2026-10-26 07:41:37.298388+00:00", "lang": "en", "topics": ["ai-agents", "agent-protocols", "ai-tools", "developer-tools"], "entities": ["SEOGEoAEO.ai", "Claude Code", "Cursor", "Codex", "Semrush Position Tracking", "Google"], "also_reported_by": [], "alternates": {"html": "https://wpnews.pro/news/competitor-keywords-api-let-an-agent-pull-the-list", "markdown": "https://wpnews.pro/news/competitor-keywords-api-let-an-agent-pull-the-list.md", "text": "https://wpnews.pro/news/competitor-keywords-api-let-an-agent-pull-the-list.txt", "jsonld": "https://wpnews.pro/news/competitor-keywords-api-let-an-agent-pull-the-list.jsonld"}}