API 文档

SiteData API 当前已开放接口的文档总览。

SiteData API 文档

这里整理了当前 SiteData API 已开放的接口,以及统一的鉴权、积分和响应约定。

当前已整理的接口:

  1. Adsense API
  2. Adsense Domain API
  3. Adsense PubId API
  4. DR API
  5. Traffic API
  6. Ads Transparency API
  7. Transparency Keyword API
  8. Transparency Domain API
  9. Transparency Creative IDs API
  10. Ads Transparency Statistics API
  11. Advertiser Search API
  12. Domain Search API
  13. Advertiser Statistics API
  14. Domain Statistics API
  15. Title Search API
  16. Domain Titles API
  17. Domain Image Ads API
  18. Title Countries API
  19. Title Image Ads API

后续还可以在同一套产品层继续扩展更多接口。

鉴权方式

所有请求都需要 API Key。

Authorization: Bearer YOUR_API_KEY

通用响应

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

错误码

HTTP Statuscode说明
400invalid_params请求参数不合法
401missing_api_key缺少 Authorization 请求头
401invalid_api_keyAPI Key 无效
402insufficient_credits积分不足
429rate_limit_exceeded请求过于频繁
500internal_error服务内部错误

频率限制

当启用频率限制后,接口可能返回 429 Too Many Requests

  • 错误码:rate_limit_exceeded
  • 响应头:Retry-After
{
  "code": "rate_limit_exceeded",
  "message": "API rate limit exceeded. Please retry shortly.",
  "details": {
    "scope": "user",
    "limitPerSecond": 5
  }
}

已开放接口

API地址默认积分
Adsense APIGET /api/v1/adsense3 credits
DR APIGET /api/v1/dr1 credit
Traffic APIGET /api/v1/traffic2 credits
Ads Transparency APIGET /api/v1/transparency2 credits
Ads Transparency Statistics APIGET /api/v1/ads-statistics1-3 credits

下一步