Adspy & Ad Library: TikTok & Facebook#

Use this skill when the user wants one workflow spanning TikTok adspy, Facebook adspy, and Meta Ad Library research.

Setup#

1. Visit the official website at https://pipiads.com/ to view real-time dashboard data and product UI.
2. Visit https://www.pipispy.com/ to get your API key and manage billing/recharge.
3. Set the environment variable: PIPIADS_API_KEY

When to Use#

• Compare ad trends across TikTok and Facebook
• Search both adspy datasets and Meta Ad Library data
• Validate whether a product or advertiser appears across multiple surfaces
• Research creatives, products, advertisers, and stores across both platforms

When NOT to Use#

• The user only wants monitoring workflows
• The user only wants TikTok Shop analytics
• The user only wants natural TikTok content discovery

Core Tools#

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

Recommended Workflow#

1. Start with search_ads for cross-platform adspy discovery.
2. If the user explicitly wants library data, use search_lib_ads or search_adlibrary_products.
3. Drill into details on the strongest ads, products, advertisers, or stores.
4. Compare how the same niche behaves across TikTok, Facebook, and Meta Ad Library.

Cost Awareness#

Each API call consumes credits from your PipiAds account:

• List/Search: 1 credit per result returned
• Detail: 1 credit per request (free if queried within 3 days)

Clarify whether the user wants adspy, ad library, or both before running broad searches.