Name: SEOScore API: SEO Audit, Score and Fix List
Brand: visionwell
SKU: api-visionwell-seoscore
Availability: InStock
Author: API Market

binbin7418-dotcom

# SEOScore SEO Audit API

## Overview

The SEOScore API audits a web page and returns a 0 to 100 SEO score with a letter grade, about 20 rule-based checks across titles, meta tags, headings, links, images, structured data and performance, and a prioritised list of fixes. It also returns a GEO score for AI search readiness, including whether AI crawlers such as GPTBot and ClaudeBot are allowed and whether the site has an `llms.txt` file.

It is built for SEO agencies, site owners, CMS plugins and marketing tools that need a repeatable page audit. The checks are rules-based, so the same page always gets the same score. Audit one URL by GET or POST, or up to 25 URLs in a batch.

## Features

*   **4 endpoints**: status, audit by GET, audit by POST and batch audit.
*   **SEO score**: 0 to 100 score and grade from about 20 checks.
*   **GEO score**: AI crawler access and `llms.txt` checks.
*   **Fix list**: each failed check with its severity and how to fix it.
*   **Batch**: up to 25 URLs per call with an average score.
*   **Rate limit**: up to 10 requests per second on every plan.

## Use Cases

*   **SEO agencies**: audit client pages at scale.
*   **CMS plugins**: show a score when a page is published.
*   **Content teams**: check new pages before launch.
*   **AI search**: check whether AI crawlers can read your site.

## API Documentation

### Base URL

All requests go through the API.market proxy at this base URL:

```
https://prod.api.market/api/v1/visionwell/seoscore
```

### Authentication

Every request must include your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Service status

Returns the service status and the available endpoints.

**Method:** `GET`

**Endpoint:** `/`

**Parameters:** None.

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/visionwell/seoscore/' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "ok": true,
  "service": "SEOScore — SEO Audit API",
  "endpoints": [
    "POST /audit {url}",
    "GET /audit?url=",
    "POST /audit/batch {urls:[...]}"
  ]
}
```

#### 2. Audit a page (GET)

Audits one page passed as a query parameter.

**Method:** `GET`

**Endpoint:** `/audit`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| url | query | The page URL to audit | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/visionwell/seoscore/audit?url=https%3A%2F%2Fwww.python.org%2F' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "url": "https://www.python.org/",
  "finalUrl": "https://www.python.org/",
  "ok": true,
  "score": 15,
  "maxScore": 100,
  "grade": "F",
  "geoScore": 35,
  "statusCode": 403,
  "responseTimeMs": 201,
  "pageBytes": 0,
  "truncated": false,
  "checks": [
    {
      "id": "title_present",
      "category": "meta",
      "label": "Title tag present",
      "status": "fail",
      "points": 0,
      "maxPoints": 8,
      "details": "No <title> found.",
      "fix": "Add a unique <title> of 30-60 characters that states the page topic."
    },
    {
      "id": "title_length",
      "category": "meta",
      "label": "Title length 30-60 chars",
      "status": "fail",
      "points": 0,
      "maxPoints": 4,
      "details": "No title to measure.",
      "fix": "Rewrite the title to 30-60 characters so it is not truncated in search results."
    }
  ],
  "geo": {
    "score": 35,
    "aiCrawlerAccess": {
      "GPTBot": "allowed",
      "ClaudeBot": "allowed",
      "PerplexityBot": "allowed",
      "Google-Extended": "allowed",
      "CCBot": "allowed"
    },
    "llmsTxt": false,
    "checks": [
      {
        "id": "llms_txt",
        "label": "llms.txt present for AI systems",
        "status": "warn",
        "points": 0,
        "maxPoints": 25,
        "details": "No llms.txt at the origin root.",
        "fix": "Publish an llms.txt that summarises the site and links its key pages for AI systems."
      },
      {
        "id": "ai_crawlers",
        "label": "AI crawlers allowed in robots.txt",
        "status": "pass",
        "points": 30,
        "maxPoints": 30,
        "details": "GPTBot: allowed; ClaudeBot: allowed; PerplexityBot: allowed; Google-Extended: allowed; CCBot: allowed.",
        "fix": null
      }
    ]
  },
  "fixes": [
    {
      "check": "llms_txt",
      "severity": "medium",
      "fix": "Publish an llms.txt that summarises the site and links its key pages for AI systems.",
      "details": "No llms.txt at the origin root."
    },
    {
      "check": "geo_structured_data",
      "severity": "high",
      "fix": "Add valid JSON-LD describing the page entity so AI systems can cite it accurately.",
      "details": "No JSON-LD found."
    }
  ],
  "note": "Rules-based single-page audit of the raw HTML, response status and robots.txt/llms.txt. No JavaScript rendering, no backlink or ranking data, no Lighthouse lab..."
}
```

#### 3. Audit a page (POST)

Audits one page sent in the JSON body. It returns the same fields as the GET endpoint.

**Method:** `POST`

