Skip to main content

Features


Base URL

All API requests use this base URL:
https://api.spidra.io/api

Authentication

Include your API key in the x-api-key header:
curl -X POST https://api.spidra.io/api/scrape \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls": [{"url": "https://example.com"}]}'
Get your API key from app.spidra.io → Settings → API Keys.
Keep your API key secret. Never expose it in frontend code.

Response Codes

StatusDescription
200Success
202Job queued (for async endpoints)
400Bad request - check your parameters
401Unauthorized - invalid or missing API key
403Forbidden - quota exceeded or no permission
404Resource not found
429Rate limit exceeded
500Server error

Error Format

All errors return this structure:
{
  "status": "error",
  "message": "Detailed error explanation"
}