Name: SEO Snapshot API — Instant Full-Page SEO Metrics & Scores | SiteTrace
Brand: sitetrace
SKU: api-sitetrace-seo-snapshot
Availability: InStock
Author: API Market

Edy Appenzeller

# SEO Snapshot API - Instant Full-Page SEO Metrics & Scores

The SEO Snapshot API analyzes one public webpage and returns a structured on-page SEO report in a single JSON response. It is built for SEO tools, site audit dashboards, content QA workflows, agency reporting, lead qualification, and automated pre-publish checks.

Send a URL and the API fetches the page, extracts the most important SEO signals, scores the page, and returns practical recommendations. The response can be used directly in dashboards, alerts, reports, enrichment pipelines, or internal QA tools.

## Endpoint

`POST https://prod.api.market/v1/sitetrace/seo-snapshot/api/seo-snapshot`

Use the api.market endpoint shown in your subscription dashboard. Authentication, usage limits, billing, and plan access are handled by api.market. Do not send RapidAPI headers or custom subscription headers.

## What this API checks

SEO Snapshot returns the core data needed to understand whether a page is search-ready:

- HTTP status and final URL after redirects
- Page title, title length, and missing-title detection
- Meta description and description length
- Canonical URL when present
- H1/H2 heading structure and heading counts
- Word count and content-size signals
- Image counts and image alt text coverage
- Internal and external link counts
- Open Graph and social metadata signals
- Basic page-level SEO score
- Detected issues and recommended fixes
- Plan-dependent details for deeper audits

## Request body

Send JSON with a public HTTP or HTTPS URL.

```json
{
  "url": "https://example.com"
}
```

### Parameters

`url` is required. It must be a public HTTP or HTTPS webpage. Localhost, private IP addresses, and internal network URLs are rejected for security.

`max_urls` is optional and only relevant when shared tooling is used with sitemap workflows. For SEO Snapshot, the main required input is `url`.

## cURL example

```bash
curl -X POST "https://prod.api.market/v1/sitetrace/seo-snapshot/api/seo-snapshot" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "url": "https://example.com"
  }'
```

Replace `YOUR_API_MARKET_KEY` with the key shown by api.market after subscribing. If your api.market playground provides a different auth header, use the exact header generated there.

## JavaScript fetch example

```javascript
const response = await fetch("https://prod.api.market/v1/sitetrace/seo-snapshot/api/seo-snapshot", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-market-key": "YOUR_API_MARKET_KEY"
  },
  body: JSON.stringify({
    url: "https://example.com"
  })
});

const data = await response.json();
console.log(data);
```

## Successful response example

```json
{
  "success": true,
  "url": "https://example.com/",
  "final_url": "https://example.com/",
  "status_code": 200,
  "analyzed_at": "2026-06-01T08:00:00.000Z",
  "page": {
    "title": "Example Domain",
    "title_length": 14,
    "meta_description": null,
    "meta_description_length": 0,
    "canonical": "https://example.com/",
    "h1_count": 1,
    "h2_count": 0,
    "word_count": 28
  },
  "images": {
    "total": 0,
    "missing_alt": 0,
    "alt_coverage_percent": 100
  },
  "links": {
    "total": 1,
    "internal": 0,
    "external": 1
  },
  "social": {
    "open_graph_title": null,
    "open_graph_description": null,
    "twitter_card": null
  },
  "seo_score": 74,
  "issues": [
    {
      "severity": "medium",
      "field": "meta_description",
      "message": "Meta description is missing."
    }
  ],
  "recommendations": [
    "Add a concise meta description between 120 and 160 characters.",
    "Use headings to describe the page structure clearly."
  ]
}
```

Actual fields can vary by page structure and subscription plan. Some pages block automated fetches, redirect heavily, or return limited HTML; in those cases the API returns a structured error instead of a partial fake result.

## Error examples

Missing URL:

```json
{
  "success": false,
  "error": "URL is required"
}
```

Private or local URL:

```json
{
  "success": false,
  "error": "Private/local network URLs are not supported"
}
```

Target site cannot be fetched:

```json
{
  "success": false,
  "error": "Failed to fetch or analyze URL"
}
```

## Common use cases

Use SEO Snapshot before publishing a new landing page to catch missing titles, weak meta descriptions, heading problems, and low content signals.

Use it in an agency dashboard to create quick SEO summaries for prospects and clients.

Use it in a lead enrichment flow to score business websites and identify pages that need optimization.

Use it in monitoring jobs to detect when important SEO metadata changes after a deployment.

Use it in content operations to compare pages and prioritize simple fixes that can improve search readiness.

## Plan behavior

Free plans return the essential SEO snapshot fields needed for quick checks.

Paid plans are designed for higher usage and richer analysis. Depending on the active api.market plan, responses may include more detailed issue lists, additional recommendations, expanded page signals, and larger quota limits.

Rate limits and monthly quotas are enforced by api.market. If a limit is reached, the API returns a rate-limit response with plan and retry information.

## Best practices

Send the canonical public URL you want analyzed, including the protocol, for example `https://example.com/pricing`.

Avoid sending private dashboards, staging URLs, localhost URLs, or pages behind login screens.

For repeat monitoring, cache results on your side and re-check pages on a schedule that matches your plan quota.

For best results, analyze final production pages rather than redirects, tracking links, or short links.

## Support notes

SEO Snapshot is part of the SiteTrace API family. It focuses on fast, structured, page-level SEO analysis. For broader site crawling, sitemap extraction, robots.txt checks, schema detection, security headers, and full report generation, use the related SiteTrace APIs in the same store.

Get an instant SEO snapshot of any URL via REST API. Returns SEO score, title, meta tags, headings, word count, internal links & page speed. Free tier available.

SEO Snapshot API — Instant Full-Page SEO Metrics & Scores | SiteTrace

Basic