API Documentation

SiteData API Documentation

This documentation covers the currently available endpoints and the shared authentication, credit, and response conventions behind them.

Current documented endpoints:

More endpoints can be added on the same product layer over time.

Authentication

All requests require an API key.

Authorization: Bearer YOUR_API_KEY

Common Response

{
  "code": "ok",
  "message": "ok",
  "data": {}
}

Error Codes

HTTP Status	code	Description
400	`invalid_params`	Invalid request parameters
401	`missing_api_key`	Authorization header is required
401	`invalid_api_key`	API key is invalid
402	`insufficient_credits`	Insufficient credits
429	`rate_limit_exceeded`	Rate limit exceeded
500	`internal_error`	Internal server error

Rate Limiting

When rate limiting is enabled, the API can return 429 Too Many Requests.

Error code: rate_limit_exceeded
Response header: Retry-After

{
  "code": "rate_limit_exceeded",
  "message": "API rate limit exceeded. Please retry shortly.",
  "details": {
    "scope": "user",
    "limitPerSecond": 5
  }
}

Endpoints

API	Endpoint	Default Cost
Adsense API	`GET /api/v1/adsense`	`3 credits`
DR API	`GET /api/v1/dr`	`1 credit`
Traffic API	`GET /api/v1/traffic`	`2 credits`
Ads Transparency API	`GET /api/v1/transparency`	`2 credits`
Ads Transparency Statistics API	`GET /api/v1/ads-statistics`	`1-3 credits`