API Documentation

Overview

The SEOData API provides programmatic access to all crawled SEO data. All responses are JSON-encoded. Paginate with ?page=N&limit=N query parameters.

Returns aggregate crawl statistics.

Response Example

{
  "total_pages": 142,
  "avg_response_ms": 287.5,
  "https_count": 130,
  "issues_count": 23,
  "unique_domains": 8
}

Returns paginated SEO results with scores.

Query Parameters

Parameter	Type	Default	Description
page	int	1	Page number
limit	int	25	Results per page (max 100)
domain	string	—	Filter by domain

Response Example

{
  "results": [
    {
      "data": {
        "ID": 1,
        "URL": "https://example.com",
        "StatusCode": 200,
        "Title": "Example Domain",
        "TitleLength": 14,
        ...
      },
      "score": {
        "overall": 78,
        "grade": "B",
        "title": 12,
        "meta": 8,
        ...
      }
    }
  ],
  "total": 142,
  "page": 1,
  "limit": 25
}

Returns a single result with full SEO data and score breakdown.

Response Example

{
  "data": {
    "ID": 1,
    "URL": "https://example.com",
    "StatusCode": 200,
    "Title": "Example Domain",
    "MetaDescription": "This domain is for use...",
    "IsHTTPS": true,
    "ResponseTime": 142,
    ...
  },
  "score": {
    "overall": 78,
    "grade": "B",
    "title": 12,
    "meta": 8,
    "headings": 10,
    "https": 10,
    "canonical": 5,
    "images": 5,
    "links": 10,
    "performance": 10,
    "social": 3,
    "robots": 5
  }
}