Adspy 与 Ad Library：TikTok 与 Facebook

当用户需要一个涵盖 TikTok Adspy、Facebook Adspy 及 Meta Ad Library 研究的统一工作流时，使用此技能。

配置

1. 访问官网 https://pipiads.com/ 查看实时仪表盘数据及产品 UI。
2. 访问 https://www.pipispy.com/ 获取您的 API 密钥，并管理账单与充值。
3. 设置环境变量：PIPIADS_API_KEY

适用场景

• 对比 TikTok 与 Facebook 上的广告趋势
• 同时检索 Adspy 数据集与 Meta Ad Library 数据
• 验证某款产品或广告主是否在多个平台（surfaces）上出现
• 跨平台研究创意素材（creatives）、产品、广告主及店铺

不适用场景

• 用户仅需监控类工作流
• 用户仅需 TikTok Shop 分析数据
• 用户仅需自然流量下的 TikTok 内容发现

核心工具

Adspy

• search_ads
• get_ad_detail
• search_products
• get_product_detail
• search_advertisers
• get_advertiser_detail
• search_stores
• get_store_detail

Ad Library

• search_lib_ads
• get_lib_ad_detail
• search_adlibrary_products
• get_adlibrary_product_detail
• get_store_ad_trend
• get_store_delivery_analysis
• get_store_longest_run_ads
• get_store_most_used_ads
• get_store_fb_pages

推荐工作流

1. 从 search_ads 入手，进行跨平台 Adspy 广告发现。
2. 若用户明确需要 Ad Library 数据，则调用 search_lib_ads 或 search_adlibrary_products。
3. 深入分析表现最突出的广告、产品、广告主或店铺的详情。
4. 对比同一细分领域（niche）在 TikTok、Facebook 以及 Meta Ad Library 上的行为差异。

费用意识

每次 API 调用均消耗 PipiAds 账户中的积分：

• 列表/搜索类接口（List/Search）：每返回一条结果消耗 1 积分
• 详情类接口（Detail）：每次请求消耗 1 积分（若在 3 天内重复查询同一资源则免费）

在执行大范围搜索前，请先向用户确认其需求是 Adspy、Ad Library，还是两者皆需。