Skip to main content

API Reference

Base URL: https://seocrawler.app/api/v1

Authentication

Include your API key in the Authorization header:
Authorization: Bearer sc_your_api_key
API access requires an Agency plan. Generate keys at Settings → API.

Available Endpoints


Errors

All errors follow a consistent format:
{
  "error": {
    "message": "Human-readable message",
    "code": "ERROR_CODE"
  }
}
StatusCodeDescription
400VALIDATION_ERRORInvalid request
401UNAUTHORIZEDInvalid API key
403AGENCY_REQUIREDRequires Agency plan
404NOT_FOUNDResource not found
429RATE_LIMITEDToo many requests

Rate Limits

  • 1,000 requests/minute per API key
  • 10 crawl starts/minute
Headers included in every response:
X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 999
X-RateLimit-Reset: 1699574400
The X-RateLimit-Reset header contains a Unix timestamp indicating when your rate limit will reset.