{"openapi":"3.0.3","info":{"title":"Caelara Labs SEO & GEO Suite","description":"Technical SEO and generative-engine readiness: llms.txt auditing, AI crawler access, redirect chains, schema.org validation, SERP pixel previews, keyword n-grams, hreflang validation and broken link scanning.","version":"1.0.0","contact":{"email":"ops@caelaralabs.com","url":"https://caelaralabs.com"}},"servers":[{"url":"https://seo.caelaralabs.com"}],"components":{"securitySchemes":{"RapidAPIKey":{"type":"apiKey","in":"header","name":"X-RapidAPI-Proxy-Secret"},"CaelaraKey":{"type":"apiKey","in":"header","name":"X-Caelara-Key"},"x402USDC":{"type":"http","scheme":"bearer","description":"x402 USDC payment on Base network"}}},"paths":{"/health":{"get":{"summary":"Health check","responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/geo-readiness-composite":{"get":{"summary":"Generative-engine readiness score: llms.txt + AI crawler access + structured data + content clarity","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Page URL to assess","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.025","x-caelara-tier":"composite"}},"/v1/technical-seo-composite":{"get":{"summary":"Technical SEO audit: redirects, meta, canonical, headings, hreflang, schema, robots.txt with scored issues","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Page URL to audit","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.025","x-caelara-tier":"composite"}},"/v1/llms-txt-auditor":{"get":{"summary":"Fetch and audit /llms.txt (and llms-full.txt) against the llms.txt format","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Any URL on the target site","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/ai-bot-robots-check":{"get":{"summary":"Check whether GPTBot, PerplexityBot, Google-Extended and other AI crawlers are allowed by robots.txt","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"URL (path is evaluated against robots.txt)","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/redirect-chain-tracer":{"get":{"summary":"Trace a redirect chain hop by hop with loop detection and status issues","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Starting URL","schema":{"type":"string"}},{"name":"max_hops","in":"query","required":false,"description":"Max hops 1-10 (default 10)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/schema-org-validator":{"get":{"summary":"Extract and validate JSON-LD / microdata structured data on a page","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Page URL","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/serp-pixel-preview":{"get":{"summary":"Pixel-width SERP snippet preview with truncation for desktop and mobile","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"title","in":"query","required":true,"description":"Page title","schema":{"type":"string"}},{"name":"description","in":"query","required":false,"description":"Meta description","schema":{"type":"string"}},{"name":"url","in":"query","required":false,"description":"Display URL","schema":{"type":"string"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/keyword-ngrams-extractor":{"post":{"summary":"Extract top keyword unigrams, bigrams and trigrams with density","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"text":{"type":"string","description":"Text to analyze"},"max_n":{"type":"integer","description":"Largest n-gram size 1-3 (default 3)"},"top":{"type":"integer","description":"Results per n-gram size (default 15)"},"include_stopwords":{"type":"boolean","description":"Keep stopword-edged phrases"}},"required":["text"]}}}}}},"/v1/hreflang-validator":{"get":{"summary":"Validate hreflang annotations: codes, x-default, self-reference and optional return links","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Page URL","schema":{"type":"string"}},{"name":"check_return_links","in":"query","required":false,"description":"Verify reciprocal links on up to 5 alternates (true/false)","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}},"/v1/broken-link-scanner":{"get":{"summary":"Check outbound and internal links on a page for 4xx/5xx and dead hosts","security":[{"RapidAPIKey":[]},{"CaelaraKey":[]},{"x402USDC":[]}],"parameters":[{"name":"url","in":"query","required":true,"description":"Page URL","schema":{"type":"string"}},{"name":"max_links","in":"query","required":false,"description":"Max links to check 1-40 (default 25)","schema":{"type":"integer"}}],"responses":{"200":{"description":"Success (partial:true when upstream unavailable)","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"402":{"description":"Payment Required - x402 USDC on Base","headers":{"X-Payment-Required":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object"}}}}},"x-caelara-price-usdc":"0.005","x-caelara-tier":"atomic"}}}}