---
title: Compare Webpage SEO Scores API
slug: compare-webpage-seo-scores
url: https://apyhub.com/seoscoreapi/service/compare-webpage-seo-scores
provider: SEO Score API
categories: [Retrieval Kit, Media Kit]
tags: [url-comparison, web-comparison, page-diff, link-analysis, retrieval]
auth: api_key
version: 1.0.0
service_type: sync
endpoints: 1
atoms: 1000
mcp: true
---

# Compare Webpage SEO Scores API

Compare 2 to 5 URLs from one request. Useful for reviewing page differences across sites, environments, or versions.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| POST | `https://api.eu.apyhub.com/seoscoreapi/compare-webpage-seo-scores` | What it does Audits 2 to 5 URLs in one call and compares them: overall score, each category, AI rea… | 1000 |

## Endpoint reference

### Compare 2-5 URLs side by side

`POST https://api.eu.apyhub.com/seoscoreapi/compare-webpage-seo-scores` · 1000 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `urls` | body | array of string | yes | 2–5 full page URLs to compare, including `https://`. Example: `["https://www.wikipedia.org","https://en.wikipedia.org/wiki/Main_Page"]`. |

#### Quickstart

Compare up to 5 URLs by sending an array of at least 2 URLs in the request body.

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

#### What you'll get back

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

```json
{
  "count": 2,
  "compared": 2,
  "results": [
    {
      "url": "https://www.wikipedia.org",
      "score": 77.359,
      "grade": "B",
      "categories": {
        "meta": 76.75,
        "technical": 78.182,
        "social": 80.0,
        "performance": 82.5,
        "accessibility": 66.667
      },
      "ai_readability": 60,
      "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"
        }
      ]
    },
    {
      "url": "https://en.wikipedia.org/wiki/Main_Page",
      "score": 78.958,
      "grade": "B",
      "categories": {
        "meta": 69.5,
        "technical": 88.889,
        "social": 66.667,
        "performance": 80.0,
        "accessibility": 93.0
      },
      "ai_readability": 75,
      "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"
        }
      ]
    }
  ],
  "diff": {
    "overall_leader": {
      "url": "https://en.wikipedia.org/wiki/Main_Page",
      "score": 78.96
    },
    "ai_readability_leader": {
      "url": "https://en.wikipedia.org/wiki/Main_Page",
      "score": 75
    },
    "category_leaders": {
      "accessibility": {
        "leader": "https://en.wikipedia.org/wiki/Main_Page",
        "score": 93.0
      },
      "meta": {
        "leader": "https://www.wikipedia.org",
        "score": 76.75
      },
      "performance": {
        "leader": "https://www.wikipedia.org",
        "score": 82.5
      },
      "social": {
        "leader": "https://www.wikipedia.org",
        "score": 80.0
      },
      "technical": {
        "leader": "https://en.wikipedia.org/wiki/Main_Page",
        "score": 88.89
      }
    },
    "pairs": [
      {
        "a": "https://www.wikipedia.org",
        "b": "https://en.wikipedia.org/wiki/Main_Page",
        "overall_gap": -1.6,
        "category_diffs": [
          {
            "category": "accessibility",
            "winner": "https://en.wikipedia.org/wiki/Main_Page",
            "gap": 26.33
          },
          {
            "category": "meta",
            "winner": "https://www.wikipedia.org",
            "gap": 7.25
          }
        ]
      }
    ]
  }
}
```

## About

## What it does

URL Comparison runs the SEO audit on 2 to 5 pages at once and lines the results up side by side. You get each page's overall score and grade, its five category scores (meta, technical, social, performance, accessibility), its AI readability score and its top fixes — plus a `diff` naming the leader overall, in each category and for AI readability, and the score gap between every pair of pages.

Its one endpoint, `Compare 2-5 URLs side by side`, takes a `urls` array of 2–5 full page URLs in the request body.

URL Comparison is a good fit when you need to benchmark a page against competitors, pick the strongest of several landing-page variants, or show a client where their page trails — without auditing each page separately and diffing the results yourself.

## 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/compare-webpage-seo-scores
