---
title: "Compare Urls"
method: POST
path: "/compare"
---

# Compare Urls

`POST /compare`

## Request

- Base URL: `https://seoscoreapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://seoscoreapi.com/compare`
- Auth: none declared. Required headers: `X-API-Key`

Compare 2–5 URLs side by side with a structured diff.

Returns each URL's score + category breakdown plus a `diff` object
that tells you who is ahead and by how much, per category, per URL
pair. Built for agencies who embed comparisons in sales decks and
for devs who want a one-call sanity check across an old vs. new
deploy.

Send JSON: {"urls": ["https://a.com", "https://b.com", ...]}
Requires Basic plan ($15/mo) or higher.

## Headers

- `X-API-Key` string, required: Your API key

## Request body

- object
  - `urls` string[], required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/seoscoreapi/apis/seo-score-api.md) · [All operations](https://skmtc.dev/seoscoreapi/apis/seo-score-api/llms.txt) · [OpenAPI document](https://skmtc.dev/seoscoreapi/apis/seo-score-api/revisions/877a3044b5be?raw)