PPCEye API

五个只读接口，把广告主、落地域名网络和品牌词竞投数据接进你自己的系统。下面每个接口都附了真实的响应样例，不需要 key 就能先看清返回长什么样。

快速开始

基址 https://ppceye.com，全部是 GET，返回 JSON。到账户页创建 API key —— 明文只显示一次， 首次创建赠送 200 积分，够把五个接口都跑通。

认证用下面任一个请求头：

curl "https://ppceye.com/api/v1/advertiser?name=Dealer%20Spike" \
  -H "Authorization: Bearer ppc_xxxxxxxxxxxx"

# 等价写法
curl "https://ppceye.com/api/v1/advertiser?name=Dealer%20Spike" \
  -H "x-api-key: ppc_xxxxxxxxxxxx"

每个成功响应都会附带这两个字段，不用另外查余额：

"credits_charged": 1,
"credits_remaining": 199

计费

按积分计费，一次性买断、永不过期，不需要订阅。扣费发生在处理之前；余额不足返回 402 并且不扣分。积分包价格见定价页。

接口	积分 / 次
`/api/v1/advertiser`、`/api/v1/domain`	3
`/api/v1/advertiser/history`	9
`/api/v1/advertiser/domains`	15
`/api/v1/brandbid`	60

接口

GET/api/v1/advertiser3 积分

广告主投放概况。Google 会给同一家公司发多个 advertiser_id，本接口按名字把它们合并后统计。

参数	说明
`name`（必填）	广告主名称，区分大小写，与站内页面一致

{
  "advertiser": "Dealer Spike",
  "advertiser_ids": [
    "AR05738027791505424385", "AR08139894827664801793",
    "AR09607180450548154369", "AR11199105612044566529",
    "AR15781632204146212865"
  ],
  "creatives": 16313,
  "landing_domains": 1854,
  "last_seen": "2026-09-16",
  "country": "US",
  "advertiser_type": null,
  "credits_charged": 1,
  "credits_remaining": 199
}

advertiser_type 取值 "agency" / "direct" / null。它是人工标注的，null 只表示还没有人标过，不是「不是代理商」。时间维度不在这个接口里 —— 要按月时间轴请用 /advertiser/history。

GET/api/v1/domain3 积分

域名概况：有多少个广告主在往这个域名投广告。

参数	说明
`domain`（必填）	根域名，自动归一化（`www.`、协议、路径都会被剥掉）

{
  "domain": "dmit.io",
  "advertisers": 8,
  "last_crawled": "2026-08-22 11:25:38",
  "has_data": true,
  "credits_charged": 1,
  "credits_remaining": 198
}

GET/api/v1/advertiser/history9 积分

按月的投放时间轴，判断这家广告主是在放量还是在收缩。

参数	说明
`name`（必填）	广告主名称

{
  "advertiser": "Dealer Spike",
  "window_start": "2023-09-18",
  "months": [
    { "month": "2026-06", "creatives": 1876, "domains":  588 },
    { "month": "2026-07", "creatives": 1304, "domains":  404 },
    { "month": "2026-08", "creatives":  792, "domains":  264 },
    { "month": "2026-09", "creatives": 9819, "domains": 1430 }
  ],
  "credits_charged": 3,
  "credits_remaining": 195
}

窗口硬性限制在最近 36 个月（window_start 会告诉你实际起点），样例中的 months 只截取了末尾四个月。站内页面可以看到完整的六年多历史。

GET/api/v1/advertiser/domains15 积分

这个广告主投过哪些落地域名 —— 区分「品牌自投」和「代投／联盟」的核心信号。只投一两个域名多半是品牌自己或它的经销商；同时投上千个互不相关的域名就是代投机构。

参数	说明
`name`（必填）	广告主名称

{
  "advertiser": "Dealer Spike",
  "landing_domain_count": 1854,
  "landing_domains": [
    { "domain": "ronhooverrvs.com",        "creatives": 853, "last_seen": "2026-09-16" },
    { "domain": "meyersrvsuperstores.com", "creatives": 837, "last_seen": "2026-09-16" },
    { "domain": "rvstation.com",           "creatives": 580, "last_seen": "2026-09-16" },
    { "domain": "mikethompson.com",        "creatives": 129, "last_seen": "2026-09-16" }
  ],
  "truncated": true,
  "credits_charged": 5,
  "credits_remaining": 190
}

landing_domain_count 是全量总数，landing_domains 最多返回 500 条（按创意数降序）。超出时 truncated 为 true，样例里只保留了前 4 条。

GET/api/v1/brandbid60 积分

谁在往你的域名投广告，并直接给出每个广告主的落地域名规模。

参数	说明
`domain`（必填）	你的根域名

{
  "domain": "dmit.io",
  "advertiser_count": 8,
  "advertisers": [
    {
      "advertiser": "罗小加",
      "advertiser_id": "AR17017046509952172033",
      "creatives": 6,
      "first_seen": "2025-12-23",
      "last_seen": "2026-05-28",
      "landing_domain_count": 275,
      "profile": "multi_domain_intermediary"
    },
    {
      "advertiser": "Liu Li",
      "advertiser_id": "AR17818107663557328897",
      "creatives": 5,
      "first_seen": "2026-02-04",
      "last_seen": "2026-05-29",
      "landing_domain_count": 197,
      "profile": "multi_domain_intermediary"
    },
    {
      "advertiser": "Absolute Link Limited",
      "advertiser_id": "AR06785990551779934209",
      "creatives": 4,
      "first_seen": "2026-04-13",
      "last_seen": "2026-09-05",
      "landing_domain_count": 870,
      "profile": "multi_domain_intermediary"
    }
  ],
  "credits_charged": 10,
  "credits_remaining": 180
}

profile 取 single_domain（1 个）／few_domains（2–4 个）／ multi_domain_intermediary（≥5 个），最多返回 100 个广告主。样例里只保留了前 3 条。

profile 是描述，不是判定。是否构成商标侵权要看广告文案里有没有用到你的商标，这个接口给不了那个答案 —— 别把它当结论用。取证流程见这篇指南。

错误

状态码	`error`	含义
`400`	`missing_name` / `missing_domain`	必填参数为空。不扣积分。
`401`	`unauthorized`	key 缺失、格式不对、已吊销或账号被停用。不扣积分。
`402`	`insufficient_credits`	余额不足，响应里带 `required` 和 `balance`。不扣积分。
`404`	`not_found`	库里没有这个广告主或域名。这一次会扣分 —— 查询已经执行了。

数据口径、更新节奏和已知局限见数据方法论。接口有问题请联系 [email protected]。