Social Fetch icon

Social Fetch

Fetch social media and web data via the Social Fetch API

Actions129

Facebook → Company Ads

AI-generated

Summary

Searches Facebook company or page ads using the configured filters, returning the first page or paginating through all results.

Inputs

  • Return All — Defaults to false. Enable to follow page cursors and return results from all pages; each page consumes API credits.
  • Page ID — Facebook page ID to search. Use this when available instead of a company name.
  • Company Name — Company or page name to search when you do not have a page ID.
  • Country — Optional country code filter; use ALL to search all countries.
  • Status — Optional ad status filter: All, Active, or Inactive. Defaults to All.
  • Media Type — Optional creative media filter: All, Image, Video, Meme, Image and Meme, or None. Defaults to All.
  • Language — Optional language code filter.
  • Sort By — Sort order for returned ads: Impressions or Most Recent. Defaults to Impressions.
  • Start Date — Optional start date filter in YYYY-MM-DD format.
  • End Date — Optional end date filter in YYYY-MM-DD format.

Output shape

A list of ad items, with one item per result.

With Return All disabled, returns results from the first page only. When enabled, follows next cursors until no more pages remain; each page consumes API credits. Request Options can configure batching, SSL certificate handling, proxy, and timeout.

Links

Discussion