API 文档
SiteData API 当前已开放接口的文档总览。
SiteData API 文档
这里整理了当前 SiteData API 已开放的接口,以及统一的鉴权、积分和响应约定。
当前已整理的接口:
- Adsense API
- Adsense Domain API
- Adsense PubId API
- DR API
- Traffic API
- Ads Transparency API
- Transparency Keyword API
- Transparency Domain API
- Transparency Creative IDs API
- Ads Transparency Statistics API
- Advertiser Search API
- Domain Search API
- Advertiser Statistics API
- Domain Statistics API
- Title Search API
- Domain Titles API
- Domain Image Ads API
- Title Countries API
- Title Image Ads API
后续还可以在同一套产品层继续扩展更多接口。
鉴权方式
所有请求都需要 API Key。
Authorization: Bearer YOUR_API_KEY通用响应
{
"code": "ok",
"message": "ok",
"data": {}
}错误码
| HTTP Status | code | 说明 |
|---|---|---|
| 400 | invalid_params | 请求参数不合法 |
| 401 | missing_api_key | 缺少 Authorization 请求头 |
| 401 | invalid_api_key | API Key 无效 |
| 402 | insufficient_credits | 积分不足 |
| 429 | rate_limit_exceeded | 请求过于频繁 |
| 500 | internal_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 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 |
下一步
- Open API Tester
- Adsense API Guide
- Adsense Domain API Guide
- Adsense PubId API Guide
- DR API Guide
- Traffic API Guide
- Ads Transparency API Guide
- Transparency Keyword API Guide
- Transparency Domain API Guide
- Transparency Creative IDs API Guide
- Ads Transparency Statistics API Guide
- Advertiser Search API Guide
- Domain Search API Guide
- Advertiser Statistics API Guide
- Domain Statistics API Guide
- Title Search API Guide
- Domain Titles API Guide
- Domain Image Ads API Guide
- Title Countries API Guide
- Title Image Ads API Guide