适用于 Meta、Google 和 TikTok 广告的广告库 API

每个搜索都使用同一个密钥、同样的分页方式和同样的错误码，并以 JSON 返回结果。您可以从脚本或自己的应用中调用它，也可以让 AI 智能体通过 MCP 服务器调用。

一个广告库 API，覆盖 Meta 广告、Google 广告和 TikTok

一个密钥即可访问三个广告数据集。Meta 广告涵盖 Facebook 和 Instagram，您可以按文案、品牌或落地页中的文字搜索。Google 广告包括文字、图片和视频广告，可按投放的广告网络（包括 YouTube）筛选。视频广告会链接到 Google 广告透明度中心，在那里播放。TikTok 在一次搜索中同时提供广告和自然帖子，以及它们的播放量、点赞和分享。

每条广告都指向其背后的品牌：广告主主页，以及与之关联的 Shopify 店铺（如有）。因此，您可以用同一个密钥从广告找到店铺，再查看店铺的流量和畅销商品。

完整列表见 API 文档。如果您更愿意点鼠标而不是写代码，同样的搜索也可以在我们的广告监测工具中运行。

获取 API 密钥并发送第一个请求

1. 创建账户，确认您的邮箱，然后选择一个付费套餐：API 从这里开始。
2. 在控制台中打开 API 密钥并创建一个密钥。请立即复制：它只会显示一次。
3. 每次请求都要发送密钥，放在 X-API-Key 请求头中，或作为 bearer token 发送。

下面的请求查找仍在投放的护肤视频广告。所有付费套餐均可使用：

# Search Meta ads
curl "https://api.sellwinners.com/v1/ads?search=skincare&status=active&mediaType=video&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /v1/ads 文档中的参数和字段

返回结果包含一个 requestId、位于 data 下的广告，以及一个 pagination 对象。在每条广告中，media 包含缩略图和视频 URL，content 包含标题、正文、行动号召和落地页，advertiser 是投放它的主页。metrics 统计重复广告数，还提供覆盖人数和预估支出。

Meta 搜索每个品牌只返回一条广告，这样单个广告主不会占满整页。调高 maxAdsPerBrand（最多 15，设为 0 则不设上限），即可看到每个品牌的更多广告。

按名称筛选

Meta 广告支持 111 个具名筛选条件，可以作为 GET 请求的查询参数，或作为 POST 请求的请求体字段发送。常用的有 minDaysRunning、countries、cta 和 minDuplicates。名称拼错时会返回 400 validation_failed，并列出该端点接受的名称，因此拼写错误绝不会返回未经筛选的广告。

# Search Meta ads with advanced filters
curl -X POST "https://api.sellwinners.com/v1/ads/query" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "skincare", "status": "active", "mediaType": "video", "countries": ["US"], "minDaysRunning": 30, "sortBy": "reach", "limit": 10}'

POST /v1/ads/query 文档中的参数和字段

覆盖人数指在欧盟和英国的覆盖人数，支出始终是估算值。

一个品牌的全部广告

用 GET /v1/lookup?q=allbirds.com&type=advertiser 查到该品牌的广告主 id，然后列出它的广告，投放最久的排在前面：

# Meta ads of one advertiser
curl "https://api.sellwinners.com/v1/advertisers/ADVERTISER_ID/ads?sortBy=longestRunning&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /v1/advertisers/{advertiser_id}/ads 文档中的参数和字段

我们的 Meta 广告库搜索页面介绍了网页应用中的这一视图，以及品牌的格式构成和落地页。

结果分页

搜索接收 limit（最多 100），以及 page 或 offset 二者之一。要获取下一页，请重复请求，并把 page 加一，或把 offset 加上 limit。当 hasMore 为 false 时停止。

分页最多可访问一次搜索的前 5,000 条结果（广告主搜索为前 100 条）。要获取更多，请添加筛选条件或更改排序。大多数研究需要的是一份筛选得当的列表的前几页，而不是第 200 页。

各套餐的速率限制和点数

1 点 = 返回 1 个结果：一个品牌的详情、一条广告或列表中的一行。空结果不收费。错误、被拒绝的请求、查询（lookup）和筛选取值都不消耗点数；与 API 一样，MCP 工具调用按返回的结果计费。工作区中的所有成员、其密钥、API 和 MCP 服务器共享同一个点数池和同一个速率限制。每月点数在每月 1 日 00:00 UTC 重置；在账单页面购买的充值点数可以结转。

每个响应都带有 X-RateLimit-Remaining 和 X-Credits-Remaining，X-Usage-Cost 则说明本次调用的花费，这样您的代码可以在被拒绝之前放慢速度。超过每分钟限制时，您会收到 429 rate_limited，并附带以秒为单位的 Retry-After。每月点数和充值点数都用完后，您会收到 402 insufficient_credits，直到点数重置。GET /v1/usage 显示您当前的用量，且不消耗点数。详见速率限制和点数。

通过 MCP 服务器在 AI 智能体中搜索广告

MCP 服务器通过 streamable HTTP 把同样的数据作为工具提供给 AI 智能体，您的 API 密钥放在 X-API-Key 请求头中。我们的 面向 AI 智能体的 MCP 服务器页面提供了服务器 URL，以及适用于 Cursor、VS Code 和 Claude Desktop 的现成配置。

做广告研究时，智能体最常调用的是 search_ads、用于打开单条广告的 scan_ad、search_google_ads_library、search_tiktok_library 和 search_advertisers。您只需用日常语言提问：「查找在美国仍在投放的护肤视频广告，打开投放最久的三条，并列出它们的开头钩子。」智能体会把它转换成筛选条件和调用。套餐规则与 API 相同。

与 Meta 广告资料库 API 有何不同

SellWinners 不是 Meta 的官方 API。它是一项独立服务，与 Meta 没有关联。Meta 有自己的广告资料库 API。在其广告资料库工具页面（其透明度中心中的「Meta Ad Library tools」）上，Meta 表示该 API「可以对有关社会议题、选举或政治的广告，以及投放到欧盟及相关地区的广告进行更深入的分析」，并提到了「获得授权的用户」。我们于 2026年10月19日查阅了该页面。

两者服务于不同的工作。Meta 的 API 由 Meta 运营，遵循 Meta 的规则。SellWinners 则专为电商研究打造：

• 一个密钥即可访问 Meta、Google 和 TikTok 广告，分页、错误和限制规则都相同。
• 广告与其背后的品牌相关联：广告主主页，以及 Shopify 店铺（如有）。
• 帮助您发现持续投放广告的筛选条件：投放天数、重复广告、行动号召和广告排名。
• MCP 服务器，让 AI 智能体替您运行搜索。
• 在欧盟和英国展示的广告的覆盖人数，以及预估支出。

如果您的工作涉及政治或社会议题广告，Meta 自己的 API 正是为此打造的。如果您想了解电商品牌在三个平台上投放了什么，以及广告背后是哪些店铺，这正是 SellWinners 要做的事。

下一步

从一个问题开始，例如哪些护肤品牌让同一条视频连续投放了一个月。先用 curl 运行一次，再把它移到您的代码中。要深入研究某个平台，请打开 TikTok 广告库、Google 广告库或广告主搜索。要关注某个竞争对手，请长期追踪某个品牌的广告。要了解更广的市场，请查看各款广告监测工具对比。

在「探索」中搜索广告