**Endpoint:** `/audit`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| url | body | The page URL to audit | string | Yes | - | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/visionwell/seoscore/audit' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "url": "https://example.com/"
}'
```

**Example Response (200 OK):**

```json
{
  "url": "https://example.com/",
  "finalUrl": "https://example.com/",
  "ok": true,
  "score": 29,
  "maxScore": 100,
  "grade": "F",
  "geoScore": 40,
  "statusCode": 200,
  "responseTimeMs": 10,
  "pageBytes": 577,
  "truncated": false,
  "checks": [
    {
      "id": "title_present",
      "category": "meta",
      "label": "Title tag present",
      "status": "pass",
      "points": 8,
      "maxPoints": 8,
      "details": "Title: \"Example Domain\"",
      "fix": null
    },
    {
      "id": "title_length",
      "category": "meta",
      "label": "Title length 30-60 chars",
      "status": "warn",
      "points": 0,
      "maxPoints": 4,
      "details": "Title is 14 characters.",
      "fix": "Rewrite the title to 30-60 characters so it is not truncated in search results."
    }
  ],
  "geo": {
    "score": 40,
    "aiCrawlerAccess": {
      "GPTBot": "allowed",
      "ClaudeBot": "allowed",
      "PerplexityBot": "allowed",
      "Google-Extended": "allowed",
      "CCBot": "allowed"
    },
    "llmsTxt": false,
    "checks": [
      {
        "id": "llms_txt",
        "label": "llms.txt present for AI systems",
        "status": "warn",
        "points": 0,
        "maxPoints": 25,
        "details": "No llms.txt at the origin root.",
        "fix": "Publish an llms.txt that summarises the site and links its key pages for AI systems."
      },
      {
        "id": "ai_crawlers",
        "label": "AI crawlers allowed in robots.txt",
        "status": "pass",
        "points": 30,
        "maxPoints": 30,
        "details": "GPTBot: allowed; ClaudeBot: allowed; PerplexityBot: allowed; Google-Extended: allowed; CCBot: allowed.",
        "fix": null
      }
    ]
  },
  "fixes": [
    {
      "check": "llms_txt",
      "severity": "medium",
      "fix": "Publish an llms.txt that summarises the site and links its key pages for AI systems.",
      "details": "No llms.txt at the origin root."
    },
    {
      "check": "geo_structured_data",
      "severity": "high",
      "fix": "Add valid JSON-LD describing the page entity so AI systems can cite it accurately.",
      "details": "No JSON-LD found."
    }
  ],
  "note": "Rules-based single-page audit of the raw HTML, response status and robots.txt/llms.txt. No JavaScript rendering, no backlink or ranking data, no Lighthouse lab..."
}
```

#### 4. Audit a batch

Audits up to 25 pages and returns one result per page plus a summary.

**Method:** `POST`

**Endpoint:** `/audit/batch`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| urls | body | Page URLs to audit | array of strings | Yes | - | 25 |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/visionwell/seoscore/audit/batch' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "urls": [
    "https://example.com/",
    "https://www.python.org/"
  ]
}'
```

**Example Response (200 OK):**

```json
{
  "results": [
    {
      "url": "https://example.com/",
      "finalUrl": "https://example.com/",
      "ok": true,
      "score": 29,
      "maxScore": 100,
      "grade": "F",
      "geoScore": 40,
      "statusCode": 200,
      "responseTimeMs": 7,
      "pageBytes": 577,
      "truncated": false,
      "checks": [
        {
          "id": "title_present",
          "category": "meta",
          "label": "Title tag present",
          "status": "pass",
          "points": 8,
          "maxPoints": 8,
          "details": "Title: \"Example Domain\"",
          "fix": null
        }
      ],
      "geo": {
        "score": 40,
        "aiCrawlerAccess": {
          "GPTBot": "allowed",
          "ClaudeBot": "allowed",
          "PerplexityBot": "allowed",
          "Google-Extended": "allowed",
          "CCBot": "allowed"
        },
        "llmsTxt": false,
        "checks": [
          {
            "id": "llms_txt",
            "label": "llms.txt present for AI systems",
            "status": "warn",
            "points": 0,
            "maxPoints": 25,
            "details": "No llms.txt at the origin root.",
            "fix": "Publish an llms.txt that summarises the site and links its key pages for AI systems."
          }
        ]
      },
      "fixes": [
        {
          "check": "llms_txt",
          "severity": "medium",
          "fix": "Publish an llms.txt that summarises the site and links its key pages for AI systems.",
          "details": "No llms.txt at the origin root."
        }
      ],
      "note": "Rules-based single-page audit of the raw HTML, response status and robots.txt/llms.txt. No JavaScript rendering, no backlink or ranking data, no Lighthouse lab..."
    }
  ],
  "summary": {
    "total": 2,
    "succeeded": 2,
    "failed": 0,
    "averageScore": 22,
    "averageGeoScore": 37.5
  }
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the response body holds the result. |
| 400 | Bad Request | A required parameter is missing or a value is invalid. Check the parameter table for the endpoint. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key is valid but your subscription does not allow this request, for example an endpoint outside your plan. |
| 404 | Not Found | The path does not exist, or the resource you asked for was not found. |
| 429 | Too Many Requests | You sent more than 10 requests per second. Slow down and retry, honouring the `Retry-After` header. |
| 500 | Internal Server Error | Something went wrong while processing the request. Retry after a short wait. |
| 503 | Service Unavailable | The service or its upstream data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

Every plan allows up to 10 requests per second. Subscription plans also have a monthly call quota shown on the pricing page. Sending more than 10 requests per second returns `429 Too Many Requests`. Throttle your client to stay under 10 requests per second, back off and retry when you get a 429, and honour the `Retry-After` header when it is present.

## FAQ

*   **Why did a well-known site get a low score?**

    Check `statusCode` in the response. Some sites block automated requests and return 403, and the audit then scores the error page. Audit pages that return 200.

*   **Does it render JavaScript?**

    No. It audits the HTML the server returns, as most search engine crawlers first see it.

*   **What is the GEO score?**

    A separate score for how ready the page is for AI search engines, based on AI crawler rules in `robots.txt`, `llms.txt` and related checks.

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Audit any web page for SEO with a 0 to 100 score, about 20 checks, a GEO score for AI search and a prioritised fix list.

SEOScore API: SEO Audit, Score and Fix List