apyhub
Back
▣ VERIFICATION KIT · MEDIA KIT

Audit Webpage SEO API

What it does

URL Audit runs an SEO audit of one web page — 80+ checks across meta tags, technical SEO, social tags, performance and basic accessibility — and returns a 0–100 score, a letter grade, the checks behind each category, a prioritized fix list in plain English, and AI readability, SXO, AEO and AIO sub-scores.

Its one endpoint, Audit one URL, takes the page url. Add include=trackers,conversion for a tracker and pixel inventory and a conversion score, and cwv=true for measured Core Web Vitals (the first measurement of a URL adds about 10 seconds, then it is cached for 24 hours). Leave scoreboard unset or false unless you want the site listed on the provider's public scoreboard.

URL Audit is a good fit when you need a structured SEO check of a page before a launch, a campaign or a client review, without building your own crawler and checks.

GET
Audit one URL
https://api.eu.apyhub.com/seoscoreapi/audit-url

QUICKSTART

GUIDE

Quickstart

Audit a website URL by passing it as a query parameter.

curl -X GET "https://api.eu.apyhub.com/seoscoreapi/audit-url?url=https%3A%2F%2Fwww.wikipedia.org" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

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

{
  "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": 2,
    "rendered": false,
    "checks_ms": 134,
    "robots_sitemap_ms": 264,
    "ai_readability_ms": 210,
    "core_web_vitals_wait_ms": 1,
    "total_ms": 802
  },
  "sxo": {
    "sxo_score": 75,
    "sxo_grade": "B",
    "checks": [
      {
        "name": "page_speed",
        "status": "pass",
        "score": 5,
        "max": 5,
        "detail": "0.11s — excellent"
      },
      {
        "name": "mobile_viewport",
        "status": "warning",
        "score": 2,
        "max": 4,
        "detail": "Viewport present but missing width=device-width"
      }
    ],
    "summary": "Good experience with a few improvements that could boost engagement."
  },
  "aeo": {
    "aeo_score": 34,
    "aeo_grade": "F",
    "checks": [
      {
        "name": "faq_howto_schema",
        "status": "info",
        "score": 0,
        "max": 5,
        "detail": "No FAQ or HowTo schema — add for featured snippet eligibility"
      },
      {
        "name": "question_headings",
        "status": "info",
        "score": 0,
        "max": 4,
        "detail": "No question-phrased headings — structure content as Q&A for better answer targeting"
      }
    ],
    "summary": "Poor AEO coverage — add structured schema and reformat content for question-answer extraction."
  },
  "aio": {
    "aio_score": 54,
    "aio_grade": "D",
    "checks": [
      {
        "name": "ai_bot_access",
        "status": "pass",
        "score": 5,
        "max": 5,
        "detail": "All AI crawlers allowed: GPTBot, ClaudeBot, PerplexityBot"
      },
      {
        "name": "llms_txt",
        "status": "info",
        "score": 0,
        "max": 4,
        "detail": "No /llms.txt — add this file to guide AI systems about your content"
      }
    ],
    "summary": "Moderate AI optimisation — address bot access, freshness, and content structure."
  },
  "history": {
    "first_audit": true,
    "audits_recorded": 1,
    "message": "First audit recorded for this URL — deltas will appear on the next audit."
  }
}
TRY ITLIVE · 300 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.
The URL to audit (e.g., https://example.com)
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.
Comma-separated extras: `trackers` (tracker and pixel inventory) and `conversion` (conversion score). Each adds a few seconds.

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)

