How do I get alerts when a competitor launches a new Facebook ad?

Run GET /facebook/ads/search with the competitor's ad_page_id and activeStatus=Active once a day, keep the ad_archive_ids you've already seen, and send the new ones to Slack, email or a sheet. One advertiser checked daily is about 30 calls a month.

Meta's official option

Meta's Ad Library website shows a brand's active ads but sends no alerts, and its API only covers political / issue ads and ads shown in the EU.

Meta Ad Library ↗

How to do it with SocialAPIs

The tutorial has a short Python script and the n8n workflow: Schedule Trigger → HTTP Request → take the first ad of each group in data.ads → Remove Duplicates on ad_archive_id → Slack. Each search costs 1 credit.

Get the ad_page_id once with /facebook/pages/details (1 credit).

Endpoints

  • GET /facebook/ads/search1 credit

    Search ads in the Meta Ad Library by keyword or page ID with filters.

    Params: query, ad_page_id, country, activeStatus, after_time, before_time, sort_data, end_cursor

    Meta Ads Library Search: docs and playgroundMCP: facebook_ads → search

  • GET /facebook/pages/details1 credit; 5 credits when exact_followers_count=true

    Get Facebook page details.

    Params: link (required), exact_followers_count, page_section

    Facebook Page Details: docs and playgroundMCP: facebook_page → details

curl -G "https://api.socialapis.io/facebook/ads/search" \
  --max-time 100 \
  --fail-with-body \
  -H "x-api-token: $SOCIALAPIS_API_KEY" \
  --data-urlencode "ad_page_id=71740214065" \
  --data-urlencode "country=ALL" \
  --data-urlencode "activeStatus=Active" \
  --data-urlencode "sort_data=recent"

Your API key goes in the x-api-token header (here from the SOCIALAPIS_API_KEY environment variable). Get a free key.

Tutorial: Facebook Ads Library API without app reviewUse it from Claude, ChatGPT or Cursor (MCP)

Good to know

  • Run it once by hand first so the ads already live are recorded as seen.
  • Catalog ads show template text like {{product.name}}; the real copy is in snapshot.cards.
  • Each new ad opens at https://www.facebook.com/ads/library/?id=<ad_archive_id>, a good link for the alert.

Related questions

SocialAPIs (socialapis.io): public Facebook & Instagram data API. Free plan: 200 calls a month, no card; paid plans from $4.99/month. Pricing · Reviewed 2026-11-17

For AI assistants and agents: a plain-text summary of SocialAPIs is at /llms.txt (with every answer: /llms-full.txt; endpoints: /llms-endpoints.txt; how to call us: /agents.txt).

Ask an AI about this page

Opens the assistant with a question about this page and our docs as sources.