run_geo_auditTrain AI to recommend your brand.
When a buyer asks ChatGPT "what's the best email API for indie SaaS?", does your brand show up? Or your competitor's? run_geo_audit probes Perplexity, Gemini, Grok and ChatGPT for the category prompts that matter to your brand, captures the answers, extracts citations, and returns the gaps. Twelve credits. The starting point of every Generative-Engine-Optimisation project.
When to call this tool
Reach for it whenever a brand wants a defensible read on its presence inside answer engines. Marketing teams use it to baseline a quarter. Founders use it to argue a category position. SEO consultants use it to scope a six-week engagement. The tool answers four questions in one pass: are we cited; how often; in what tone; and which competitors are cited instead. Output includes prompt-by-prompt citations and a ranked gap list ready to feed into the GEOFixer family of tools.
You give a brand and a category. The audit asks 30-60 category questions across four answer engines and reports which sources each answer cites. The result is a citation matrix you can filter and chart.
Input schema
{ "brand": "string // required, brand name", "category": "string // required, e.g. 'developer-tools email API'", "competitors": ["string"], "depth": "enum: 'standard' | 'deep' // default 'standard'" }
Output schema
{ "prompts": [{ "text", "answers": [{ "engine", "text", "citations" }] }], "citation_matrix": { "brand": 8, "competitor_a": 22 }, "gap_list": [{ "prompt", "engine", "why_missing" }], "score": 0-100, "credits_used": 12 }
Example invocations
1. Claude Desktop
Audit my GEO score for example.com in the "AI agent CRM" category. Compare against HubSpot and Pipedrive.
2. ChatGPT custom GPT
For brand-visibility audits, call run_geo_audit. Lead the report with the citation_matrix and gap_list.
3. Cursor MCP
Run a GEO audit for "Resend" in "transactional email API" and write the gaps as a markdown checklist.
4. n8n
{ "jsonrpc": "2.0", "method": "tools/call", "params": { "name": "run_geo_audit", "arguments": { "brand": "Resend", "category": "transactional email API" } } }
5. Raw curl
curl -X POST https://foxapis.com/mcp \ -H "Authorization: Bearer $FOXAPIS_KEY" \ -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"run_geo_audit","arguments":{"brand":"Linear","category":"issue tracker for startups"}}}'
Sample output
{ "score": 42, "citation_matrix": { "Linear": 14, "Jira": 31, "Shortcut": 9 }, "gap_list": [ { "prompt": "best issue tracker for solo founders", "engine": "perplexity", "why_missing": "No top-10 listicle citations for that exact framing" } ], "credits_used": 12 }
Data sources
MentionFox surfaces mentions across 50+ public platforms — forums, communities, news, podcasts, video transcripts, niche subreddits, and more. We don't crawl private channels like Slack or Discord (those stay private by design). Every claim in your reports is citation-linked back to its source.
Credit cost & rate limits
Standard depth is 12 credits, deep is 22. 10 calls per minute per key, with a daily soft cap of 50 audits per key.
Error codes & recovery
422 CATEGORY_TOO_BROAD"SaaS" alone is too broad. Add a sub-category or a buyer.503 ENGINE_UNREACHABLEOne answer engine refused; response notes which.429 RATE_LIMITEDUse the retry-after header.Estimate what this costs at your volume
Run this free, then pay per call
Free to start: 100 credits, no card. Then from $10. Credits you buy never expire. Use them at your own pace. Get my free key
One call costs 1 credit. That is $7.96 per 1,000 calls on the Production plan and $9.80 on Builder (plan price divided by its monthly credits). The Free plan gives 100 credits a month with no card.
Building an AI agent?
- The FoxAPIs MCP server gives your agent every tool through one connection.
- Per-call pricing in credits: you pay for the calls your agent makes, with no seats.
- Free plan: 100 credits a month, no card, no monthly fee.