AttributeTypeMandatoryDescription
urlStringYesThe URL to audit (e.g., https://example.com)
includeStringNoComma-separated extras: trackers (tracker and pixel inventory) and conversion (conversion score). Each adds a few seconds.
cwvBooleanNoSet 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.
scoreboardBooleanNoPublic 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.

FieldTypeDescription
aeoobjectAnswer Engine Optimization: how well the page answers questions directly (FAQ, concise answers, question headings).
aeo.checksarray of objectIndividual checks behind this category's score.
aeo.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
aeo.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
aeo.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
aeo.checks[].maxintegerMost points this check can earn.
aeo.checks[].detailstringWhat the check found, in one line.
aeo.summarystringOne-line verdict for this sub-score.
aeo.aeo_gradestringAEO letter grade, A+ to F.
aeo.aeo_scoreintegerAEO score, 0–100.
aioobjectAI Overview optimization: how likely the page is to be cited in Google's AI Overviews.
aio.checksarray of objectIndividual checks behind this category's score.
aio.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
aio.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
aio.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
aio.checks[].maxintegerMost points this check can earn.
aio.checks[].detailstringWhat the check found, in one line.
aio.summarystringOne-line verdict for this sub-score.
aio.aio_gradestringAIO letter grade, A+ to F.
aio.aio_scoreintegerAIO score, 0–100.
sxoobjectSearch Experience Optimization: whether the page satisfies the visitor once they land (clarity, intent match, calls to action).
sxo.checksarray of objectIndividual checks behind this category's score.
sxo.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
sxo.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
sxo.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
sxo.checks[].maxintegerMost points this check can earn.
sxo.checks[].detailstringWhat the check found, in one line.
sxo.summarystringOne-line verdict for this sub-score.
sxo.sxo_gradestringSXO letter grade, A+ to F.
sxo.sxo_scoreintegerSXO score, 0–100.
urlstringThe URL that was checked, as you sent it.
auditobjectPer-category results; each category has a score and its checks.
audit.metaobjectMeta-tag checks: title, meta description, headings, canonical.
audit.meta.scorenumberCategory score, 0–100.
audit.meta.checksarray of objectIndividual checks behind this category's score.
audit.meta.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
audit.meta.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
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).
audit.meta.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
audit.meta.checks[].recommendationstringWhat to change to pass the check; absent when it passed.
audit.socialobjectSocial-sharing checks: Open Graph and Twitter card tags.
audit.social.scorenumberCategory score, 0–100.
audit.social.checksarray of objectIndividual checks behind this category's score.
audit.social.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
audit.social.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
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).
audit.social.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
audit.social.checks[].recommendationstringWhat to change to pass the check; absent when it passed.
audit.technicalobjectTechnical SEO checks: HTTPS, robots, sitemap, structured data, links.
audit.technical.scorenumberCategory score, 0–100.
audit.technical.checksarray of objectIndividual checks behind this category's score.
audit.technical.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
audit.technical.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
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).
audit.technical.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
audit.technical.checks[].recommendationstringWhat to change to pass the check; absent when it passed.
audit.performanceobjectSpeed checks: response time, page size, render-blocking resources.
audit.performance.scorenumberCategory score, 0–100.
audit.performance.checksarray of objectIndividual checks behind this category's score.
audit.performance.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
audit.performance.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
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).
audit.performance.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
audit.performance.checks[].recommendationstringWhat to change to pass the check; absent when it passed.
audit.accessibilityobjectBasic accessibility checks: image alt text, language, ARIA.
audit.accessibility.scorenumberCategory score, 0–100.
audit.accessibility.checksarray of objectIndividual checks behind this category's score.
audit.accessibility.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
audit.accessibility.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
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).
audit.accessibility.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
gradestringLetter grade from A+ to F.
scorenumberScore, 0–100.
historyobjectChange since the previous audit of this URL by anyone using the provider account (see the service notes).
history.deltaobjectChange since that previous audit.
history.delta.scorenumberOverall score change, in points.
history.delta.grade_changeobjectGrade change as old → new, or null if the grade is unchanged.
history.delta.categoriesobjectScore change per category, in points.
history.delta.categories.metanumberScore change for this category, in points.
history.delta.categories.technicalnumberScore change for this category, in points.
history.delta.categories.socialnumberScore change for this category, in points.
history.delta.categories.performancenumberScore change for this category, in points.
history.delta.categories.accessibilitynumberScore change for this category, in points.
history.first_auditbooleanPer-category results; each category has a score and its checks.
history.audits_recordedintegerHow many audits of this URL are on record.
history.days_since_lastnumberDays since the previous audit.
history.previous_audit_atnumberWhen the previous audit ran, as a Unix timestamp in seconds.
history.messagestringExplanation in one sentence.
timingsobjectHow long each stage of the audit took, in milliseconds.
timings.fetch_msintegerFetching the page.
timings.renderedbooleantrue when the page was rendered in a browser (for JavaScript-built pages).
timings.total_msintegerWhole audit.
timings.checks_msintegerRunning the checks.
timings.render_msintegerRendering it in a browser (0 when not rendered).
timings.ai_readability_msintegerComputing the AI readability score.
timings.robots_sitemap_msintegerReading robots.txt and the sitemap.
timings.core_web_vitals_wait_msintegerWaiting for Core Web Vitals.
prioritiesarray of objectFix list, most important first.
priorities[].fixstringThe change to make.
priorities[].issuestringThe problem found, in a short phrase.
priorities[].categorystringCategory the issue belongs to (e.g. meta, technical, performance).
priorities[].severitystringHow much fixing it matters — high, medium or low.
priorities[].who_fixes_itstringWho usually makes the fix — e.g. content (copywriter/editor), developer, marketing.
priorities[].plain_englishstringWhy it matters, in plain language for a non-specialist.
response_codeintegerHTTP status the page returned.
response_timestringTime the page took to respond, e.g. 0.06s.
ai_readabilityobjectAI readability sub-score: same fields as the AI Readability Score endpoint.
ai_readability.urlstringThe URL that was checked, as you sent it.
ai_readability.categoriesobjectScore per AI readability category, each with its checks.
ai_readability.categories.structural_markupobjectDoes markup describe the content: headings, semantic HTML, structured data.
ai_readability.categories.structural_markup.scoreintegerCategory score, 0–100.
ai_readability.categories.structural_markup.maxintegerMost points this category can earn.
ai_readability.categories.structural_markup.checksarray of objectIndividual checks behind this category's score.
ai_readability.categories.structural_markup.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
ai_readability.categories.structural_markup.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
ai_readability.categories.structural_markup.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
ai_readability.categories.structural_markup.checks[].maxintegerMost points this check can earn.
ai_readability.categories.structural_markup.checks[].detailstringWhat the check found, in one line.
ai_readability.categories.ai_discoverabilityobjectCan AI tools find and cite the page: metadata, canonical, sitemap, freshness.
ai_readability.categories.ai_discoverability.scoreintegerCategory score, 0–100.
ai_readability.categories.ai_discoverability.maxintegerMost points this category can earn.
ai_readability.categories.ai_discoverability.checksarray of objectIndividual checks behind this category's score.
ai_readability.categories.ai_discoverability.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
ai_readability.categories.ai_discoverability.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
ai_readability.categories.ai_discoverability.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
ai_readability.categories.ai_discoverability.checks[].maxintegerMost points this check can earn.
ai_readability.categories.ai_discoverability.checks[].detailstringWhat the check found, in one line.
ai_readability.categories.crawl_accessibilityobjectCan AI crawlers fetch the page: server-rendered text, bot access, llms.txt, HTTPS, speed.
ai_readability.categories.crawl_accessibility.scoreintegerCategory score, 0–100.
ai_readability.categories.crawl_accessibility.maxintegerMost points this category can earn.
ai_readability.categories.crawl_accessibility.checksarray of objectIndividual checks behind this category's score.
ai_readability.categories.crawl_accessibility.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
ai_readability.categories.crawl_accessibility.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
ai_readability.categories.crawl_accessibility.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
ai_readability.categories.crawl_accessibility.checks[].maxintegerMost points this check can earn.
ai_readability.categories.crawl_accessibility.checks[].detailstringWhat the check found, in one line.
ai_readability.categories.content_extractabilityobjectCan the main content be pulled out cleanly: text structure, readability, lists and tables.
ai_readability.categories.content_extractability.scoreintegerCategory score, 0–100.
ai_readability.categories.content_extractability.maxintegerMost points this category can earn.
ai_readability.categories.content_extractability.checksarray of objectIndividual checks behind this category's score.
ai_readability.categories.content_extractability.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
ai_readability.categories.content_extractability.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
ai_readability.categories.content_extractability.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
ai_readability.categories.content_extractability.checks[].maxintegerMost points this check can earn.
ai_readability.categories.content_extractability.checks[].detailstringWhat the check found, in one line.
ai_readability.recommendationsarray of objectFix list, most important first.
ai_readability.recommendations[].severitystringHow much fixing it matters — high, medium or low.
ai_readability.recommendations[].issuestringThe problem found, in a short phrase.
ai_readability.recommendations[].fixstringThe change to make.
ai_readability.recommendations[].plain_englishstringWhy it matters, in plain language for a non-specialist.
ai_readability.recommendations[].who_fixes_itstringWho usually makes the fix — e.g. content (copywriter/editor), developer, marketing.
ai_readability.ai_readability_gradestringAI readability letter grade, A+ to F.
ai_readability.ai_readability_scoreintegerAI readability score, 0–100.
html_truncatedbooleantrue if the page was larger than the size limit and only the start was checked.
core_web_vitalsobjectMeasured Core Web Vitals from Google PageSpeed Insights; only with cwv=true.
core_web_vitals.clsnumber | nullCumulative Layout Shift, unitless (good under 0.1).
core_web_vitals.hintstringWhat to do about it.
core_web_vitals.checksarray of objectIndividual checks behind this category's score.
core_web_vitals.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
core_web_vitals.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
core_web_vitals.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).
core_web_vitals.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
core_web_vitals.checks[].metricstringFull name of the Core Web Vitals metric (e.g. Largest Contentful Paint).
core_web_vitals.fcp_msnumber | nullFirst Contentful Paint, in milliseconds.
core_web_vitals.inp_msnumber | nullInteraction to Next Paint, in milliseconds (good under 200).
core_web_vitals.lcp_msnumber | nullLargest Contentful Paint, in milliseconds (good under 2,500).
core_web_vitals.statusstringOutcome of the measurement, e.g. ok.
core_web_vitals.ttfb_msnumber | nullTime to First Byte, in milliseconds.
core_web_vitals.sourcestringWhere the numbers come from — field (real Chrome users, CrUX) or lab (a simulated load).
core_web_vitals.strategystringDevice the measurement is for — mobile or desktop.
core_web_vitals._psi_overall_scorenumberGoogle PageSpeed Insights performance score, 0–1 (provider-internal; may change).
trackersobjectTracker and pixel inventory; only with include=trackers. Same fields as the Page Tracker Detector endpoint.
trackers.methodstringHow the page was loaded, e.g. browser (a real browser visit).
trackers.summaryobjectOne-line verdict for this sub-score.
trackers.summary.trackersintegerTracker and pixel inventory; only with include=trackers.
trackers.summary.by_categoryobjectNumber of trackers found per category (e.g. analytics, advertising).
trackers.summary.tracker_requestsintegerRequests made by trackers.
trackers.summary.tracker_bytesintegerBytes downloaded by trackers.
trackers.summary.page_requestsintegerAll requests the page made.
trackers.summary.third_party_requestsintegerRequests to other domains.
trackers.summary.consent_managerobjectConsent-management platform found, or null.
trackers.trackersarray of objectTracker and pixel inventory; only with include=trackers.
trackers.trackers[].idstringTracker identifier in the provider's catalogue.
trackers.trackers[].vendorstringCompany behind the tracker (e.g. Google, Meta).
trackers.trackers[].categorystringKind of tracker — e.g. analytics, advertising, session_replay, tag_manager.
trackers.trackers[].found_inarray of stringWhere it was found — e.g. network, html.
trackers.trackers[].injectedbooleantrue if another script (e.g. a tag manager) loaded it rather than the page itself.
trackers.trackers[].requestsintegerNetwork requests it made.
trackers.trackers[].transfer_bytesintegerBytes it downloaded.
trackers.trackers[].evidencearray of stringRequest URLs or script snippets that identified it.
trackers.trackers[].idsarray of stringAccount or property IDs seen for this tracker (e.g. a GA measurement ID).
trackers.consent_managersarrayConsent-management platforms found (cookie banners).
trackers.notesarray of stringCaveats about how to read the result.
conversionobjectConversion score for the page; only with include=conversion. Same fields as the Conversion Score endpoint.
conversion.scorenumberScore, 0–100.
conversion.gradestringLetter grade from A+ to F.
conversion.page_typestringPage type scored against — local_service, ecommerce, saas or general.
conversion.page_type_sourcestringdetected when the type was inferred from the page; otherwise it reflects the page_type you sent.
conversion.renderedbooleantrue when the page was rendered in a browser before scoring.
conversion.word_countintegerWords of visible text on the page.
conversion.categoriesobjectScore per conversion area, each with its checks.
conversion.categories.headlineobjectIs there one clear, specific headline with supporting copy.
conversion.categories.headline.scorenumberCategory score, 0–100.
conversion.categories.headline.weightnumberShare of the overall score this category carries, 0–1.
conversion.categories.headline.checksarray of objectIndividual checks behind this category's score.
conversion.categories.headline.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
conversion.categories.headline.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
conversion.categories.headline.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).
conversion.categories.headline.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
conversion.categories.ctaobjectCalls to action: how many, how clear, how early on the page.
conversion.categories.cta.scorenumberCategory score, 0–100.
conversion.categories.cta.weightnumberShare of the overall score this category carries, 0–1.
conversion.categories.cta.checksarray of objectIndividual checks behind this category's score.
conversion.categories.cta.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
conversion.categories.cta.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
conversion.categories.cta.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).
conversion.categories.cta.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
conversion.categories.trustobjectTrust signals: testimonials, ratings, credentials, guarantees, contact details.
conversion.categories.trust.scorenumberCategory score, 0–100.
conversion.categories.trust.weightnumberShare of the overall score this category carries, 0–1.
conversion.categories.trust.checksarray of objectIndividual checks behind this category's score.
conversion.categories.trust.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
conversion.categories.trust.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
conversion.categories.trust.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).
conversion.categories.trust.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
conversion.categories.formsobjectLead or contact forms on the page.
conversion.categories.forms.scoreobjectCategory score, 0–100.
conversion.categories.forms.weightintegerShare of the overall score this category carries, 0–1.
conversion.categories.forms.checksarrayIndividual checks behind this category's score.
conversion.categories.forms.not_scoredstringtrue when the category does not apply to this page and was left out of the score.
conversion.categories.objectionsobjectAnswers to buyer objections: pricing, process, FAQ, why-us.
conversion.categories.objections.scorenumberCategory score, 0–100.
conversion.categories.objections.weightnumberShare of the overall score this category carries, 0–1.
conversion.categories.objections.checksarray of objectIndividual checks behind this category's score.
conversion.categories.objections.checks[].namestringMachine name of the check (e.g. title, meta_description, h1).
conversion.categories.objections.checks[].statusstringResult of the check — pass, warning, fail or info (informational, not scored).
conversion.categories.objections.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).
conversion.categories.objections.checks[].scoreintegerPoints this check earned (0–100 for audit checks; out of max where max is given).
conversion.prioritiesarray of objectFix list, most important first.
conversion.priorities[].severitystringHow much fixing it matters — high, medium or low.
conversion.priorities[].categorystringCategory the issue belongs to (e.g. meta, technical, performance).
conversion.priorities[].issuestringThe problem found, in a short phrase.
conversion.priorities[].fixstringThe change to make.
conversion.priorities[].plain_englishstringWhy it matters, in plain language for a non-specialist.
conversion.priorities[].who_fixes_itstringWho usually makes the fix — e.g. content (copywriter/editor), developer, marketing.
conversion.signalsobjectWhat the page was found to contain, independent of scoring.
conversion.signals.h1stringThe page's H1 text.
conversion.signals.cta_countintegerCalls to action found.
conversion.signals.first_ctaobjectThe first call to action on the page.
conversion.signals.first_cta.labelstringHuman-readable name.
conversion.signals.first_cta.kindstringWhat kind of element it is — e.g. button, link, form, phone.
conversion.signals.first_cta.position_pctintegerHow far down the page it appears, as a percentage of page height.
conversion.signals.cta_labelsarray of stringVisible text of each call to action.
conversion.signals.phone_linksintegertel: phone links found.
conversion.signals.trustobjectTrust signals found (each true/false or a count).
conversion.signals.trust.testimonialsobjectTestimonials found.
conversion.signals.trust.ratingsobjectStar ratings or review scores found.
conversion.signals.trust.guaranteesobjectGuarantees or refund promises found.
conversion.signals.trust.contactobjectContact details (phone, address, email) found.
conversion.signals.trust.credentialsstringCertifications, awards or memberships mentioned.
conversion.signals.formsarrayForms found on the page.
conversion.signals.embedded_formsarrayForms embedded from other services (e.g. HubSpot, Typeform).
conversion.signals.objectionsobjectObjection-handling content found (each true/false).
conversion.signals.objections.faqobjectAn FAQ section is present.
conversion.signals.objections.pricingstringPricing is shown or explained.
conversion.signals.objections.why_usobjectA why-choose-us section is present.
conversion.signals.objections.processobjectHow it works / next steps are explained.
conversion.notesarray of stringCaveats about how to read the result.
▣ 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.