---
title: Batch Audit Webpage SEO API
slug: batch-audit-urls
url: https://apyhub.com/seoscoreapi/service/batch-audit-urls
provider: SEO Score API
categories: [Media Kit]
tags: [url-audit, web-performance, core-web-vitals, page-check, batch-audit]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 1
atoms: 2000
mcp: true
---

# Batch Audit Webpage SEO API

Audit up to 10 URLs per request, with optional Core Web Vitals and scoreboard control. Useful for page monitoring and release checks.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/seoscoreapi/batch-audit-urls` | What it does Audits up to 10 URLs in one request. Each result is the same full audit as the single-… | 2000 |

## Endpoint reference

### Audit up to 10 URLs in one call

`POST https://api.eu.apyhub.com/seoscoreapi/batch-audit-urls` · 2000 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `cwv` | body | boolean | no | `true` adds measured Core Web Vitals for every URL in `core_web_vitals`. Off by default because it is slower. Default: `false`. Example: `false`. |
| `urls` | body | array of string | yes | 1–10 full page URLs to audit, including `https://`. Results come back in the same order. Example: `["https://www.wikipedia.org","https://en.wikipedia.org/wiki/Main_Page"]`. |
| `scoreboard` | body | boolean | no | Public scoreboard listing. `true` lists these sites on the provider's public scoreboard; `false` keeps them off. Leave unset or `false` unless you want them listed publicly. Example: `false`. |

#### Quickstart

Send up to 10 URLs to batch audit them in one request.

```bash
curl -X POST "https://api.eu.apyhub.com/seoscoreapi/batch-audit-urls" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.wikipedia.org","https://en.wikipedia.org/wiki/Main_Page"],"cwv":false,"scoreboard":false}'
```

#### What you'll get back

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

