domain_overview

POST https://geondex.com/api/v1/domain-overview

• Cost: 3 credits
• MCP tool: domain_overview
• Auth: Authorization: Bearer gx_… (see Authentication)
• Try it: Open domain_overview in the playground

Organic Google footprint of your domain: how many keywords it ranks for, estimated monthly visits and what that traffic would cost as ads, how many rankings sit in the top 3/10/20/100, and how many are new, up, down or lost since the last update — measured estimates an agent cannot work out itself. Works on any domain. Default United States, English; set location and language to change that. 3 credits. Run it on a competitor to size it up, then ranked_keywords for the keywords behind the numbers and check_visibility on the best of them.

Not available on every deployment: returns 404 not_found when this server is not configured for it. GET /me lists what is configured.

RequestCopy Anchor Link

Request body (JSON)Copy Anchor Link

• domain · string · required — Any site, yours or a competitor's, e.g. ttsensei.com (no scheme). 3–253 characters
• location · string · optional — Country or city by name, e.g. United States, Germany, or London,England,United Kingdom. 2–100 characters. Default "United States"
• language · string · optional — Language by name, e.g. English, German. 2–50 characters. Default "English"

Example requestCopy Anchor Link

curl -s https://geondex.com/api/v1/domain-overview -H "Authorization: Bearer gx_YOUR_KEY" -H "content-type: application/json" -d '{"domain":"ttsensei.com"}'

ResponseCopy Anchor Link

200 with the envelope every tool returns: a one-line summary, the full data, and credits: { charged, remaining }. On a free call charged is 0 and remaining is null.

Fields of dataCopy Anchor Link

• domain · string
• found · boolean — false when no ranking data exists for this domain and location
• keywords · number — Keywords the domain ranks for in the top 100
• traffic · number — Estimated monthly organic visits
• trafficCost · number — What that traffic would cost as Google ads, USD per month
• positions · object — Keywords ranking in each band; each band includes those above it
• positions.top3 · number
• positions.top10 · number
• positions.top20 · number
• positions.top100 · number
• movement · object — Rankings new, up, down or lost since the previous data update
• movement.new · number
• movement.up · number
• movement.down · number
• movement.lost · number

Example responseCopy Anchor Link

Real-shaped, checked against the output schema by a test. Long lists are shortened.

{
  "summary": "ttsensei.com ranks for 318 keywords on Google in United States, ~2841 visits/mo; 139 in the top 10.",
  "data": {
    "domain": "ttsensei.com",
    "found": true,
    "keywords": 318,
    "traffic": 2841,
    "trafficCost": 1967.42,
    "positions": {
      "top3": 43,
      "top10": 139,
      "top20": 227,
      "top100": 318
    },
    "movement": {
      "new": 14,
      "up": 37,
      "down": 22,
      "lost": 9
    }
  },
  "credits": {
    "charged": 3,
    "remaining": 152
  }
}

ErrorsCopy Anchor Link

Every error has the body {"error":{"code":"…","message":"…"}} and is not charged.

Every error.code and what to do about it: Errors & rate limits.