About this endpoint
What it does
Runs a full SEO audit of one page: 80+ checks across meta tags, technical SEO, social tags, performance and accessibility basics, plus AI readability and SXO, AEO and AIO scores. Returns a 0-100 score, a letter grade and a prioritized fix list written in plain English.
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| url | String | Yes | The URL to audit (e.g., https://example.com) |
| include | String | No | Comma-separated extras: trackers (tracker and pixel inventory) and conversion (conversion score). Each adds a few seconds. |
| cwv | Boolean | No | Set cwv=true to include measured Core Web Vitals (LCP, INP, CLS, FCP, TTFB from Google PageSpeed Insights) in core_web_vitals. Off by default because the first measurement of a URL adds about 10 seconds (up to 25); it is then cached for 24 hours. Available on every plan, costs nothing extra and never changes the score. |
| scoreboard | Boolean | No | Public scoreboard listing. scoreboard=true lists this site on the provider's public scoreboard; scoreboard=false keeps it off. Leave unset or false unless you want the site listed publicly. |
Response
A JSON object; nested fields are written parent.child, and [] marks an array of objects.
| Field | Type | Description |
|---|---|---|
aeo | object | Answer Engine Optimization: how well the page answers questions directly (FAQ, concise answers, question headings). |
aeo.checks | array of object | Individual checks behind this category's score. |
aeo.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
aeo.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
aeo.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
aeo.checks[].max | integer | Most points this check can earn. |
aeo.checks[].detail | string | What the check found, in one line. |
aeo.summary | string | One-line verdict for this sub-score. |
aeo.aeo_grade | string | AEO letter grade, A+ to F. |
aeo.aeo_score | integer | AEO score, 0–100. |
aio | object | AI Overview optimization: how likely the page is to be cited in Google's AI Overviews. |
aio.checks | array of object | Individual checks behind this category's score. |
aio.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
aio.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
aio.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
aio.checks[].max | integer | Most points this check can earn. |
aio.checks[].detail | string | What the check found, in one line. |
aio.summary | string | One-line verdict for this sub-score. |
aio.aio_grade | string | AIO letter grade, A+ to F. |
aio.aio_score | integer | AIO score, 0–100. |
sxo | object | Search Experience Optimization: whether the page satisfies the visitor once they land (clarity, intent match, calls to action). |
sxo.checks | array of object | Individual checks behind this category's score. |
sxo.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
sxo.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
sxo.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
sxo.checks[].max | integer | Most points this check can earn. |
sxo.checks[].detail | string | What the check found, in one line. |
sxo.summary | string | One-line verdict for this sub-score. |
sxo.sxo_grade | string | SXO letter grade, A+ to F. |
sxo.sxo_score | integer | SXO score, 0–100. |
url | string | The URL that was checked, as you sent it. |
audit | object | Per-category results; each category has a score and its checks. |
audit.meta | object | Meta-tag checks: title, meta description, headings, canonical. |
audit.meta.score | number | Category score, 0–100. |
audit.meta.checks | array of object | Individual checks behind this category's score. |
audit.meta.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
audit.meta.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
audit.meta.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
audit.meta.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
audit.meta.checks[].recommendation | string | What to change to pass the check; absent when it passed. |
audit.social | object | Social-sharing checks: Open Graph and Twitter card tags. |
audit.social.score | number | Category score, 0–100. |
audit.social.checks | array of object | Individual checks behind this category's score. |
audit.social.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
audit.social.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
audit.social.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
audit.social.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
audit.social.checks[].recommendation | string | What to change to pass the check; absent when it passed. |
audit.technical | object | Technical SEO checks: HTTPS, robots, sitemap, structured data, links. |
audit.technical.score | number | Category score, 0–100. |
audit.technical.checks | array of object | Individual checks behind this category's score. |
audit.technical.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
audit.technical.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
audit.technical.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
audit.technical.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
audit.technical.checks[].recommendation | string | What to change to pass the check; absent when it passed. |
audit.performance | object | Speed checks: response time, page size, render-blocking resources. |
audit.performance.score | number | Category score, 0–100. |
audit.performance.checks | array of object | Individual checks behind this category's score. |
audit.performance.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
audit.performance.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
audit.performance.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
audit.performance.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
audit.performance.checks[].recommendation | string | What to change to pass the check; absent when it passed. |
audit.accessibility | object | Basic accessibility checks: image alt text, language, ARIA. |
audit.accessibility.score | number | Category score, 0–100. |
audit.accessibility.checks | array of object | Individual checks behind this category's score. |
audit.accessibility.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
audit.accessibility.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
audit.accessibility.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
audit.accessibility.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
grade | string | Letter grade from A+ to F. |
score | number | Score, 0–100. |
history | object | Change since the previous audit of this URL by anyone using the provider account (see the service notes). |
history.delta | object | Change since that previous audit. |
history.delta.score | number | Overall score change, in points. |
history.delta.grade_change | object | Grade change as old → new, or null if the grade is unchanged. |
history.delta.categories | object | Score change per category, in points. |
history.delta.categories.meta | number | Score change for this category, in points. |
history.delta.categories.technical | number | Score change for this category, in points. |
history.delta.categories.social | number | Score change for this category, in points. |
history.delta.categories.performance | number | Score change for this category, in points. |
history.delta.categories.accessibility | number | Score change for this category, in points. |
history.first_audit | boolean | Per-category results; each category has a score and its checks. |
history.audits_recorded | integer | How many audits of this URL are on record. |
history.days_since_last | number | Days since the previous audit. |
history.previous_audit_at | number | When the previous audit ran, as a Unix timestamp in seconds. |
history.message | string | Explanation in one sentence. |
timings | object | How long each stage of the audit took, in milliseconds. |
timings.fetch_ms | integer | Fetching the page. |
timings.rendered | boolean | true when the page was rendered in a browser (for JavaScript-built pages). |
timings.total_ms | integer | Whole audit. |
timings.checks_ms | integer | Running the checks. |
timings.render_ms | integer | Rendering it in a browser (0 when not rendered). |
timings.ai_readability_ms | integer | Computing the AI readability score. |
timings.robots_sitemap_ms | integer | Reading robots.txt and the sitemap. |
timings.core_web_vitals_wait_ms | integer | Waiting for Core Web Vitals. |
priorities | array of object | Fix list, most important first. |
priorities[].fix | string | The change to make. |
priorities[].issue | string | The problem found, in a short phrase. |
priorities[].category | string | Category the issue belongs to (e.g. meta, technical, performance). |
priorities[].severity | string | How much fixing it matters — high, medium or low. |
priorities[].who_fixes_it | string | Who usually makes the fix — e.g. content (copywriter/editor), developer, marketing. |
priorities[].plain_english | string | Why it matters, in plain language for a non-specialist. |
response_code | integer | HTTP status the page returned. |
response_time | string | Time the page took to respond, e.g. 0.06s. |
ai_readability | object | AI readability sub-score: same fields as the AI Readability Score endpoint. |
ai_readability.url | string | The URL that was checked, as you sent it. |
ai_readability.categories | object | Score per AI readability category, each with its checks. |
ai_readability.categories.structural_markup | object | Does markup describe the content: headings, semantic HTML, structured data. |
ai_readability.categories.structural_markup.score | integer | Category score, 0–100. |
ai_readability.categories.structural_markup.max | integer | Most points this category can earn. |
ai_readability.categories.structural_markup.checks | array of object | Individual checks behind this category's score. |
ai_readability.categories.structural_markup.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
ai_readability.categories.structural_markup.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
ai_readability.categories.structural_markup.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
ai_readability.categories.structural_markup.checks[].max | integer | Most points this check can earn. |
ai_readability.categories.structural_markup.checks[].detail | string | What the check found, in one line. |
ai_readability.categories.ai_discoverability | object | Can AI tools find and cite the page: metadata, canonical, sitemap, freshness. |
ai_readability.categories.ai_discoverability.score | integer | Category score, 0–100. |
ai_readability.categories.ai_discoverability.max | integer | Most points this category can earn. |
ai_readability.categories.ai_discoverability.checks | array of object | Individual checks behind this category's score. |
ai_readability.categories.ai_discoverability.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
ai_readability.categories.ai_discoverability.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
ai_readability.categories.ai_discoverability.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
ai_readability.categories.ai_discoverability.checks[].max | integer | Most points this check can earn. |
ai_readability.categories.ai_discoverability.checks[].detail | string | What the check found, in one line. |
ai_readability.categories.crawl_accessibility | object | Can AI crawlers fetch the page: server-rendered text, bot access, llms.txt, HTTPS, speed. |
ai_readability.categories.crawl_accessibility.score | integer | Category score, 0–100. |
ai_readability.categories.crawl_accessibility.max | integer | Most points this category can earn. |
ai_readability.categories.crawl_accessibility.checks | array of object | Individual checks behind this category's score. |
ai_readability.categories.crawl_accessibility.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
ai_readability.categories.crawl_accessibility.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
ai_readability.categories.crawl_accessibility.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
ai_readability.categories.crawl_accessibility.checks[].max | integer | Most points this check can earn. |
ai_readability.categories.crawl_accessibility.checks[].detail | string | What the check found, in one line. |
ai_readability.categories.content_extractability | object | Can the main content be pulled out cleanly: text structure, readability, lists and tables. |
ai_readability.categories.content_extractability.score | integer | Category score, 0–100. |
ai_readability.categories.content_extractability.max | integer | Most points this category can earn. |
ai_readability.categories.content_extractability.checks | array of object | Individual checks behind this category's score. |
ai_readability.categories.content_extractability.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
ai_readability.categories.content_extractability.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
ai_readability.categories.content_extractability.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
ai_readability.categories.content_extractability.checks[].max | integer | Most points this check can earn. |
ai_readability.categories.content_extractability.checks[].detail | string | What the check found, in one line. |
ai_readability.recommendations | array of object | Fix list, most important first. |
ai_readability.recommendations[].severity | string | How much fixing it matters — high, medium or low. |
ai_readability.recommendations[].issue | string | The problem found, in a short phrase. |
ai_readability.recommendations[].fix | string | The change to make. |
ai_readability.recommendations[].plain_english | string | Why it matters, in plain language for a non-specialist. |
ai_readability.recommendations[].who_fixes_it | string | Who usually makes the fix — e.g. content (copywriter/editor), developer, marketing. |
ai_readability.ai_readability_grade | string | AI readability letter grade, A+ to F. |
ai_readability.ai_readability_score | integer | AI readability score, 0–100. |
html_truncated | boolean | true if the page was larger than the size limit and only the start was checked. |
core_web_vitals | object | Measured Core Web Vitals from Google PageSpeed Insights; only with cwv=true. |
core_web_vitals.cls | number | null | Cumulative Layout Shift, unitless (good under 0.1). |
core_web_vitals.hint | string | What to do about it. |
core_web_vitals.checks | array of object | Individual checks behind this category's score. |
core_web_vitals.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
core_web_vitals.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
core_web_vitals.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
core_web_vitals.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
core_web_vitals.checks[].metric | string | Full name of the Core Web Vitals metric (e.g. Largest Contentful Paint). |
core_web_vitals.fcp_ms | number | null | First Contentful Paint, in milliseconds. |
core_web_vitals.inp_ms | number | null | Interaction to Next Paint, in milliseconds (good under 200). |
core_web_vitals.lcp_ms | number | null | Largest Contentful Paint, in milliseconds (good under 2,500). |
core_web_vitals.status | string | Outcome of the measurement, e.g. ok. |
core_web_vitals.ttfb_ms | number | null | Time to First Byte, in milliseconds. |
core_web_vitals.source | string | Where the numbers come from — field (real Chrome users, CrUX) or lab (a simulated load). |
core_web_vitals.strategy | string | Device the measurement is for — mobile or desktop. |
core_web_vitals._psi_overall_score | number | Google PageSpeed Insights performance score, 0–1 (provider-internal; may change). |
trackers | object | Tracker and pixel inventory; only with include=trackers. Same fields as the Page Tracker Detector endpoint. |
trackers.method | string | How the page was loaded, e.g. browser (a real browser visit). |
trackers.summary | object | One-line verdict for this sub-score. |
trackers.summary.trackers | integer | Tracker and pixel inventory; only with include=trackers. |
trackers.summary.by_category | object | Number of trackers found per category (e.g. analytics, advertising). |
trackers.summary.tracker_requests | integer | Requests made by trackers. |
trackers.summary.tracker_bytes | integer | Bytes downloaded by trackers. |
trackers.summary.page_requests | integer | All requests the page made. |
trackers.summary.third_party_requests | integer | Requests to other domains. |
trackers.summary.consent_manager | object | Consent-management platform found, or null. |
trackers.trackers | array of object | Tracker and pixel inventory; only with include=trackers. |
trackers.trackers[].id | string | Tracker identifier in the provider's catalogue. |
trackers.trackers[].vendor | string | Company behind the tracker (e.g. Google, Meta). |
trackers.trackers[].category | string | Kind of tracker — e.g. analytics, advertising, session_replay, tag_manager. |
trackers.trackers[].found_in | array of string | Where it was found — e.g. network, html. |
trackers.trackers[].injected | boolean | true if another script (e.g. a tag manager) loaded it rather than the page itself. |
trackers.trackers[].requests | integer | Network requests it made. |
trackers.trackers[].transfer_bytes | integer | Bytes it downloaded. |
trackers.trackers[].evidence | array of string | Request URLs or script snippets that identified it. |
trackers.trackers[].ids | array of string | Account or property IDs seen for this tracker (e.g. a GA measurement ID). |
trackers.consent_managers | array | Consent-management platforms found (cookie banners). |
trackers.notes | array of string | Caveats about how to read the result. |
conversion | object | Conversion score for the page; only with include=conversion. Same fields as the Conversion Score endpoint. |
conversion.score | number | Score, 0–100. |
conversion.grade | string | Letter grade from A+ to F. |
conversion.page_type | string | Page type scored against — local_service, ecommerce, saas or general. |
conversion.page_type_source | string | detected when the type was inferred from the page; otherwise it reflects the page_type you sent. |
conversion.rendered | boolean | true when the page was rendered in a browser before scoring. |
conversion.word_count | integer | Words of visible text on the page. |
conversion.categories | object | Score per conversion area, each with its checks. |
conversion.categories.headline | object | Is there one clear, specific headline with supporting copy. |
conversion.categories.headline.score | number | Category score, 0–100. |
conversion.categories.headline.weight | number | Share of the overall score this category carries, 0–1. |
conversion.categories.headline.checks | array of object | Individual checks behind this category's score. |
conversion.categories.headline.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
conversion.categories.headline.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
conversion.categories.headline.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
conversion.categories.headline.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
conversion.categories.cta | object | Calls to action: how many, how clear, how early on the page. |
conversion.categories.cta.score | number | Category score, 0–100. |
conversion.categories.cta.weight | number | Share of the overall score this category carries, 0–1. |
conversion.categories.cta.checks | array of object | Individual checks behind this category's score. |
conversion.categories.cta.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
conversion.categories.cta.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
conversion.categories.cta.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
conversion.categories.cta.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
conversion.categories.trust | object | Trust signals: testimonials, ratings, credentials, guarantees, contact details. |
conversion.categories.trust.score | number | Category score, 0–100. |
conversion.categories.trust.weight | number | Share of the overall score this category carries, 0–1. |
conversion.categories.trust.checks | array of object | Individual checks behind this category's score. |
conversion.categories.trust.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
conversion.categories.trust.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
conversion.categories.trust.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
conversion.categories.trust.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
conversion.categories.forms | object | Lead or contact forms on the page. |
conversion.categories.forms.score | object | Category score, 0–100. |
conversion.categories.forms.weight | integer | Share of the overall score this category carries, 0–1. |
conversion.categories.forms.checks | array | Individual checks behind this category's score. |
conversion.categories.forms.not_scored | string | true when the category does not apply to this page and was left out of the score. |
conversion.categories.objections | object | Answers to buyer objections: pricing, process, FAQ, why-us. |
conversion.categories.objections.score | number | Category score, 0–100. |
conversion.categories.objections.weight | number | Share of the overall score this category carries, 0–1. |
conversion.categories.objections.checks | array of object | Individual checks behind this category's score. |
conversion.categories.objections.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
conversion.categories.objections.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
conversion.categories.objections.checks[].value | object | What was measured — text, a number, a list or an object depending on the check (e.g. the page title, a word count, heading counts). |
conversion.categories.objections.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
conversion.priorities | array of object | Fix list, most important first. |
conversion.priorities[].severity | string | How much fixing it matters — high, medium or low. |
conversion.priorities[].category | string | Category the issue belongs to (e.g. meta, technical, performance). |
conversion.priorities[].issue | string | The problem found, in a short phrase. |
conversion.priorities[].fix | string | The change to make. |
conversion.priorities[].plain_english | string | Why it matters, in plain language for a non-specialist. |
conversion.priorities[].who_fixes_it | string | Who usually makes the fix — e.g. content (copywriter/editor), developer, marketing. |
conversion.signals | object | What the page was found to contain, independent of scoring. |
conversion.signals.h1 | string | The page's H1 text. |
conversion.signals.cta_count | integer | Calls to action found. |
conversion.signals.first_cta | object | The first call to action on the page. |
conversion.signals.first_cta.label | string | Human-readable name. |
conversion.signals.first_cta.kind | string | What kind of element it is — e.g. button, link, form, phone. |
conversion.signals.first_cta.position_pct | integer | How far down the page it appears, as a percentage of page height. |
conversion.signals.cta_labels | array of string | Visible text of each call to action. |
conversion.signals.phone_links | integer | tel: phone links found. |
conversion.signals.trust | object | Trust signals found (each true/false or a count). |
conversion.signals.trust.testimonials | object | Testimonials found. |
conversion.signals.trust.ratings | object | Star ratings or review scores found. |
conversion.signals.trust.guarantees | object | Guarantees or refund promises found. |
conversion.signals.trust.contact | object | Contact details (phone, address, email) found. |
conversion.signals.trust.credentials | string | Certifications, awards or memberships mentioned. |
conversion.signals.forms | array | Forms found on the page. |
conversion.signals.embedded_forms | array | Forms embedded from other services (e.g. HubSpot, Typeform). |
conversion.signals.objections | object | Objection-handling content found (each true/false). |
conversion.signals.objections.faq | object | An FAQ section is present. |
conversion.signals.objections.pricing | string | Pricing is shown or explained. |
conversion.signals.objections.why_us | object | A why-choose-us section is present. |
conversion.signals.objections.process | object | How it works / next steps are explained. |
conversion.notes | array of string | Caveats about how to read the result. |