Captapi

Structured social media data from 32 platforms (YouTube, TikTok, Instagram, Facebook, X, Reddit, Threads, Bluesky, Pinterest, LinkedIn, Rumble, Truth Social, Kick, Kwai, Komi, Pillar, Linkbio, Linkme, Amazon Shop) — transcripts, AI summaries, comments, stats, search and downloads.

Actions171

Facebook Ad Library → Facebook Ad Library Search

AI-generated

Summary

Searches Meta’s Ad Library for a required keyword, brand, or advertiser and returns matching ads. Use optional filters to narrow results by country, delivery status, media type, publisher platform, ad type, search mode, sort order, and delivery start dates; use the cursor to page through the current result batch.

Inputs

  • Query (required) — Keyword, brand, or advertiser to search for; at least 2 characters.
  • Country — Two-letter ISO country code; defaults to US.
  • Limit — Maximum items to return; defaults to 20 and supports up to 200.
  • Status — Ad delivery status: ACTIVE (default), INACTIVE, or ALL.
  • Media Type — Creative filter: ALL (default), IMAGE, VIDEO, MEME, IMAGE_AND_MEME, or NONE.
  • Platforms — Comma-separated publisher platforms to keep: FACEBOOK, INSTAGRAM, MESSENGER, AUDIENCE_NETWORK, or THREADS.
  • Ad Type — Use all (default) or political_and_issue_ads. Spend and impression data is typically populated only for political or issue ads.
  • Search Type — Use keyword_unordered (default) or keyword_exact_phrase.
  • Sort By — Meta sort mode: total_impressions or relevancy_monthly_grouped.
  • Start Date — Include ads whose delivery started on or after this date (YYYY-MM-DD).
  • End Date — Include ads whose delivery started on or before this date (YYYY-MM-DD).
  • Cursor — Pagination cursor from a previous nextCursor, for paging through the current Meta HTML result batch.
  • Trim — When true, omits the cards, images, and videos typed arrays; media[] remains.
  • Cache — When true, serves a response from the 24-hour cache when available; cache hits cost 0 credits and include cached and cachedAt in the envelope. Defaults to false, which fetches fresh data.

Output shape

A response envelope containing matching ad results and pagination information.

Cache hits include cached and cachedAt. The supplied source pack exposes no implementation details beyond the execute method signature, so the precise result fields and pagination envelope are not shown.

Links

Discussion