Name: SEO Audit API: Indexability, Robots and Canonical Checks
Brand: api-factory-1
SKU: api-api-factory-1-website-seo-indexability
Availability: InStock
Author: API Market

David Garcia

# SEO Checker API: Technical SEO and Indexability Audit

## Overview

The Website SEO and Indexability API runs a technical SEO audit on one public HTTP or HTTPS URL per call. A single endpoint, GET /v1/analyze, fetches the page and returns the HTTP status and redirect chain, a technical indexability verdict with a numeric score and reasons, robots meta and X-Robots-Tag directives, canonical details, title, meta description, headings, hreflang, Open Graph and Twitter tags, JSON-LD block counts and link counts. It also checks robots.txt and a sitemap candidate, then lists warnings with a severity and a matching recommendation for each one. The verdict is based on technical signals only: it does not run client-side JavaScript and does not verify actual indexing, rankings, traffic or backlinks.

It is built for SEO agencies running site audits, developers adding pre-publish checks to a CMS or CI pipeline, marketing teams monitoring key landing pages, website builders that want an SEO checker inside their product, and AI agents that need structured page signals. Responses are JSON grouped into objects such as input, http, technical_indexability, robots, canonical, title, meta_description, headings, hreflang, structured_data, links, robots_txt, sitemap, warnings, recommendations and meta. Warnings carry a code, severity, field and message, so you can filter or sort issues in your own reports.

## Features

*   **1 endpoint, full audit**: GET /v1/analyze takes one url parameter and returns every check in a single JSON response.
*   **Indexability verdict and score**: A technical_indexability verdict such as INDEXABLE, a numeric score and a list of reasons behind it.
*   **Robots and canonical checks**: Robots meta and X-Robots-Tag directives, robots.txt reachability and wildcard blocks, plus canonical presence, resolved URL, self-referencing and cross-domain flags.
*   **On-page metadata**: Title and meta description with value, length and count, H1 count and heading outline, hreflang entries, Open Graph and Twitter tags.
*   **Structured data and links**: JSON-LD block counts split into valid, invalid and skipped, the schema types found, and internal, external, nofollow and malformed link counts.
*   **Warnings with fixes**: Each warning has a code, severity, field and message, paired with a recommendation that states the action to take.
*   **Redirect and HTTP details**: Status code, content type, HTTPS use, redirect count and the full redirect chain to the final URL.
*   **Rate limit**: 2 requests per second on the free trial, 5 on PRO, and 10 on ULTRA and MEGA.

## Use Cases

*   **SEO agencies**: Run a technical SEO audit on client URLs and feed the warnings and recommendations into audit reports.
*   **Pre-publish checks**: Call the API from a CMS or CI step to catch noindex tags, missing canonicals or empty meta descriptions before a page goes live.
*   **Landing page monitoring**: Re-check important pages on a schedule and alert when the indexability verdict or score changes.
*   **SEO checker tools**: Add a URL audit feature to a website builder, SaaS dashboard or browser extension without writing your own crawler.
*   **Migrations and redirects**: Verify redirect chains, final status codes and canonical targets after a site move or URL restructure.
*   **AI agents**: Give an agent structured page signals and plain-language recommendations it can summarise for a user.

## Pricing

| Plan | Price | What you get | Rate limit | Endpoints |
|---|---|---|---|---|
| BASIC | $0 | 7-day free trial with 50 API calls | 2 requests/second | 1 |
| PRO | $9.99/month | 2,000 calls/month, calls stop at the limit | 5 requests/second | 1 |
| ULTRA | $29.99/month | 10,000 calls/month, calls stop at the limit | 10 requests/second | 1 |
| MEGA | $69.99/month | 30,000 calls/month, calls stop at the limit | 10 requests/second | 1 |

## API Documentation

### Base URL

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

```
https://prod.api.market/api/v1/api-factory-1/website-seo-indexability
```

### Authentication

Every request needs 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. Analyze one public web URL

Makes at most seven HTTP fetches: page and up to five redirects, robots.txt, and one same-origin sitemap probe. Performs DNS checks before every fetch. HTTP/HTTPS only; credentials, private/reserved addresses, nonstandard ports and unsafe redirects are rejected. Response and array sizes are bounded. The service does not execute JavaScript or fetch canonical, hreflang, social image or linked URLs.

**Method:** `GET`

**Endpoint:** `/v1/analyze`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `url` | query | Absolute public HTTP or HTTPS URL, maximum 2048 characters. Example: `https://example.com/page`. | string | Yes | - | - |

**Example Request:**

