API Documentation

The Sitepry API lets you scrape Google Maps, search engine results (SERP), and more — all endpoints return JSON.

Base URL: https://sitepry.com/api/v1

Authentication

All API requests require an API key in the header:

Authorization: Bearer YOUR_API_KEY

⚠️ Important: Keep your API key secret. Generate keys from your Dashboard.

X-RateLimit-Limit: 30
X-RateLimit-Remaining: 28

{
    "success": false,
    "error": { "code": "INSUFFICIENT_CREDITS", "message": "..." }
}

Common codes: 401 UNAUTHORIZED, 402 INSUFFICIENT_CREDITS, 422 VALIDATION_ERROR, 429 RATE_LIMITED, 500 SERVER_ERROR

These endpoints work for all scrapers.

GET/balance

Get your credit balance.

GET/jobs

List jobs. Query: limit, offset

GET/job-status?id=

Poll job status.

GET/jobs/:id/download?format=json|csv

Download results.

Get 500 free credits for just $1.

Get Started →