Social Fetch icon

Social Fetch

Fetch social media and web data via the Social Fetch API

Actions129

Google → Company Ads

AI-generated

Summary

Fetches company ads from Google’s Ad Transparency Center, using a domain or advertiser ID and optional filters. Enable Return All to follow pagination and retrieve every page; each page uses API credits.

Inputs

  • Return All — Defaults to false and returns only the first page. Enable to paginate through all results; each page consumes API credits.
  • Domain — Company domain to search when you do not have an advertiser ID.
  • Advertiser ID — Google Ad Transparency advertiser ID to search when you have one instead of a domain.
  • Topic — Filter by all topics (default) or political ads. The political topic requires a Region.
  • Region — Optional two-letter country code; required when Topic is political.
  • Start Date — Optional start date filter in YYYY-MM-DD format.
  • End Date — Optional end date filter in YYYY-MM-DD format.
  • Platform — Optional Google surface filter: Google Maps (default), Google Play, Google Search, Google Shopping, or YouTube.
  • Format — Optional creative format filter: text, image, or video.

Output shape

A list of ad result items.

With Return All enabled, results are accumulated across cursor-paginated pages until no more pages remain. The supplied source pack exposes the pagination behavior but omits the request and response implementation, so it does not establish the exact fields in each result.

Examples

Example 1: Using an advertiser ID

Provide Advertiser ID, leave Domain blank, and optionally filter by topic, region, dates, platform, or format.

Example 2: Using a company domain

Provide Domain when no advertiser ID is available.

Links

Discussion