Docs · Reference
GEO / AI-Readiness Audit
GET /v1/url/geo-audit2 credits / requestcache 60 minHow ready a page is to be read, understood and cited by AI search engines and assistants (ChatGPT, Claude, Perplexity, Gemini, Copilot). Checks whether AI crawlers are allowed in robots.txt, llms.txt, server-rendered content, structured data, an answer-first intro, lists and tables, dates, authorship, canonical, indexability, page weight and HTTPS. Returns a 0-100 score, an A-F grade, every check with plain-English advice, and a per-crawler access map. Rule-based and repeatable (no AI guesswork). Respects robots.txt by default. Failed fetches are not charged.
Query parameters
urlstring · required | Public http(s) URL of the page to audit. |
respect_robotsboolean | Refuse URLs disallowed by the site's robots.txt. Default: true |
max_ageinteger | Accept a cached answer up to this many seconds old, billed at 50%. |
Response data fields
Example
curl "https://api.gridlode.com/v1/url/geo-audit?url=https%3A%2F%2Fexample.com%2F" \
-H "Authorization: Bearer $GRIDLODE_KEY"Try it without code on the GEO / AI-Readiness Audit API page.