{"openapi":"3.1.0","info":{"title":"ApexSEO GEO & AI-Crawler Audit API","version":"0.1.0","description":"Keyless live-site AI crawler (robots.txt / llms.txt), GEO/AEO readiness, JSON-LD entity citation completeness, and competitor benchmark API payable per call in Base USDC via x402 v2.","contact":{"name":"Keith S.","url":"https://kwizzlesurp.com","email":"kwizzlesurp10@gmail.com"},"license":{"name":"MIT","url":"https://github.com/kwizzlesurp10-ctrl/apexseo-geo-mcp/blob/main/LICENSE"}},"servers":[{"url":"https://apexseo-geo-mcp.vercel.app"}],"paths":{"/api/health":{"get":{"operationId":"geo_health","summary":"Service Health & Auth Readiness","description":"Free diagnostic check returning live service uptime, supported AI crawler matrix, x402 payment configuration (Base USDC payTo and CDP facilitator readiness), and SSRF protection status. Call this or geo_pricing first before running paid live-site audits.","responses":{"200":{"description":"Service Health & Auth Readiness JSON report","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"service":{"type":"string"},"version":{"type":"string"},"payTo":{"type":"string"},"network":{"type":"string"},"demoMode":{"type":"boolean"},"facilitatorAuthConfigured":{"type":"boolean"}},"required":["ok","service","payTo","network"]}}}}}}},"/api/pricing":{"get":{"operationId":"geo_pricing","summary":"Live x402 USDC Pricing & Tool Menu","description":"Free pricing manifest listing all ApexSEO GEO audit endpoints, Base Mainnet (eip155:8453) USDC prices ($0.01-$0.05), endpoint paths, and MCP Streamable HTTP connection details. Ideal sibling to geo_health before dispatching paid calls.","responses":{"200":{"description":"Live x402 USDC Pricing & Tool Menu JSON report","content":{"application/json":{"schema":{"type":"object","properties":{"currency":{"type":"string"},"network":{"type":"string"},"payTo":{"type":"string"},"endpoints":{"type":"array","items":{"type":"object"}}},"required":["currency","network","payTo","endpoints"]}}}}}}},"/api/audit/crawlers":{"post":{"operationId":"ai_crawler_audit","summary":"AI Crawler, robots.txt & llms.txt Audit ($0.01)","description":"Live-fetches a domain's /robots.txt, /llms.txt, /llms-full.txt, /sitemap.xml, and /.well-known/{x402,mcp,agent-card.json} files, returning a per-bot permission matrix (GPTBot, OAI-SearchBot, ChatGPT-User, ClaudeBot, PerplexityBot, Google-Extended, Bingbot, Applebot-Extended, CCBot), AI-crawler readiness score (0-100), and ICE fixes. Use geo_page_audit for HTML/TTFB signals or schema_citation_check for JSON-LD validation.","responses":{"200":{"description":"AI Crawler, robots.txt & llms.txt Audit ($0.01) JSON report","content":{"application/json":{"schema":{"type":"object","properties":{"origin":{"type":"string"},"robotsTxt":{"type":"object"},"llmsTxt":{"type":"object"},"sitemapXml":{"type":"object"},"wellKnown":{"type":"object"},"summary":{"type":"object"},"iceActionPlan":{"type":"array"}},"required":["origin","robotsTxt","llmsTxt","summary","iceActionPlan"]}}}},"402":{"description":"x402 Payment Required ($0.01 USDC on eip155:8453)"}},"x-payment-info":{"price":"$0.01","amountAtomic":"10000","currency":"USDC","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","scheme":"exact","payTo":"0x0d25A44f74868eCE53B305C97139CF4B62963410"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Public HTTPS/HTTP URL to audit live (e.g. https://example.com)."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://example.com"}}}}}},"/api/audit/page":{"post":{"operationId":"geo_page_audit","summary":"Live GEO / AEO & Technical SEO Page Audit ($0.02)","description":"Performs a comprehensive live technical + Generative Engine Optimization (GEO/AEO) audit of any URL: measures TTFB, redirect chain, X-Robots-Tag, meta robots, canonical/hreflang, compression & security headers, title/meta/OpenGraph, H1-H3 question-heading density, structured lists/tables, empty CSR-shell detection, image alt coverage, E-E-A-T trust signals, composite geoScore (0-100), and ApexSEO Elite ICE action plan. Pair with ai_crawler_audit for site-wide robots.txt/llms.txt or geo_competitor_compare for rival benchmarking.","responses":{"200":{"description":"Live GEO / AEO & Technical SEO Page Audit ($0.02) JSON report","content":{"application/json":{"schema":{"type":"object","properties":{"finalUrl":{"type":"string"},"fetch":{"type":"object"},"directives":{"type":"object"},"structure":{"type":"object"},"subscores":{"type":"object"},"geoScore":{"type":"number"},"grade":{"type":"string"},"iceActionPlan":{"type":"array"}},"required":["finalUrl","geoScore","grade","subscores","iceActionPlan"]}}}},"402":{"description":"x402 Payment Required ($0.02 USDC on eip155:8453)"}},"x-payment-info":{"price":"$0.02","amountAtomic":"20000","currency":"USDC","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","scheme":"exact","payTo":"0x0d25A44f74868eCE53B305C97139CF4B62963410"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Public HTTPS/HTTP URL to audit live (e.g. https://example.com)."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://example.com"}}}}}},"/api/audit/schema":{"post":{"operationId":"schema_citation_check","summary":"JSON-LD & AI Citation Entity Check ($0.01)","description":"Extracts and validates all embedded application/ld+json blocks (including @graph trees) on a live page, flags syntax errors and missing AI-citation properties for Organization, WebSite, SoftwareApplication, Product, Article, FAQPage, and WebPage entities, scores schema completeness (0-100), and outputs a ready-to-paste JSON-LD @graph patch customized from detected metadata.","responses":{"200":{"description":"JSON-LD & AI Citation Entity Check ($0.01) JSON report","content":{"application/json":{"schema":{"type":"object","properties":{"finalUrl":{"type":"string"},"jsonLdBlockCount":{"type":"number"},"parseErrors":{"type":"array"},"detectedTypes":{"type":"array"},"schemaScore":{"type":"number"},"citationReadiness":{"type":"string"},"recommendedJsonLdPatch":{"type":"object"},"iceActionPlan":{"type":"array"}},"required":["finalUrl","detectedTypes","schemaScore","recommendedJsonLdPatch"]}}}},"402":{"description":"x402 Payment Required ($0.01 USDC on eip155:8453)"}},"x-payment-info":{"price":"$0.01","amountAtomic":"10000","currency":"USDC","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","scheme":"exact","payTo":"0x0d25A44f74868eCE53B305C97139CF4B62963410"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"Public HTTPS/HTTP URL to audit live (e.g. https://example.com)."}},"required":["url"],"additionalProperties":false},"example":{"url":"https://example.com"}}}}}},"/api/audit/compare":{"post":{"operationId":"geo_competitor_compare","summary":"Live Head-to-Head Competitor GEO Benchmark ($0.05)","description":"Runs parallel live page GEO audits and AI-crawler (robots.txt / llms.txt) checks across your targetUrl and 1-3 competitorUrls, computing exact win/loss deltas across geoScore, AI-crawler readiness, TTFB speed, schema depth, question headings, and llms.txt coverage, plus a ranked ICE counter-strategy roadmap.","responses":{"200":{"description":"Live Head-to-Head Competitor GEO Benchmark ($0.05) JSON report","content":{"application/json":{"schema":{"type":"object","properties":{"target":{"type":"object"},"competitors":{"type":"array"},"deltasVsCompetitorBest":{"type":"object"},"gapsToClose":{"type":"array"},"advantagesToPress":{"type":"array"},"iceActionPlan":{"type":"array"}},"required":["target","competitors","deltasVsCompetitorBest","iceActionPlan"]}}}},"402":{"description":"x402 Payment Required ($0.05 USDC on eip155:8453)"}},"x-payment-info":{"price":"$0.05","amountAtomic":"50000","currency":"USDC","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","network":"eip155:8453","scheme":"exact","payTo":"0x0d25A44f74868eCE53B305C97139CF4B62963410"},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"targetUrl":{"type":"string","format":"uri","description":"Your target URL to benchmark."},"competitorUrls":{"type":"array","items":{"type":"string","format":"uri"},"minItems":1,"maxItems":3,"description":"1 to 3 competitor URLs for live head-to-head benchmarking."}},"required":["targetUrl","competitorUrls"],"additionalProperties":false},"example":{"targetUrl":"https://example.com","competitorUrls":["https://competitor-a.example"]}}}}}}}}