Google Ad Library API
发现公开广告主、采集公司的创意，或通过 URL 获取一条已知 Transparency Center 创意，用于研究和审阅。
可用的 Google Ad Library API
使用 Advertiser Search 查找候选广告主，使用 Company Ads 采集有上限的创意集合，使用 Ad Details 解析一个准确公开创意 URL。
可以获取哪些 Google 广告透明数据？
SocQ 标准化可用的公开 Transparency Center 字段，并把来源未提供的值保留为空。
广告主发现
按 query 查找候选广告主身份、网站、徽标、地区和可用广告数量字段。
创意与目标链接
采集可用文本、广告主引用、格式、媒体素材和落地页目标链接。
公开投放上下文
保留可用日期、国家、Google 界面和可安全标准化的展示次数。
SocQ 与 Google Ads 产品对比
SocQ 标准化受支持的公开透明记录；需要授权账号与广告活动操作时，应使用相应 Google Ads 产品。
| 能力 | SocQ | Google Ads 产品 |
|---|---|---|
| 主要用途 | 发现并标准化公开透明记录 | 管理已授权广告账号和广告活动 |
| 输入 | query、公司标识与筛选，或准确创意 URL | 对应产品的账号、活动或报告输入 |
| 鉴权 | SocQ API key | 对应产品的 Google 凭据与授权 |
| 响应格式 | 标准化公开广告主和广告记录 | 对应产品的原生响应 |
Google Ad Library API 如何工作
三个端点都使用 SocQ 的异步提交、轮询和结果读取流程。
1. 选择端点
向 Advertiser Search 提交 query，向 Company Ads 提交域名或广告主 ID，或向 Ad Details 提交一个创意 URL。
2. 提交并跟踪任务
POST 请求、保存 task_id，并轮询 /v1/tasks/{task_id} 直到处理结束。
3. 读取标准化结果
处理 data.results.items；Company Ads 遵循请求上限，Ad Details 最多返回一条。
使用 SocQ API key 鉴权，并提供公司域名或广告主 ID。默认结果上限为 40。
curl -X POST "https://api.socq.ai/v1/google-ad-library/company-ads" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain":"lululemon.com","results_limit":40}'
# 另有：
# POST /v1/google-ad-library/advertiser-search
# POST /v1/google-ad-library/ad
# 轮询 GET /v1/tasks/{task_id}常见 Google Ad Library API 使用场景
发现广告主
先把品牌或网站 query 解析为公开广告主候选，再采集广告。
公司创意研究
使用可选主题、地区、日期、Google 界面和格式筛选采集有上限的公开创意集合。
补全选定创意
用广告主、文本、媒体、目标链接和投放字段完善已知创意记录。
限制与公开数据政策
结果取决于当前公开来源可见性，不提供私有 Google Ads 账号数据。
- Advertiser Search 需要一个 query，可接受可选 region；它没有 results_limit 输入。
- Company Ads 需要 domain 或 advertiser_id，并接受 40 到 2,000 之间的 40 倍数 results_limit。
- Ad Details 需要一个路径包含 /creative/ 的 adstransparency.google.com URL，最多返回一条记录。
- 公开记录可能不完整，也不提供私有预算、点击、转化、出价、受众或广告支出回报。
Google Ad Library API 常见问题
应该先使用哪个端点？
只知道品牌或网站时使用 Advertiser Search；已有域名或广告主 ID 时使用 Company Ads；已有准确创意 URL 时使用 Ad Details。
可以筛选公司广告吗？
可以。可选控制包括主题、地区、日期范围、Google 界面、格式和有上限的 results_limit。
这些 API 可以访问私有广告活动表现吗？
不可以。它们处理公开透明记录，不提供私有账号或广告活动分析。
结果如何计费？
每条返回记录消耗 0.5 SocQ 积分，空结果没有当前配置的基础费用。
结合多平台数据，获得更完整的业务洞察
将不同平台的公开账号、内容与互动数据统一起来，帮助你持续跟踪品牌、达人和话题表现，更高效地完成跨平台监测与分析。
Google Maps API
发现公开地点、按已知 Maps URL 获取标准化详情，并采集带来源地点与作者上下文的公开评价。
Kwai API
获取公开 Kwai 主页、一页账号帖子或一个已知帖子，返回标准化身份、内容、媒体、时间和可见互动数据。
Truth Social API
获取公开账号详情、采集一页账号帖子，或通过已知帖子 URL 获取标准化记录。
LinkedIn API
通过已知 URL 获取公开 LinkedIn 个人主页、公司、帖子和职位数据，并返回标准化身份、职业、企业、内容、互动和职位字段。
Reddit API
通过已知 URL 获取公开 Reddit 帖子和评论，浏览 subreddit 中的 new、top 或 hot 帖子，或按关键词和发布时间搜索讨论。
Rednote API
获取公开账号和笔记，搜索笔记或用户，采集评论与嵌套回复，并记录一页首页推荐。