apyhub
Back
▣ MEDIA KIT

Batch Audit Webpage SEO API

What it does

Batch URL Audit runs the full SEO audit on up to 10 pages in one request and returns one complete result per page, in the order sent: a 0–100 score and letter grade, per-category checks, a prioritized fix list in plain English, and AI readability, SXO, AEO and AIO sub-scores.

Its one endpoint, Audit up to 10 URLs in one call, takes a urls array in the request body. Set cwv to true to add measured Core Web Vitals for every page (slower), and leave scoreboard unset or false unless you want the sites listed on the provider's public scoreboard.

Batch URL Audit is a good fit when you need to check a known set of pages — a site's key landing pages, a release's changed pages, a client portfolio — in one call instead of ten.

POST
Audit up to 10 URLs in one call
https://api.eu.apyhub.com/seoscoreapi/batch-audit-urls

QUICKSTART

GUIDE

Quickstart

Send up to 10 URLs to batch audit them in one request.

curl -X POST "https://api.eu.apyhub.com/seoscoreapi/batch-audit-urls" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.wikipedia.org","https://en.wikipedia.org/wiki/Main_Page"],"cwv":false,"scoreboard":false}'

What you'll get back

A real response to the request above, with every array cut to its first 2 items:

{
  "count": 2,
  "results": [
    {
      "url": "https://www.wikipedia.org",
      "score": 77.359,
      "grade": "B",
      "response_code": 200,
      "response_time": "0.11s",
      "html_truncated": false,
      "audit": {
        "meta": {
          "score": 76.75,
          "checks": [
            {
              "name": "title",
              "status": "warning",
              "value": "Wikipedia",
              "score": 50,
              "recommendation": "Title is short (9 chars). Aim for 50-60 characters."
            },
            {
              "name": "meta_description",
              "status": "pass",
              "value": "Wikipedia is a free online encyclopedia, created and edited by volunteers around the world and hosted by the Wikimedia Foundation.",
              "score": 100
            }
          ]
        },
        "technical": {
          "score": 78.182,
          "checks": [
            {
              "name": "response_time",
              "status": "pass",
              "value": "0.11s",
              "score": 100
            },
            {
              "name": "https",
              "status": "pass",
              "value": true,
              "score": 100
            }
          ]
        },
        "social": {
          "score": 80.0,
          "checks": [
            {
              "name": "open_graph",
              "status": "pass",
              "value": {
                "og:title": "Wikipedia, the free encyclopedia",
                "og:description": "Wikipedia is a free online encyclopedia, created and edited by volunteers around the world and hosted by the Wikimedia Foundation.",
                "og:image": "https://upload.wikimedia.org/wikipedia/en/thumb/8/80/Wikipedia-logo-v2.svg/250px-Wikipedia-logo-v2.svg.png",
                "og:type": "website",
                "og:url": ""
              },
              "score": 100
            },
            {
              "name": "twitter_card",
              "status": "warning",
              "value": null,
              "score": 40,
              "recommendation": "Add Twitter Card meta tags"
            }
          ]
        },
        "performance": {
          "score": 82.5,
          "checks": [
            {
              "name": "html_size",
              "status": "warning",
              "value": "119.6 KB",
              "score": 60,
              "recommendation": "HTML is getting large. Consider reducing inline resources."
            },
            {
              "name": "dom_size",
              "status": "pass",
              "value": 1196,
              "score": 100
            }
          ]
        },
        "accessibility": {
          "score": 66.667,
          "checks": [
            {
              "name": "lang",
              "status": "pass",
              "value": "en",
              "score": 100
            },
            {
              "name": "image_alt_coverage",
              "status": "info",
              "value": "0%",
              "score": 0
            }
          ]
        }
      },
      "priorities": [
        {
          "severity": "medium",
          "category": "meta",
          "issue": "7 images missing alt text",
          "fix": "Add descriptive alt attributes to all images",
          "plain_english": "7 images have no text description, so screen readers and search engines can't tell what they show.",
          "who_fixes_it": "content"
        },
        {
          "severity": "medium",
          "category": "technical",
          "issue": "No canonical tag",
          "fix": "Add <link rel='canonical'> to specify the preferred URL",
          "plain_english": "The page doesn't say which address is the official one, so search engines may split its ranking across duplicates.",
          "who_fixes_it": "developer"
        }
      ],
      "ai_readability": {
        "url": "https://www.wikipedia.org",
        "ai_readability_score": 60,
        "ai_readability_grade": "C",
        "categories": {
          "crawl_accessibility": {
            "score": 18,
            "max": 25,
            "checks": [
              {
                "name": "ssr_content",
                "status": "pass",
                "score": 8,
                "max": 8,
                "detail": "Server-rendered content detected"
              },
              {
                "name": "ai_bot_access",
                "status": "pass",
                "score": 5,
                "max": 5,
                "detail": "All major AI bots allowed"
              }
            ]
          },
          "structural_markup": {
            "score": 11,
            "max": 25,
            "checks": [
              {
                "name": "schema_jsonld",
                "status": "warning",
                "score": 0,
                "max": 8,
                "detail": "No valid JSON-LD structured data"
              },
              {
                "name": "semantic_html",
                "status": "warning",
                "score": 2,
                "max": 5,
                "detail": "5 semantic elements, 112 divs (4% ratio)"
              }
            ]
          },
          "content_extractability": {
            "score": 22,
            "max": 30,
            "checks": [
              {
                "name": "answer_first",
                "status": "pass",
                "score": 5,
                "max": 6,
                "detail": "5/6 sections lead with facts"
              },
              {
                "name": "chunk_friendly",
                "status": "warning",
                "score": 3,
                "max": 6,
                "detail": "3/6 — sections sized for RAG chunking"
              }
            ]
          },
          "ai_discoverability": {
            "score": 9,
            "max": 20,
            "checks": [
              {
                "name": "open_graph",
                "status": "pass",
                "score": 4,
                "max": 4,
                "detail": "5/5 OG tags present"
              },
              {
                "name": "semantic_urls",
                "status": "pass",
                "score": 3,
                "max": 3,
                "detail": "/"
              }
            ]
          }
        },
        "recommendations": [
          {
            "severity": "high",
            "issue": "No Schema.org JSON-LD structured data",
            "fix": "Add JSON-LD markup (Article, WebPage, FAQPage, etc.) so AI systems can understand your content type and metadata",
            "plain_english": "The page has no machine-readable labels, so it can't earn rich results (stars, prices, FAQs) in search.",
            "who_fixes_it": "developer"
          },
          {
            "severity": "medium",
            "issue": "No canonical URL set",
            "fix": "Add a canonical tag to help AI systems identify the primary version of this page",
            "plain_english": "The page doesn't say which address is the official one, so search engines may split its ranking across duplicates.",
            "who_fixes_it": "developer"
          }
        ]
      },
      "core_web_vitals": {
        "status": "not_requested",
        "hint": "Add cwv=true to this request to include Core Web Vitals. The first measurement of a URL adds about 10 seconds; it is then cached for 24 hours.",
        "lcp_ms": null,
        "inp_ms": null,
        "cls": null,
        "fcp_ms": null,
        "ttfb_ms": null,
        "checks": []
      },
      "timings": {
        "fetch_ms": 110,
        "render_ms": 1,
        "rendered": false,
        "checks_ms": 62,
        "robots_sitemap_ms": 152,
        "ai_readability_ms": 181,
        "core_web_vitals_wait_ms": 1,
        "total_ms": 574
      },
      "history": {
        "first_audit": false,
        "audits_recorded": 2,
        "previous_audit_at": 1794896640.770488,
        "days_since_last": 0.0,
        "delta": {
          "score": 0.0,
          "grade_change": null,
          "categories": {
            "meta": 0.0,
            "technical": 0.0,
            "social": 0.0,
            "performance": 0.0,
            "accessibility": 0.0
          }
        }
      }
    },
    {
      "url": "https://en.wikipedia.org/wiki/Main_Page",
      "score": 78.958,
      "grade": "B",
      "response_code": 200,
      "response_time": "0.11s",
      "html_truncated": false,
      "audit": {
        "meta": {
          "score": 69.5,
          "checks": [
            {
              "name": "title",
              "status": "pass",
              "value": "Wikipedia, the free encyclopedia",
              "score": 100
            },
            {
              "name": "meta_description",
              "status": "fail",
              "value": null,
              "score": 0,
              "recommendation": "Add a meta description (150-160 chars)"
            }
          ]
        },
        "technical": {
          "score": 88.889,
          "checks": [
            {
              "name": "response_time",
              "status": "pass",
              "value": "0.11s",
              "score": 100
            },
            {
              "name": "https",
              "status": "pass",
              "value": true,
              "score": 100
            }
          ]
        },
        "social": {
          "score": 66.667,
          "checks": [
            {
              "name": "open_graph",
              "status": "warning",
              "value": {
                "og:title": "Wikipedia, the free encyclopedia",
                "og:description": null,
                "og:image": "https://thumb.wikimedia.org/wikipedia/commons/thumb/e/ef/Dividing_the_Light_at_dusk.jpg/1280px-Dividing_the_Light_at_dusk.jpg?utm_source=en.wikipedia.org&utm_campaign=index&utm_content=thumbnail",
                "og:type": "website",
                "og:url": null
              },
              "score": 60,
              "recommendation": "Some Open Graph tags missing. Add og:title, og:description, og:image, og:type, og:url."
            },
            {
              "name": "twitter_card",
              "status": "warning",
              "value": null,
              "score": 40,
              "recommendation": "Add Twitter Card meta tags"
            }
          ]
        },
        "performance": {
          "score": 80.0,
          "checks": [
            {
              "name": "html_size",
              "status": "warning",
              "value": "252.8 KB",
              "score": 60,
              "recommendation": "HTML is getting large. Consider reducing inline resources."
            },
            {
              "name": "dom_size",
              "status": "warning",
              "value": 2336,
              "score": 60,
              "recommendation": "DOM is getting complex. Simplify where possible."
            }
          ]
        },
        "accessibility": {
          "score": 93.0,
          "checks": [
            {
              "name": "lang",
              "status": "pass",
              "value": "en",
              "score": 100
            },
            {
              "name": "image_alt_coverage",
              "status": "info",
              "value": "79%",
              "score": 79
            }
          ]
        }
      },
      "priorities": [
        {
          "severity": "high",
          "category": "meta",
          "issue": "Missing meta description",
          "fix": "Add a meta description (150-160 chars)",
          "plain_english": "The page has no summary for search results, so Google picks a random snippet that may not make people click.",
          "who_fixes_it": "content"
        },
        {
          "severity": "high",
          "category": "technical",
          "issue": "Schema missing required fields",
          "fix": "Add required schema.org properties to make items eligible for Google rich results",
          "plain_english": "The page's machine-readable labels are missing required details, so it isn't eligible for rich results.",
          "who_fixes_it": "developer"
        }
      ],
      "ai_readability": {
        "url": "https://en.wikipedia.org/wiki/Main_Page",
        "ai_readability_score": 75,
        "ai_readability_grade": "B",
        "categories": {
          "crawl_accessibility": {
            "score": 21,
            "max": 25,
            "checks": [
              {
                "name": "ssr_content",
                "status": "pass",
                "score": 8,
                "max": 8,
                "detail": "Server-rendered content detected"
              },
              {
                "name": "ai_bot_access",
                "status": "pass",
                "score": 5,
                "max": 5,
                "detail": "All major AI bots allowed"
              }
            ]
          },
          "structural_markup": {
            "score": 17,
            "max": 25,
            "checks": [
              {
                "name": "schema_jsonld",
                "status": "pass",
                "score": 8,
                "max": 8,
                "detail": "Types: Article"
              },
              {
                "name": "semantic_html",
                "status": "warning",
                "score": 2,
                "max": 5,
                "detail": "14 semantic elements, 210 divs (6% ratio)"
              }
            ]
          },
          "content_extractability": {
            "score": 24,
            "max": 30,
            "checks": [
              {
                "name": "answer_first",
                "status": "pass",
                "score": 6,
                "max": 6,
                "detail": "6/6 sections lead with facts"
              },
              {
                "name": "chunk_friendly",
                "status": "pass",
                "score": 4,
                "max": 6,
                "detail": "4/6 — sections sized for RAG chunking"
              }
            ]
          },
          "ai_discoverability": {
            "score": 13,
            "max": 20,
            "checks": [
              {
                "name": "open_graph",
                "status": "warning",
                "score": 2,
                "max": 4,
                "detail": "3/5 OG tags present"
              },
              {
                "name": "semantic_urls",
                "status": "pass",
                "score": 3,
                "max": 3,
                "detail": "/wiki/Main_Page"
              }
            ]
          }
        },
        "recommendations": [
          {
            "severity": "medium",
            "issue": "Low semantic HTML usage",
            "fix": "Replace generic <div> elements with semantic tags (<article>, <section>, <main>, <nav>) to improve AI content parsing",
            "plain_english": "The page's code doesn't label its sections clearly, so AI tools struggle to separate content from menus.",
            "who_fixes_it": "developer"
          },
          {
            "severity": "medium",
            "issue": "Only 79% of images have alt text",
            "fix": "Add descriptive alt attributes to all images for AI content understanding",
            "plain_english": "Only 79% of the images have a text description, so screen readers and AI tools miss what the rest show.",
            "who_fixes_it": "content"
          }
        ]
      },
      "core_web_vitals": {
        "status": "not_requested",
        "hint": "Add cwv=true to this request to include Core Web Vitals. The first measurement of a URL adds about 10 seconds; it is then cached for 24 hours.",
        "lcp_ms": null,
        "inp_ms": null,
        "cls": null,
        "fcp_ms": null,
        "ttfb_ms": null,
        "checks": []
      },
      "timings": {
        "fetch_ms": 109,
        "render_ms": 2,
        "rendered": false,
        "checks_ms": 82,
        "robots_sitemap_ms": 75,
        "ai_readability_ms": 141,
        "core_web_vitals_wait_ms": 2,
        "total_ms": 474
      },
      "history": {
        "first_audit": false,
        "audits_recorded": 3,
        "previous_audit_at": 1794892590.9575255,
        "days_since_last": 0.05,
        "delta": {
          "score": 0.0,
          "grade_change": null,
          "categories": {
            "meta": 0.0,
            "technical": 0.0,
            "social": 0.0,
            "performance": 0.0,
            "accessibility": 0.0
          }
        }
      }
    }
  ]
}
TRY ITLIVE · 2000 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
The request body.
urls*
1–10 full page URLs to audit, including `https://`. Results come back in the same order.
`true` adds measured Core Web Vitals for every URL in `core_web_vitals`. Off by default because it is slower.
Public scoreboard listing. `true` lists these sites on the provider's public scoreboard; `false` keeps them off. Leave unset or `false` unless you want them listed publicly.

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

