About this endpoint
What it does
Audits one web page for visibility to AI assistants and AI search (GEO) and returns a GEO score and grade, five category scores with their individual checks, and a prioritized fix list.
Query Parameter(s)
| Parameter | Type | Description |
|---|---|---|
| url | String | Required. The page to audit. A full URL with https:// is recommended; a bare host such as example.com is treated as https://example.com. |
Response
Returns a JSON object with url, geo_score, geo_grade, categories, priorities, checks_total, checks_passed and timestamp. Each category holds a score and a checks array; each priority is one fix.
| Parameter | Type | Description |
|---|---|---|
| url | String | The audited URL, normalized (for example https://example.com when example.com was sent). |
| geo_score | Number | Overall GEO score. Range: 0 to 100. |
| geo_grade | String | Letter grade for geo_score, for example B, C, D, F. |
| categories | Object | Scores per category: crawl_access, structured_data, content_structure, entity_clarity, freshness_signals. |
| categories.crawl_access | Object | Can AI crawlers reach the page. Checks: robot_gptbot, robot_claudebot, robot_google-extended, robot_perplexitybot, llms_txt, ssr_content. |
| categories.structured_data | Object | Machine-readable markup. Checks: jsonld_present, org_schema, faq_howto_schema, author_schema, sameas_refs. |
| categories.content_structure | Object | How easy the content is to extract. Checks: heading_hierarchy, tldr_summary, structured_lists, section_length, descriptive_anchors, table_markup, code_blocks. |
| categories.entity_clarity | Object | Whether it is clear who or what the page is about. Checks: brand_consistency, entity_refs, about_page, author_bio. |
| categories.freshness_signals | Object | Whether the page shows it is current. Checks: date_modified, last_modified_header, copyright_year, recent_dates. |
| categories.<category>.score | Number | Category score. Range: 0 to 100. |
| categories.<category>.checks | Object Array | The checks behind the category score. |
| categories.<category>.checks[].name | String | Machine name of the check (see the lists above). |
| categories.<category>.checks[].status | ENUM | Allowed values: pass, warning, fail, info. info checks are informational. |
| categories.<category>.checks[].score | Integer | Points the check earned. Range: 0 to 100. |
| categories.<category>.checks[].detail | String | What the check found, in one line. |
| categories.<category>.checks[].recommendation | String | What to change to pass. Absent or null when there is nothing to fix. |
| priorities | Object Array | Fix list, most important first. |
| priorities[].severity | ENUM | Allowed values: high, medium, low. |
| priorities[].category | ENUM | Category the fix belongs to. Allowed values: crawl_access, structured_data, content_structure, entity_clarity, freshness_signals. |
| priorities[].check | String | Name of the check that raised it. |
| priorities[].issue | String | The problem, in a short phrase. |
| priorities[].fix | String | The change to make. |
| priorities[].plain_english | String | Why it matters, for a non-specialist. |
| priorities[].who_fixes_it | String | Who usually makes the fix, for example content or developer. |
| checks_total | Integer | Number of checks run (26 in every test). |
| checks_passed | Integer | Number of checks with status pass. |
| timestamp | String | When the audit ran (ISO 8601, UTC). |
Notes
- If the page can't be audited, the API returns
422with adetailmessage and no score. This happens when the site refuses the audit server (many sites block cloud servers), the URL returns an HTTP error such as404or500, or the host doesn't resolve ("reason": "dns"). - A request without
urlreturns422with"msg": "Field required". - Most audits take about 0.5–2 seconds.


