apyhub
Back
▣ RETRIEVAL KIT · MEDIA KIT

Compare Webpage SEO Scores API

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.

POST
Compare 2-5 URLs side by side
https://api.eu.apyhub.com/seoscoreapi/compare-webpage-seo-scores

QUICKSTART

GUIDE

Quickstart

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

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:

{
  "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
          }
        ]
      }
    ]
  }
}
TRY ITLIVE · 1000 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
The request body.
urls*
2–5 full page URLs to compare, including `https://`.

About this endpoint

What it does

Audits 2 to 5 URLs in one call and compares them: overall score, each category, AI readability and the top fixes for each page. Useful for checking a page against competitors or comparing versions of a page.

Request Body

ParameterTypeMandatoryDescription
urlsString ArrayYesThe URLs to compare side by side. Provide at least 2 and at most 5 items.

Response

A JSON object; nested fields are written parent.child, and [] marks an array of objects.

FieldTypeDescription
diffobjectHow the URLs compare: the leader in each category and the gap between every pair.
diff.pairsarray of objectOne entry per pair of URLs compared.
diff.pairs[].astringFirst URL of the pair.
diff.pairs[].bstringSecond URL of the pair.
diff.pairs[].overall_gapnumbera's overall score minus b's, in points; negative means b scores higher.
diff.pairs[].category_diffsarray of objectOne item per category where the two URLs score differently; empty when they score the same in every category.
diff.pairs[].category_diffs[].categorystringThe category — meta, technical, social, performance or accessibility.
diff.pairs[].category_diffs[].winnerstringThe URL with the higher score in this category.
diff.pairs[].category_diffs[].gapnumberHow many points the winner leads by (always positive).
diff.overall_leaderobjectURL with the highest overall score.
diff.overall_leader.urlstringThe leading URL.
diff.overall_leader.scorenumberIts score, 0–100.
diff.category_leadersobjectBest URL per category.
diff.category_leaders.metaobjectLeader for this category.
diff.category_leaders.meta.leaderstringURL with the highest score in this category.
diff.category_leaders.meta.scorenumberThat URL's category score, 0–100.
diff.category_leaders.socialobjectLeader for this category.
diff.category_leaders.social.leaderstringURL with the highest score in this category.
diff.category_leaders.social.scorenumberThat URL's category score, 0–100.
diff.category_leaders.technicalobjectLeader for this category.
diff.category_leaders.technical.leaderstringURL with the highest score in this category.
diff.category_leaders.technical.scorenumberThat URL's category score, 0–100.
diff.category_leaders.performanceobjectLeader for this category.
diff.category_leaders.performance.leaderstringURL with the highest score in this category.
diff.category_leaders.performance.scorenumberThat URL's category score, 0–100.
diff.category_leaders.accessibilityobjectLeader for this category.
diff.category_leaders.accessibility.leaderstringURL with the highest score in this category.
diff.category_leaders.accessibility.scorenumberThat URL's category score, 0–100.
diff.ai_readability_leaderobjectURL with the highest AI readability score.
diff.ai_readability_leader.urlstringThe leading URL.
diff.ai_readability_leader.scoreintegerIts score, 0–100.
countintegerNumber of URLs in the request.
resultsarray of objectOne result per URL, in the order sent.
results[].urlstringThe URL that was checked, as you sent it.
results[].gradestringLetter grade from A+ to F.
results[].scorenumberScore, 0–100.
results[].categoriesobjectScore per audit category (meta, technical, social, performance, accessibility), each 0–100.
results[].categories.metanumberCategory score, 0–100.
results[].categories.technicalnumberCategory score, 0–100.
results[].categories.socialnumberCategory score, 0–100.
results[].categories.performancenumberCategory score, 0–100.
results[].categories.accessibilitynumberCategory score, 0–100.
results[].prioritiesarray of objectFix list, most important first.
results[].priorities[].severitystringHow much fixing it matters — high, medium or low.
results[].priorities[].categorystringCategory the issue belongs to (e.g. meta, technical, performance).
results[].priorities[].issuestringThe problem found, in a short phrase.
results[].priorities[].fixstringThe change to make.
results[].priorities[].plain_englishstringWhy it matters, in plain language for a non-specialist.
results[].priorities[].who_fixes_itstringWho usually makes the fix — e.g. content (copywriter/editor), developer, marketing.
results[].ai_readabilityintegerAI readability score for this URL, 0–100.
comparedintegerNumber of URLs successfully audited and compared.
▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.