---
title: Audit Webpage SEO API
slug: audit-url
url: https://apyhub.com/seoscoreapi/service/audit-url
provider: SEO Score API
categories: [Verification Kit, Media Kit]
tags: [url-audit, web-performance, core-web-vitals, tracker-detection, conversion-optimization]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 1
atoms: 300
mcp: true
---

# Audit Webpage SEO API

Audit a URL for page performance, tracker inventory, and optional conversion scoring. Includes Core Web Vitals and scoreboard visibility controls.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/seoscoreapi/audit-url` | What it does Runs a full SEO audit of one page: 80+ checks across meta tags, technical SEO, social… | 300 |

## Endpoint reference

### Audit one URL

`GET https://api.eu.apyhub.com/seoscoreapi/audit-url` · 300 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `cwv` | query | boolean | no | 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… |
| `url` | query | string | yes | The URL to audit (e.g., https://example.com) Example: `https://www.wikipedia.org`. |
| `include` | query | string | no | Comma-separated extras: `trackers` (tracker and pixel inventory) and `conversion` (conversion score). Each adds a few seconds. |
| `scoreboard` | query | boolean | no | Public scoreboard listing. `true` lists this site on the provider's public scoreboard; `false` keeps it off. Leave unset or `false` unless you want the site listed publicly. Example: `false`. |

#### Quickstart

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

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

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

## About

## 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.

## 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-url