ParameterTypeMandatoryDescription
cwvBooleanNoInclude measured Core Web Vitals for every URL. Default: false. Off by default because it is slower.
urlsString ArrayYesThe URLs to audit. Accepts 1 to 10 string values.
scoreboardBooleanNoControls 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.

FieldTypeDescription
countintegerNumber of URLs in the request.
resultsarray of objectOne result per URL, in the order sent.
results[].urlstringThe URL that was checked, as you sent it.
results[].auditobjectPer-category results; each category has a score and its checks.
results[].audit.metaobjectMeta-tag checks: title, meta description, headings, canonical.
results[].audit.meta.scorenumberCategory score, 0–100.
results[].audit.meta.checksarray of objectIndividual checks behind this category's score.
results[].audit.meta.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
results[].audit.meta.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
results[].audit.meta.checks[].valueobjectWhat 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[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
results[].audit.meta.checks[].recommendationstringWhat to change to pass the check; absent when it passed.
results[].audit.technicalobjectTechnical SEO checks: HTTPS, robots, sitemap, structured data, links.
results[].audit.technical.scorenumberCategory score, 0–100.
results[].audit.technical.checksarray of objectIndividual checks behind this category's score.
results[].audit.technical.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
results[].audit.technical.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
results[].audit.technical.checks[].valueobjectWhat 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[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
results[].audit.technical.checks[].recommendationstringWhat to change to pass the check; absent when it passed.
results[].audit.socialobjectSocial-sharing checks: Open Graph and Twitter card tags.
results[].audit.social.scorenumberCategory score, 0–100.
results[].audit.social.checksarray of objectIndividual checks behind this category's score.
results[].audit.social.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
results[].audit.social.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
results[].audit.social.checks[].valueobjectWhat 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[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
results[].audit.social.checks[].recommendationstringWhat to change to pass the check; absent when it passed.
results[].audit.performanceobjectSpeed checks: response time, page size, render-blocking resources.
results[].audit.performance.scorenumberCategory score, 0–100.
results[].audit.performance.checksarray of objectIndividual checks behind this category's score.
results[].audit.performance.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
results[].audit.performance.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
results[].audit.performance.checks[].valueobjectWhat 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[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
results[].audit.performance.checks[].recommendationstringWhat to change to pass the check; absent when it passed.
results[].audit.accessibilityobjectBasic accessibility checks: image alt text, language, ARIA.
results[].audit.accessibility.scorenumberCategory score, 0–100.
results[].audit.accessibility.checksarray of objectIndividual checks behind this category's score.
results[].audit.accessibility.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
results[].audit.accessibility.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
results[].audit.accessibility.checks[].valueobjectWhat 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[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
results[].gradestringLetter grade from A+ to F.
results[].scorenumberScore, 0–100.
results[].historyobjectChange since the previous audit of this URL by anyone using the provider account (see the service notes).
results[].history.first_auditbooleanPer-category results; each category has a score and its checks.
results[].history.audits_recordedintegerHow many audits of this URL are on record.
results[].history.previous_audit_atnumberWhen the previous audit ran, as a Unix timestamp in seconds.
results[].history.days_since_lastnumberDays since the previous audit.
results[].history.deltaobjectChange since that previous audit.
results[].history.delta.scorenumberOverall score change, in points.
results[].history.delta.grade_changeobjectGrade change as old → new, or null if the grade is unchanged.
results[].history.delta.categoriesobjectScore change per category, in points.
results[].history.delta.categories.metanumberScore change for this category, in points.
results[].history.delta.categories.technicalnumberScore change for this category, in points.
results[].history.delta.categories.socialnumberScore change for this category, in points.
results[].history.delta.categories.performancenumberScore change for this category, in points.
results[].history.delta.categories.accessibilitynumberScore change for this category, in points.
results[].history.messagestringExplanation in one sentence.
results[].timingsobjectHow long each stage of the audit took, in milliseconds.
results[].timings.fetch_msintegerFetching the page.
results[].timings.render_msintegerRendering it in a browser (0 when not rendered).
results[].timings.renderedbooleantrue when the page was rendered in a browser (for JavaScript-built pages).
results[].timings.checks_msintegerRunning the checks.
results[].timings.robots_sitemap_msintegerReading robots.txt and the sitemap.
results[].timings.ai_readability_msintegerComputing the AI readability score.
results[].timings.core_web_vitals_wait_msintegerWaiting for Core Web Vitals.
results[].timings.total_msintegerWhole audit.
results[].prioritiesarray of objectFix list, most important first.
results[].priorities[].severitystringHow much fixing it matters — high, medium or low.
results[].priorities[].categorystringCategory the issue belongs to (e.g. meta, technical, performance).
results[].priorities[].issuestringThe problem found, in a short phrase.
results[].priorities[].fixstringThe change to make.
results[].priorities[].plain_englishstringWhy it matters, in plain language for a non-specialist.
results[].priorities[].who_fixes_itstringWho usually makes the fix — e.g. content (copywriter/editor), developer, marketing.
results[].response_codeintegerHTTP status the page returned.
results[].response_timestringTime the page took to respond, e.g. 0.06s.
results[].ai_readabilityobjectAI readability score for this URL, 0–100.
results[].ai_readability.urlstringThe URL that was checked, as you sent it.
results[].ai_readability.ai_readability_scoreintegerAI readability score, 0–100.
results[].ai_readability.ai_readability_gradestringAI readability letter grade, A+ to F.
results[].ai_readability.categoriesobjectScore per AI readability category, each with its checks.
results[].ai_readability.categories.crawl_accessibilityobjectCan AI crawlers fetch the page: server-rendered text, bot access, llms.txt, HTTPS, speed.
results[].ai_readability.categories.crawl_accessibility.scoreintegerCategory score, 0–100.
results[].ai_readability.categories.crawl_accessibility.maxintegerMost points this category can earn.
results[].ai_readability.categories.crawl_accessibility.checksarray of objectIndividual checks behind this category's score.
results[].ai_readability.categories.crawl_accessibility.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
results[].ai_readability.categories.crawl_accessibility.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
results[].ai_readability.categories.crawl_accessibility.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
results[].ai_readability.categories.crawl_accessibility.checks[].maxintegerMost points this check can earn.
results[].ai_readability.categories.crawl_accessibility.checks[].detailstringWhat the check found, in one line.
results[].ai_readability.categories.structural_markupobjectDoes markup describe the content: headings, semantic HTML, structured data.
results[].ai_readability.categories.structural_markup.scoreintegerCategory score, 0–100.
results[].ai_readability.categories.structural_markup.maxintegerMost points this category can earn.
results[].ai_readability.categories.structural_markup.checksarray of objectIndividual checks behind this category's score.
results[].ai_readability.categories.structural_markup.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
results[].ai_readability.categories.structural_markup.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
results[].ai_readability.categories.structural_markup.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
results[].ai_readability.categories.structural_markup.checks[].maxintegerMost points this check can earn.
results[].ai_readability.categories.structural_markup.checks[].detailstringWhat the check found, in one line.
results[].ai_readability.categories.content_extractabilityobjectCan the main content be pulled out cleanly: text structure, readability, lists and tables.
results[].ai_readability.categories.content_extractability.scoreintegerCategory score, 0–100.
results[].ai_readability.categories.content_extractability.maxintegerMost points this category can earn.
results[].ai_readability.categories.content_extractability.checksarray of objectIndividual checks behind this category's score.
results[].ai_readability.categories.content_extractability.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
results[].ai_readability.categories.content_extractability.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
results[].ai_readability.categories.content_extractability.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
results[].ai_readability.categories.content_extractability.checks[].maxintegerMost points this check can earn.
results[].ai_readability.categories.content_extractability.checks[].detailstringWhat the check found, in one line.
results[].ai_readability.categories.ai_discoverabilityobjectCan AI tools find and cite the page: metadata, canonical, sitemap, freshness.
results[].ai_readability.categories.ai_discoverability.scoreintegerCategory score, 0–100.
results[].ai_readability.categories.ai_discoverability.maxintegerMost points this category can earn.
results[].ai_readability.categories.ai_discoverability.checksarray of objectIndividual checks behind this category's score.
results[].ai_readability.categories.ai_discoverability.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
results[].ai_readability.categories.ai_discoverability.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
results[].ai_readability.categories.ai_discoverability.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
results[].ai_readability.categories.ai_discoverability.checks[].maxintegerMost points this check can earn.
results[].ai_readability.categories.ai_discoverability.checks[].detailstringWhat the check found, in one line.
results[].ai_readability.recommendationsarray of objectFix list, most important first.
results[].ai_readability.recommendations[].severitystringHow much fixing it matters — high, medium or low.
results[].ai_readability.recommendations[].issuestringThe problem found, in a short phrase.
results[].ai_readability.recommendations[].fixstringThe change to make.
results[].ai_readability.recommendations[].plain_englishstringWhy it matters, in plain language for a non-specialist.
results[].ai_readability.recommendations[].who_fixes_itstringWho usually makes the fix — e.g. content (copywriter/editor), developer, marketing.
results[].html_truncatedbooleantrue if the page was larger than the size limit and only the start was checked.
results[].core_web_vitalsobjectMeasured Core Web Vitals from Google PageSpeed Insights; only with cwv=true.
results[].core_web_vitals.statusstringOutcome of the measurement, e.g. ok.
results[].core_web_vitals.hintstringWhat to do about it.
results[].core_web_vitals.lcp_msobjectLargest Contentful Paint, in milliseconds (good under 2,500).
results[].core_web_vitals.inp_msobjectInteraction to Next Paint, in milliseconds (good under 200).
results[].core_web_vitals.clsobjectCumulative Layout Shift, unitless (good under 0.1).
results[].core_web_vitals.fcp_msobjectFirst Contentful Paint, in milliseconds.
results[].core_web_vitals.ttfb_msobjectTime to First Byte, in milliseconds.
results[].core_web_vitals.checksarrayIndividual checks behind this category's score.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.