```bash
curl -X GET "https://prod.api.market/api/v1/api-factory-1/website-seo-indexability/v1/analyze?url=https%3A%2F%2Fexample.com%2F" \
  -H "x-api-market-key: YOUR_API_KEY"
```

**Example Response (200 OK, abridged):**

```json
{
  "data": {
    "input": {
      "original_url": "https://example.com/",
      "normalized_url": "https://example.com/",
      "final_url": "https://example.com/",
      "hostname": "example.com",
      "scheme": "https"
    },
    "http": {
      "reachable": true,
      "status_code": 200,
      "content_type": "text/html; charset=utf-8",
      "redirect_count": 0,
      "redirect_chain": [
        {
          "url": "https://example.com/",
          "status": 200
        }
      ],
      "final_status": 200,
      "https_used": true
    },
    "technical_indexability": {
      "verdict": "INDEXABLE",
      "reasons": [],
      "definition": "Technical signals only; actual search-engine indexing is not..."
    },
    "technical_indexability_score": 93,
    "robots": {
      "meta": {
        "raw": [],
        "directives": {}
      },
      "x_robots_tag": {
        "raw": "",
        "directives": {}
      }
    },
    "canonical": {
      "present": false,
      "href": null,
      "resolved_url": null,
      "self_referencing": false,
      "cross_domain": false,
      "multiple": false
    },
    "title": {
      "present": true,
      "value": "Example Domain",
      "length": 14,
      "count": 1
    },
    "meta_description": {
      "present": false,
      "value": null,
      "length": 0,
      "count": 0
    },
    "headings": {
      "h1_count": 0,
      "h1": [],
      "outline": []
    },
    "hreflang": {
      "entries": [],
      "count": 0,
      "reciprocity_verified": false
    }
  },
  "requestId": "a30cec43-eb21-4d3c-8978-9de97470fac7"
}
```

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the data is in the response body. |
| 400 | Bad Request | A required parameter is missing or invalid, or the `x-api-market-key` header is missing. |
| 401 | Unauthorized | The `x-api-market-key` value is invalid or expired. |
| 403 | Forbidden | Your subscription does not include this endpoint. Check which endpoints your plan includes. |
| 404 | Not Found | The requested item or path was not found. |
| 429 | Too Many Requests | You went over your plan's rate limit (2 to 5 to 10 requests/second depending on plan) or used up your plan's calls. |
| 500 | Internal Server Error | Something failed while processing the request. Retry after a short delay. |
| 503 | Service Unavailable | The service is temporarily unavailable. Retry later. |

## Rate Limits

The free trial (BASIC) allows 2 requests per second and 50 calls. PRO allows 5 requests per second and 2,000 calls a month, ULTRA allows 10 requests per second and 10,000 calls a month, and MEGA allows 10 requests per second and 30,000 calls a month. All plans use a hard limit, so calls beyond the monthly quota are blocked until the next cycle or an upgrade. Going over the per-second limit returns HTTP 429; back off and retry, and honour the Retry-After header when it is present.

## FAQ

**Is there a free trial?**

Yes. The BASIC plan is a 7-day free trial with 50 API calls, so you can audit a few URLs before choosing a paid plan.

**How much does it cost?**

PRO is $9.99 per month for 2,000 calls, ULTRA is $29.99 per month for 10,000 calls and MEGA is $69.99 per month for 30,000 calls. Each plan has a hard limit, so extra calls are blocked rather than billed.

**How do I call the API?**

Send GET /v1/analyze with a url query parameter and your API.market key in the x-api-market-key header. URL-encode the target, for example url=https%3A%2F%2Fexample.com%2F.

**What URLs can I analyze?**

Absolute public HTTP or HTTPS URLs up to 2,048 characters. Include the scheme; private or internal addresses are not supported, and some sites block automated fetches or serve search engines a different response.

**Does this API track Google rankings?**

No. It is a technical SEO audit of one page, not a rank tracker. The response itself states that actual search-engine indexing is not verified, and it does not report rankings, traffic, Core Web Vitals or backlinks.

**Does it render JavaScript?**

No. It analyzes the fetched HTML and HTTP response, and the meta object reports client_side_javascript_executed as false. Tags injected only by client-side JavaScript will not be seen.

**What does the indexability score mean?**

It is a technical score paired with a verdict such as INDEXABLE and a list of reasons. It reflects signals like status code, robots directives and canonical setup, not a prediction of where the page will rank.

**Are the URLs I check stored?**

Each response's meta object reports data_retention as none, along with a request_id you can keep for your own logs.

## 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 public URL for technical SEO: indexability verdict, robots, canonical, meta tags, headings and JSON-LD. Start with a free trial of 50 calls.

SEO Audit API: Indexability, Robots and Canonical Checks

BASIC