```json
{
  "count": 2,
  "results": [
    {
      "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": 1,
        "rendered": false,
        "checks_ms": 62,
        "robots_sitemap_ms": 152,
        "ai_readability_ms": 181,
        "core_web_vitals_wait_ms": 1,
        "total_ms": 574
      },
      "history": {
        "first_audit": false,
        "audits_recorded": 2,
        "previous_audit_at": 1794896640.770488,
        "days_since_last": 0.0,
        "delta": {
          "score": 0.0,
          "grade_change": null,
          "categories": {
            "meta": 0.0,
            "technical": 0.0,
            "social": 0.0,
            "performance": 0.0,
            "accessibility": 0.0
          }
        }
      }
    },
    {
      "url": "https://en.wikipedia.org/wiki/Main_Page",
      "score": 78.958,
      "grade": "B",
      "response_code": 200,
      "response_time": "0.11s",
      "html_truncated": false,
      "audit": {
        "meta": {
          "score": 69.5,
          "checks": [
            {
              "name": "title",
              "status": "pass",
              "value": "Wikipedia, the free encyclopedia",
              "score": 100
            },
            {
              "name": "meta_description",
              "status": "fail",
              "value": null,
              "score": 0,
              "recommendation": "Add a meta description (150-160 chars)"
            }
          ]
        },
        "technical": {
          "score": 88.889,
          "checks": [
            {
              "name": "response_time",
              "status": "pass",
              "value": "0.11s",
              "score": 100
            },
            {
              "name": "https",
              "status": "pass",
              "value": true,
              "score": 100
            }
          ]
        },
        "social": {
          "score": 66.667,
          "checks": [
            {
              "name": "open_graph",
              "status": "warning",
              "value": {
                "og:title": "Wikipedia, the free encyclopedia",
                "og:description": null,
                "og:image": "https://thumb.wikimedia.org/wikipedia/commons/thumb/e/ef/Dividing_the_Light_at_dusk.jpg/1280px-Dividing_the_Light_at_dusk.jpg?utm_source=en.wikipedia.org&utm_campaign=index&utm_content=thumbnail",
                "og:type": "website",
                "og:url": null
              },
              "score": 60,
              "recommendation": "Some Open Graph tags missing. Add og:title, og:description, og:image, og:type, og:url."
            },
            {
              "name": "twitter_card",
              "status": "warning",
              "value": null,
              "score": 40,
              "recommendation": "Add Twitter Card meta tags"
            }
          ]
        },
        "performance": {
          "score": 80.0,
          "checks": [
            {
              "name": "html_size",
              "status": "warning",
              "value": "252.8 KB",
              "score": 60,
              "recommendation": "HTML is getting large. Consider reducing inline resources."
            },
            {
              "name": "dom_size",
              "status": "warning",
              "value": 2336,
              "score": 60,
              "recommendation": "DOM is getting complex. Simplify where possible."
            }
          ]
        },
        "accessibility": {
          "score": 93.0,
          "checks": [
            {
              "name": "lang",
              "status": "pass",
              "value": "en",
              "score": 100
            },
            {
              "name": "image_alt_coverage",
              "status": "info",
              "value": "79%",
              "score": 79
            }
          ]
        }
      },
      "priorities": [
        {
          "severity": "high",
          "category": "meta",
          "issue": "Missing meta description",
          "fix": "Add a meta description (150-160 chars)",
          "plain_english": "The page has no summary for search results, so Google picks a random snippet that may not make people click.",
          "who_fixes_it": "content"
        },
        {
          "severity": "high",
          "category": "technical",
          "issue": "Schema missing required fields",
          "fix": "Add required schema.org properties to make items eligible for Google rich results",
          "plain_english": "The page's machine-readable labels are missing required details, so it isn't eligible for rich results.",
          "who_fixes_it": "developer"
        }
      ],
      "ai_readability": {
        "url": "https://en.wikipedia.org/wiki/Main_Page",
        "ai_readability_score": 75,
        "ai_readability_grade": "B",
        "categories": {
          "crawl_accessibility": {
            "score": 21,
            "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": 17,
            "max": 25,
            "checks": [
              {
                "name": "schema_jsonld",
                "status": "pass",
                "score": 8,
                "max": 8,
                "detail": "Types: Article"
              },
              {
                "name": "semantic_html",
                "status": "warning",
                "score": 2,
                "max": 5,
                "detail": "14 semantic elements, 210 divs (6% ratio)"
              }
            ]
          },
          "content_extractability": {
            "score": 24,
            "max": 30,
            "checks": [
              {
                "name": "answer_first",
                "status": "pass",
                "score": 6,
                "max": 6,
                "detail": "6/6 sections lead with facts"
              },
              {
                "name": "chunk_friendly",
                "status": "pass",
                "score": 4,
                "max": 6,
                "detail": "4/6 — sections sized for RAG chunking"
              }
            ]
          },
          "ai_discoverability": {
            "score": 13,
            "max": 20,
            "checks": [
              {
                "name": "open_graph",
                "status": "warning",
                "score": 2,
                "max": 4,
                "detail": "3/5 OG tags present"
              },
              {
                "name": "semantic_urls",
                "status": "pass",
                "score": 3,
                "max": 3,
                "detail": "/wiki/Main_Page"
              }
            ]
          }
        },
        "recommendations": [
          {
            "severity": "medium",
            "issue": "Low semantic HTML usage",
            "fix": "Replace generic <div> elements with semantic tags (<article>, <section>, <main>, <nav>) to improve AI content parsing",
            "plain_english": "The page's code doesn't label its sections clearly, so AI tools struggle to separate content from menus.",
            "who_fixes_it": "developer"
          },
          {
            "severity": "medium",
            "issue": "Only 79% of images have alt text",
            "fix": "Add descriptive alt attributes to all images for AI content understanding",
            "plain_english": "Only 79% of the images have a text description, so screen readers and AI tools miss what the rest show.",
            "who_fixes_it": "content"
          }
        ]
      },
      "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": 109,
        "render_ms": 2,
        "rendered": false,
        "checks_ms": 82,
        "robots_sitemap_ms": 75,
        "ai_readability_ms": 141,
        "core_web_vitals_wait_ms": 2,
        "total_ms": 474
      },
      "history": {
        "first_audit": false,
        "audits_recorded": 3,
        "previous_audit_at": 1794892590.9575255,
        "days_since_last": 0.05,
        "delta": {
          "score": 0.0,
          "grade_change": null,
          "categories": {
            "meta": 0.0,
            "technical": 0.0,
            "social": 0.0,
            "performance": 0.0,
            "accessibility": 0.0
          }
        }
      }
    }
  ]
}
```

## About

## What it does

Batch URL Audit runs the full SEO audit on up to 10 pages in one request and returns one complete result per page, in the order sent: a 0–100 score and letter grade, per-category checks, a prioritized fix list in plain English, and AI readability, SXO, AEO and AIO sub-scores.

Its one endpoint, `Audit up to 10 URLs in one call`, takes a `urls` array in the request body. Set `cwv` to `true` to add measured Core Web Vitals for every page (slower), and leave `scoreboard` unset or `false` unless you want the sites listed on the provider's public scoreboard.

Batch URL Audit is a good fit when you need to check a known set of pages — a site's key landing pages, a release's changed pages, a client portfolio — in one call instead of ten.

## 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/batch-audit-urls
