suggest_prompts

POST https://geondex.com/api/v1/prompts/suggest

• Cost: 1 credit
• MCP tool: suggest_prompts
• Auth: Authorization: Bearer gx_… (see Authentication)
• Try it: Open suggest_prompts in the playground

The questions real buyers put to AI engines in your domain's niche, grounded in your domain's own homepage (its services, products and location) and written in the site's own language — an agent guessing prompts from the domain name alone gets the niche wrong. Returns prompts ready to feed into check_visibility. 1 credit. If you already know the prompts, skip this and call check_visibility directly.

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 — Your site, e.g. ttsensei.com (no scheme). 3–253 characters
• count · integer · optional — How many prompts to return. Default 5. 1–10. Default 5

Example requestCopy Anchor Link

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

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
• language · string | null — The language your domain's homepage declares (its <html lang>, e.g. he-IL); prompts are written in it. null when the page declares none, in which case prompts follow the language of the page text.
• prompts · object[]
• prompts[].text · string — Feed this straight into check_visibility
• prompts[].intent · "commercial" | "comparison" | "informational" — What the buyer is trying to do. suggestKeywords defaults to informational.

Example responseCopy Anchor Link

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

{
  "summary": "3 prompts for ttsensei.com: \"best table tennis blade for beginners\", \"Butterfly Viscaria vs Timo Boll ALC\", \"how to choose table tennis rubber\".",
  "data": {
    "domain": "ttsensei.com",
    "language": "en",
    "prompts": [
      {
        "text": "best table tennis blade for beginners",
        "intent": "commercial"
      },
      {
        "text": "Butterfly Viscaria vs Timo Boll ALC",
        "intent": "comparison"
      },
      {
        "text": "how to choose table tennis rubber",
        "intent": "informational"
      }
    ]
  },
  "credits": {
    "charged": 1,
    "remaining": 487
  }
}

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.