apyhub
Back
▣ RETRIEVAL KIT · MEDIA KIT

Audit Webpage AI Visibility API

What it does

The Audit Webpage AI Visibility API is a GEO audit API for single pages. Send a page url and get back a geo_score from 0 to 100, a letter geo_grade, five category scores and a ranked fix list. GEO means generative engine optimization: how easy a page is for AI assistants and AI search to find, read and cite.

The audit runs 26 checks in five categories. crawl_access checks whether robots.txt lets GPTBot, ClaudeBot, Google-Extended and PerplexityBot in, and looks for an llms.txt file and server-rendered content. structured_data looks for JSON-LD, Organization, FAQ and author schema. content_structure, entity_clarity and freshness_signals check headings, summaries, brand naming and update dates. Each item in priorities gives a severity, the fix, and whether content or a developer should make it.

Teams use this GEO audit API to check AI crawler access before a launch. They also review docs and blog posts for AI search, and track AI visibility across a site.

It audits public pages only. If the site blocks the audit server or the URL returns an error such as 404, you get a 422 and nothing is scored.

For a full SEO review of the same page, pair it with the Audit Webpage SEO API. Check image alt text with the Audit Webpage Images for SEO API, and structured data with the Evaluate SEO Health API.

GET
Audit: how visible a page is to AI assistants
https://api.eu.apyhub.com/seoscoreapi/audit-webpage-ai-visibility

QUICKSTART

GUIDE

Quickstart

Audit a page by passing its URL as the url query parameter.

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

What you'll get back

Returns a JSON object with url, geo_score, geo_grade, categories, priorities, checks_total, checks_passed and timestamp. A real response to the request above, with each array cut to its first 2 items:

{
  "url": "https://www.wikipedia.org",
  "geo_score": 57.0,
  "geo_grade": "D",
  "categories": {
    "crawl_access": {
      "score": 83.3,
      "checks": [
        { "name": "robot_gptbot", "status": "pass", "score": 100, "detail": "GPTBot allowed" },
        { "name": "robot_claudebot", "status": "pass", "score": 100, "detail": "ClaudeBot allowed" }
      ]
    },
    "structured_data": {
      "score": 10,
      "checks": [
        { "name": "jsonld_present", "status": "fail", "score": 0, "detail": "No JSON-LD structured data", "recommendation": "Add JSON-LD markup (Organization, Article, FAQPage, etc.)" },
        { "name": "org_schema", "status": "fail", "score": 0, "detail": "No Organization schema found", "recommendation": "Add Organization JSON-LD with name, url, and logo" }
      ]
    },
    "content_structure": {
      "score": 76.9,
      "checks": [
        { "name": "heading_hierarchy", "status": "pass", "score": 100, "detail": "Clean heading hierarchy" },
        { "name": "tldr_summary", "status": "warning", "score": 0, "detail": "No TL;DR, summary, or key takeaway section found", "recommendation": "Add a summary block in the first 200 words with a direct answer" }
      ]
    },
    "entity_clarity": {
      "score": 50,
      "checks": [
        { "name": "brand_consistency", "status": "pass", "score": 100, "detail": "'wikipedia' found in: title, h1, meta_description", "recommendation": null },
        { "name": "entity_refs", "status": "pass", "score": 100, "detail": "'wikipedia' referenced 21 times consistently" }
      ]
    },
    "freshness_signals": {
      "score": 50,
      "checks": [
        { "name": "date_modified", "status": "fail", "score": 0, "detail": "No dateModified in structured data", "recommendation": "Add dateModified to your JSON-LD schema" },
        { "name": "last_modified_header", "status": "pass", "score": 100, "detail": "Last-Modified: Tue, 10 Nov 2026 07:56:33 GMT" }
      ]
    }
  },
  "priorities": [
    {
      "severity": "high",
      "category": "structured_data",
      "check": "jsonld_present",
      "issue": "No JSON-LD structured data",
      "fix": "Add JSON-LD markup (Organization, Article, FAQPage, etc.)",
      "plain_english": "This affects how likely AI assistants are to find and cite the page.",
      "who_fixes_it": "content"
    },
    {
      "severity": "high",
      "category": "structured_data",
      "check": "org_schema",
      "issue": "No Organization schema found",
      "fix": "Add Organization JSON-LD with name, url, and logo",
      "plain_english": "This affects how likely AI assistants are to find and cite the page.",
      "who_fixes_it": "content"
    }
  ],
  "checks_total": 26,
  "checks_passed": 12,
  "timestamp": "2026-11-18T08:48:16.164257+00:00"
}
TRY ITLIVE · 400 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.
Required. The page to audit. A full URL with `https://` is recommended; a bare host such as `example.com` is treated as `https://example.com`.

