About this endpoint
What it does
Audits up to 10 URLs in one request. Each result is the same full audit as the single-URL endpoint: score, grade, per-category checks and a prioritized fix list. Set cwv: true to include measured Core Web Vitals for every URL (slower).
Request Body
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| cwv | Boolean | No | Include measured Core Web Vitals for every URL. Default: false. Off by default because it is slower. |
| urls | String Array | Yes | The URLs to audit. Accepts 1 to 10 string values. |
| scoreboard | Boolean | No | Controls whether the audited sites are listed on the public scoreboard. true lists them on it, false keeps them off even when the key has opted in. If not set, they are listed only if the key has opted in (PUT /scoreboard/opt-in). |
Response
A JSON object; nested fields are written parent.child, and [] marks an array of objects.
| Field | Type | Description |
|---|---|---|
count | integer | Number of URLs in the request. |
results | array of object | One result per URL, in the order sent. |
results[].url | string | The URL that was checked, as you sent it. |
results[].audit | object | Per-category results; each category has a score and its checks. |
results[].audit.meta | object | Meta-tag checks: title, meta description, headings, canonical. |
results[].audit.meta.score | number | Category score, 0–100. |
results[].audit.meta.checks | array of object | Individual checks behind this category's score. |
results[].audit.meta.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
results[].audit.meta.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
results[].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). |
results[].audit.meta.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
results[].audit.meta.checks[].recommendation | string | What to change to pass the check; absent when it passed. |
results[].audit.technical | object | Technical SEO checks: HTTPS, robots, sitemap, structured data, links. |
results[].audit.technical.score | number | Category score, 0–100. |
results[].audit.technical.checks | array of object | Individual checks behind this category's score. |
results[].audit.technical.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
results[].audit.technical.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
results[].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). |
results[].audit.technical.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
results[].audit.technical.checks[].recommendation | string | What to change to pass the check; absent when it passed. |
results[].audit.social | object | Social-sharing checks: Open Graph and Twitter card tags. |
results[].audit.social.score | number | Category score, 0–100. |
results[].audit.social.checks | array of object | Individual checks behind this category's score. |
results[].audit.social.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
results[].audit.social.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
results[].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). |
results[].audit.social.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
results[].audit.social.checks[].recommendation | string | What to change to pass the check; absent when it passed. |
results[].audit.performance | object | Speed checks: response time, page size, render-blocking resources. |
results[].audit.performance.score | number | Category score, 0–100. |
results[].audit.performance.checks | array of object | Individual checks behind this category's score. |
results[].audit.performance.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
results[].audit.performance.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
results[].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). |
results[].audit.performance.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
results[].audit.performance.checks[].recommendation | string | What to change to pass the check; absent when it passed. |
results[].audit.accessibility | object | Basic accessibility checks: image alt text, language, ARIA. |
results[].audit.accessibility.score | number | Category score, 0–100. |
results[].audit.accessibility.checks | array of object | Individual checks behind this category's score. |
results[].audit.accessibility.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
results[].audit.accessibility.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
results[].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). |
results[].audit.accessibility.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
results[].grade | string | Letter grade from A+ to F. |
results[].score | number | Score, 0–100. |
results[].history | object | Change since the previous audit of this URL by anyone using the provider account (see the service notes). |
results[].history.first_audit | boolean | Per-category results; each category has a score and its checks. |
results[].history.audits_recorded | integer | How many audits of this URL are on record. |
results[].history.previous_audit_at | number | When the previous audit ran, as a Unix timestamp in seconds. |
results[].history.days_since_last | number | Days since the previous audit. |
results[].history.delta | object | Change since that previous audit. |
results[].history.delta.score | number | Overall score change, in points. |
results[].history.delta.grade_change | object | Grade change as old → new, or null if the grade is unchanged. |
results[].history.delta.categories | object | Score change per category, in points. |
results[].history.delta.categories.meta | number | Score change for this category, in points. |
results[].history.delta.categories.technical | number | Score change for this category, in points. |
results[].history.delta.categories.social | number | Score change for this category, in points. |
results[].history.delta.categories.performance | number | Score change for this category, in points. |
results[].history.delta.categories.accessibility | number | Score change for this category, in points. |
results[].history.message | string | Explanation in one sentence. |
results[].timings | object | How long each stage of the audit took, in milliseconds. |
results[].timings.fetch_ms | integer | Fetching the page. |
results[].timings.render_ms | integer | Rendering it in a browser (0 when not rendered). |
results[].timings.rendered | boolean | true when the page was rendered in a browser (for JavaScript-built pages). |
results[].timings.checks_ms | integer | Running the checks. |
results[].timings.robots_sitemap_ms | integer | Reading robots.txt and the sitemap. |
results[].timings.ai_readability_ms | integer | Computing the AI readability score. |
results[].timings.core_web_vitals_wait_ms | integer | Waiting for Core Web Vitals. |
results[].timings.total_ms | integer | Whole audit. |
results[].priorities | array of object | Fix list, most important first. |
results[].priorities[].severity | string | How much fixing it matters — high, medium or low. |
results[].priorities[].category | string | Category the issue belongs to (e.g. meta, technical, performance). |
results[].priorities[].issue | string | The problem found, in a short phrase. |
results[].priorities[].fix | string | The change to make. |
results[].priorities[].plain_english | string | Why it matters, in plain language for a non-specialist. |
results[].priorities[].who_fixes_it | string | Who usually makes the fix — e.g. content (copywriter/editor), developer, marketing. |
results[].response_code | integer | HTTP status the page returned. |
results[].response_time | string | Time the page took to respond, e.g. 0.06s. |
results[].ai_readability | object | AI readability score for this URL, 0–100. |
results[].ai_readability.url | string | The URL that was checked, as you sent it. |
results[].ai_readability.ai_readability_score | integer | AI readability score, 0–100. |
results[].ai_readability.ai_readability_grade | string | AI readability letter grade, A+ to F. |
results[].ai_readability.categories | object | Score per AI readability category, each with its checks. |
results[].ai_readability.categories.crawl_accessibility | object | Can AI crawlers fetch the page: server-rendered text, bot access, llms.txt, HTTPS, speed. |
results[].ai_readability.categories.crawl_accessibility.score | integer | Category score, 0–100. |
results[].ai_readability.categories.crawl_accessibility.max | integer | Most points this category can earn. |
results[].ai_readability.categories.crawl_accessibility.checks | array of object | Individual checks behind this category's score. |
results[].ai_readability.categories.crawl_accessibility.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
results[].ai_readability.categories.crawl_accessibility.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
results[].ai_readability.categories.crawl_accessibility.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
results[].ai_readability.categories.crawl_accessibility.checks[].max | integer | Most points this check can earn. |
results[].ai_readability.categories.crawl_accessibility.checks[].detail | string | What the check found, in one line. |
results[].ai_readability.categories.structural_markup | object | Does markup describe the content: headings, semantic HTML, structured data. |
results[].ai_readability.categories.structural_markup.score | integer | Category score, 0–100. |
results[].ai_readability.categories.structural_markup.max | integer | Most points this category can earn. |
results[].ai_readability.categories.structural_markup.checks | array of object | Individual checks behind this category's score. |
results[].ai_readability.categories.structural_markup.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
results[].ai_readability.categories.structural_markup.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
results[].ai_readability.categories.structural_markup.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
results[].ai_readability.categories.structural_markup.checks[].max | integer | Most points this check can earn. |
results[].ai_readability.categories.structural_markup.checks[].detail | string | What the check found, in one line. |
results[].ai_readability.categories.content_extractability | object | Can the main content be pulled out cleanly: text structure, readability, lists and tables. |
results[].ai_readability.categories.content_extractability.score | integer | Category score, 0–100. |
results[].ai_readability.categories.content_extractability.max | integer | Most points this category can earn. |
results[].ai_readability.categories.content_extractability.checks | array of object | Individual checks behind this category's score. |
results[].ai_readability.categories.content_extractability.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
results[].ai_readability.categories.content_extractability.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
results[].ai_readability.categories.content_extractability.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
results[].ai_readability.categories.content_extractability.checks[].max | integer | Most points this check can earn. |
results[].ai_readability.categories.content_extractability.checks[].detail | string | What the check found, in one line. |
results[].ai_readability.categories.ai_discoverability | object | Can AI tools find and cite the page: metadata, canonical, sitemap, freshness. |
results[].ai_readability.categories.ai_discoverability.score | integer | Category score, 0–100. |
results[].ai_readability.categories.ai_discoverability.max | integer | Most points this category can earn. |
results[].ai_readability.categories.ai_discoverability.checks | array of object | Individual checks behind this category's score. |
results[].ai_readability.categories.ai_discoverability.checks[].name | string | Machine name of the check (e.g. title, meta_description, h1). |
results[].ai_readability.categories.ai_discoverability.checks[].status | string | Result of the check — pass, warning, fail or info (informational, not scored). |
results[].ai_readability.categories.ai_discoverability.checks[].score | integer | Points this check earned (0–100 for audit checks; out of max where max is given). |
results[].ai_readability.categories.ai_discoverability.checks[].max | integer | Most points this check can earn. |
results[].ai_readability.categories.ai_discoverability.checks[].detail | string | What the check found, in one line. |
results[].ai_readability.recommendations | array of object | Fix list, most important first. |
results[].ai_readability.recommendations[].severity | string | How much fixing it matters — high, medium or low. |
results[].ai_readability.recommendations[].issue | string | The problem found, in a short phrase. |
results[].ai_readability.recommendations[].fix | string | The change to make. |
results[].ai_readability.recommendations[].plain_english | string | Why it matters, in plain language for a non-specialist. |
results[].ai_readability.recommendations[].who_fixes_it | string | Who usually makes the fix — e.g. content (copywriter/editor), developer, marketing. |
results[].html_truncated | boolean | true if the page was larger than the size limit and only the start was checked. |
results[].core_web_vitals | object | Measured Core Web Vitals from Google PageSpeed Insights; only with cwv=true. |
results[].core_web_vitals.status | string | Outcome of the measurement, e.g. ok. |
results[].core_web_vitals.hint | string | What to do about it. |
results[].core_web_vitals.lcp_ms | object | Largest Contentful Paint, in milliseconds (good under 2,500). |
results[].core_web_vitals.inp_ms | object | Interaction to Next Paint, in milliseconds (good under 200). |
results[].core_web_vitals.cls | object | Cumulative Layout Shift, unitless (good under 0.1). |
results[].core_web_vitals.fcp_ms | object | First Contentful Paint, in milliseconds. |
results[].core_web_vitals.ttfb_ms | object | Time to First Byte, in milliseconds. |
results[].core_web_vitals.checks | array | Individual checks behind this category's score. |