---
title: Analyze Webpage AI Readability API
slug: analyze-webpage-ai-readability
url: https://apyhub.com/seoscoreapi/service/analyze-webpage-ai-readability
provider: SEO Score API
categories: [Media Kit]
tags: [readability, web-content, url-analysis, crawler-compatibility, content-audit]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 1
atoms: 150
mcp: true
---

# Analyze Webpage AI Readability API

Check whether a URL is easy for AI systems to read and use. Useful for content audits, retrieval workflows, and crawler-friendly page reviews.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/seoscoreapi/analyze-webpage-ai-readability` | What it does Scores how easily AI models and assistants can read, extract and cite a page: crawl ac… | 150 |

## Endpoint reference

### AI readability score for one URL

`GET https://api.eu.apyhub.com/seoscoreapi/analyze-webpage-ai-readability` · 150 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `url` | query | string | yes | The page to analyse, as a full URL including `https://`. Example: `https://www.wikipedia.org`. |

#### Quickstart

Check a page’s URL for AI readability by passing it as a query parameter.

```bash
curl -X GET "https://api.eu.apyhub.com/seoscoreapi/analyze-webpage-ai-readability?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:

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

## About

## What it does
AI Readability Score checks how suitable a web page is for AI systems to read and use. Send a URL in the `url` query parameter and get a readability assessment back for that page.

Use it when you want to know whether a page is likely to be easy for models, crawlers, or downstream automation to process. That can help you audit content before exposing it to assistants, compare pages in a site migration, or spot pages that may need structural changes before they are used in retrieval workflows.

It has one endpoint, `AI readability score for one URL`.

If you are building tools that depend on machine-readable web content, this gives you a quick check on whether a page is a good candidate for AI consumption.

The JSON response carries the AI readability score and grade, four category scores and recommendations.

## 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/analyze-webpage-ai-readability
