---
title: Audit Webpage AI Visibility API
slug: audit-webpage-ai-visibility
url: https://apyhub.com/seoscoreapi/service/audit-webpage-ai-visibility
provider: SEO Score API
categories: [Retrieval Kit, Media Kit]
tags: [geo-audit, ai-visibility, content-discovery, search-optimization, web-audit]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 1
atoms: 400
mcp: true
---

# Audit Webpage AI Visibility API

GEO audit API: send a page URL and get back a 0 to 100 AI visibility score, five category scores, and a ranked fix list. Free tier, no card.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/seoscoreapi/audit-webpage-ai-visibility` | What it does Audits one web page for visibility to AI assistants and AI search (GEO) and returns a… | 400 |

## Endpoint reference

### Audit: how visible a page is to AI assistants

`GET https://api.eu.apyhub.com/seoscoreapi/audit-webpage-ai-visibility` · 400 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `url` | query | string | yes | 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`. Example: `https://www.wikipedia.org`. |

#### Quickstart

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

```bash
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:

```json
{
  "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"
}
```

## About

## 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](https://apyhub.com/seoscoreapi/service/audit-url). Check image alt text with the [Audit Webpage Images for SEO API](https://apyhub.com/freejosephe/service/audit-webpage-images-for-seo), and structured data with the [Evaluate SEO Health API](https://apyhub.com/chisleroff/service/evaluate-seo-health).

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/seoscoreapi/service/audit-webpage-ai-visibility