About this endpoint

What it does

Audits one web page for visibility to AI assistants and AI search (GEO) and returns a GEO score and grade, five category scores with their individual checks, and a prioritized fix list.

Query Parameter(s)

ParameterTypeDescription
urlStringRequired. The page to audit. A full URL with https:// is recommended; a bare host such as example.com is treated as https://example.com.

Response

Returns a JSON object with url, geo_score, geo_grade, categories, priorities, checks_total, checks_passed and timestamp. Each category holds a score and a checks array; each priority is one fix.

ParameterTypeDescription
urlStringThe audited URL, normalized (for example https://example.com when example.com was sent).
geo_scoreNumberOverall GEO score. Range: 0 to 100.
geo_gradeStringLetter grade for geo_score, for example B, C, D, F.
categoriesObjectScores per category: crawl_access, structured_data, content_structure, entity_clarity, freshness_signals.
categories.crawl_accessObjectCan AI crawlers reach the page. Checks: robot_gptbot, robot_claudebot, robot_google-extended, robot_perplexitybot, llms_txt, ssr_content.
categories.structured_dataObjectMachine-readable markup. Checks: jsonld_present, org_schema, faq_howto_schema, author_schema, sameas_refs.
categories.content_structureObjectHow easy the content is to extract. Checks: heading_hierarchy, tldr_summary, structured_lists, section_length, descriptive_anchors, table_markup, code_blocks.
categories.entity_clarityObjectWhether it is clear who or what the page is about. Checks: brand_consistency, entity_refs, about_page, author_bio.
categories.freshness_signalsObjectWhether the page shows it is current. Checks: date_modified, last_modified_header, copyright_year, recent_dates.
categories.<category>.scoreNumberCategory score. Range: 0 to 100.
categories.<category>.checksObject ArrayThe checks behind the category score.
categories.<category>.checks[].nameStringMachine name of the check (see the lists above).
categories.<category>.checks[].statusENUMAllowed values: pass, warning, fail, info. info checks are informational.
categories.<category>.checks[].scoreIntegerPoints the check earned. Range: 0 to 100.
categories.<category>.checks[].detailStringWhat the check found, in one line.
categories.<category>.checks[].recommendationStringWhat to change to pass. Absent or null when there is nothing to fix.
prioritiesObject ArrayFix list, most important first.
priorities[].severityENUMAllowed values: high, medium, low.
priorities[].categoryENUMCategory the fix belongs to. Allowed values: crawl_access, structured_data, content_structure, entity_clarity, freshness_signals.
priorities[].checkStringName of the check that raised it.
priorities[].issueStringThe problem, in a short phrase.
priorities[].fixStringThe change to make.
priorities[].plain_englishStringWhy it matters, for a non-specialist.
priorities[].who_fixes_itStringWho usually makes the fix, for example content or developer.
checks_totalIntegerNumber of checks run (26 in every test).
checks_passedIntegerNumber of checks with status pass.
timestampStringWhen the audit ran (ISO 8601, UTC).

Notes

  • If the page can't be audited, the API returns 422 with a detail message and no score. This happens when the site refuses the audit server (many sites block cloud servers), the URL returns an HTTP error such as 404 or 500, or the host doesn't resolve ("reason": "dns").
  • A request without url returns 422 with "msg": "Field required".
  • Most audits take about 0.5–2 seconds.
▣ 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.