Social Fetch icon

Social Fetch

Fetch social media and web data via the Social Fetch API

Actions129

Facebook → Ad Library Search

AI-generated

Summary

Search Facebook Ad Library ads using a required query and optional filters. Choose whether to fetch only the first page or paginate through all results; each page consumes API credits.

Inputs

  • Query (required) — Text to search for in Facebook Ad Library ads.
  • Return All — When enabled, follows pagination to return results from all pages; otherwise returns only the first page. Each page consumes API credits.
  • Additional Fields — Optional filters: sort by impressions or most recent; choose keyword unordered or exact phrase matching; filter by ad type, country code (use ALL for all countries), status, media type, or start and end dates in YYYY-MM-DD format. Trim reduces the response fields.
  • Request Options — Optional batching, SSL certificate validation, proxy, and request timeout settings.

Output shape

a list of matching ads

With Return All disabled, results are limited to the first page; enabling it paginates through available pages.

Links

Discussion