backlinks

POST https://geondex.com/api/v1/backlinks

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

Backlink profile of a domain or page — total backlinks, referring domains, broken links, a 0–100 authority rank and a spam score. AI engines lean on well-linked sources, so compare yours with the domains check_visibility says are cited instead. 7 credits.

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

• target · string · required — A domain (ttsensei.com) or one page as a full URL with http(s):// (https://ttsensei.com/blades). 3–2,048 characters
• includeSubdomains · boolean · optional — Count links to subdomains (shop.ttsensei.com) as the target's. Default true. Default true

Example requestCopy Anchor Link

curl -s https://geondex.com/api/v1/backlinks -H "Authorization: Bearer gx_YOUR_KEY" -H "content-type: application/json" -d '{"target":"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

• target · string
• backlinks · number
• referringDomains · number — Linking domains; subdomains count separately
• referringMainDomains · number — Linking domains with subdomains folded into their main domain
• brokenBacklinks · number — Backlinks that point at a page returning an error
• rank · number — Authority rank of the target, 0-100
• spamScore · number — Spam score of the backlinks pointing at the target; higher is worse
• firstSeen · string | null — When the first backlink to the target was found, UTC, e.g. 2021-03-14 08:12:40 +00:00; null if never

Example responseCopy Anchor Link

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

{
  "summary": "ttsensei.com: 4821 backlinks from 356 referring domains (143 broken); rank 38/100, spam score 7.",
  "data": {
    "target": "ttsensei.com",
    "backlinks": 4821,
    "referringDomains": 356,
    "referringMainDomains": 311,
    "brokenBacklinks": 143,
    "rank": 38,
    "spamScore": 7,
    "firstSeen": "2021-03-14 08:12:40 +00:00"
  },
  "credits": {
    "charged": 7,
    "remaining": 153
  }
}

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.