Adsense API

按域名或发布商 ID 查询 Adsense 相关站点数据。

测试 API

接口地址

GET /api/v1/adsense

认证方式

Authorization: Bearer YOUR_API_KEY

请求参数

下面两个参数二选一:

参数类型必填说明
domainstring目标域名
pubIdstringAdsense 发布商 ID,例如 pub-3661441281163245

校验规则

  • domainpubId 不能同时传
  • 两者至少传一个

按域名查询

GET /api/v1/adsense?domain=twitter.com
Authorization: Bearer YOUR_API_KEY

返回示例:按域名查询

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "adsense",
    "costCredits": 3,
    "remainingCredits": 97,
    "query": {
      "domain": "twitter.com"
    },
    "domain": "twitter.com",
    "publisherIds": {
      "direct": [
        "pub-3661441281163245"
      ],
      "reseller": []
    },
    "total": {
      "direct": 1,
      "reseller": 0,
      "all": 1
    }
  }
}

按 PubId 查询

GET /api/v1/adsense?pubId=pub-3661441281163245
Authorization: Bearer YOUR_API_KEY

返回示例:按 PubId 查询

{
  "code": "ok",
  "message": "ok",
  "data": {
    "endpoint": "adsense",
    "costCredits": 3,
    "remainingCredits": 97,
    "query": {
      "pubId": "pub-3661441281163245"
    },
    "adSenseId": "pub-3661441281163245",
    "domains": [
      "x.com",
      "proxy-solutions.net"
    ],
    "count": 2
  }
}

返回字段说明

字段说明
data.endpoint固定值:adsense
data.costCredits本次请求消耗的积分
data.remainingCredits扣费后的剩余积分
data.query.domain按域名查询时的标准化域名参数
data.query.pubId按 PubId 查询时的发布商 ID 参数
data.domain按域名查询时返回的域名
data.publisherIdsdirectreseller 分组的发布商 ID 列表
data.total按域名查询时的数量统计,包含 directresellerall
data.adSenseId按 PubId 查询时返回的发布商 ID
data.domains与该发布商 ID 关联的域名列表
data.count返回的域名数量

计费说明

  • 每次请求扣除 3 credits

相关页面