给 AI

广告主搜索 API

2 个平台的 2 个接口返回同一种 Advertiser（广告主）对象。按名称搜索公开广告库里的广告主。每次调用 $0.0020；失败不收费。

在 Playground 里跑一次看怎么调登录后运行，用你自己的余额。

平台2 个平台

接口2 个接口每个平台一个

价格$0.0020 起一次。失败不收费

返回Advertiser（广告主）一页 10 到 15 条，带翻下一页的游标

各平台的广告主搜索接口

每个接口一行：叫什么，一次返回多少，一次多少钱。

平台接口一页返回价格

Meta 广告库Meta 广告主搜索GET/v1/meta/advertisers/search15广告主列表$0.0020

Google 广告Google 广告主搜索GET/v1/google/advertisers/search10广告主列表$0.0020

价格是现行价格。失败和结果不确定的调用不收费。看实时状态 →

Advertiser（广告主）对象

上面每个接口返回的都是这些字段，名字和类型都一样。

看这个对象的页面 →

id文本编号，可原样传给“广告主的广告”接口

name文本名称

avatar_url链接头像或标志

region文本广告主登记的国家或地区代码

哪个平台有哪个字段

接口给不了的字段，每次返回都会写在 meta.unavailable 里，所以缺字段不会是意外。

平台avatar_urlregion

Meta 广告库

Google 广告

同一次调用，换一个平台

同样的参数名，同样的翻页，同样的返回。变的只有路径。

cURLTypeScriptPython命令行

# Meta 广告库
curl -G "https://api.dataxapi.com/v1/meta/advertisers/search" \
  --data-urlencode "query=puma" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

# Google 广告：只改一个词
curl -G "https://api.dataxapi.com/v1/google/advertisers/search" \
  --data-urlencode "query=nike" \
  -H "Authorization: Bearer $DATAXAPI_API_KEY"

// Meta 广告库
import { DataXAPI } from "@dataxapi/sdk";

const dx = new DataXAPI(); // reads DATAXAPI_API_KEY
const result = await dx.meta.advertisers.search({ query: "puma" });
console.log(result.data.items);

// Google 广告：只改一个词
const other = await dx.google.advertisers.search({ query: "nike" });
console.log(other.data.items);

# Meta 广告库
from dataxapi import DataXAPI

dx = DataXAPI()  # reads DATAXAPI_API_KEY
result = dx.meta.advertisers.search(query="puma")
print(result["data"]["items"])

# Google 广告：只改一个词
other = dx.google.advertisers.search(query="nike")
print(other["data"]["items"])

# Meta 广告库
dataxapi call meta.advertisers.search query=puma

# Google 广告：只改一个词
dataxapi call google.advertisers.search query=nike

200 · application/json · 扣 $0.0020

{
  "code": "ok",
  "request_id": "f0edf122-e137-45dc-a006-e92f5a4e8d1a",
  "data": {
    "items": [
      {
        "id": "109302004765630",
        "name": "Lumen Outdoor",
        "avatar_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/487718865_122396809446085_n.jpg"
      },
      // … 另有 14 条
    ]
  },
  "page": {
    "next_cursor": null,
    "cursor_expires_at": null,
    "has_more": false,
    "returned": 15
  },
  "warnings": [],
  "meta": {
    "capability": "meta.advertisers.search",
    "result_status": "complete",
    "fetched_at": "2026-10-12T21:44:03.000Z",
    "cached": false,
    "replayed": false,
    "unavailable": { "region": "capability" },
    "billing": {
      "amount": "0.002",
      "currency": "USD",
      "balance_after": "9.998"
    }
  }
}