Google Ads Transparency Center Scraper

The Actor searches the public Google Ads Transparency Center and saves advertiser, creative, and suggestion records as structured dataset items. It is intended for moving from an advertiser name to its identifier, from an identifier to its record, or from a destination domain to creatives that link to it.

Choosing a function

scraperType selects one task. Only the fields needed by the selected task are required; fields belonging to another task can be left empty.

Function	Required input	Saved records
searchAdvertisers	query	Matching advertisers with advertiser_id, advertiser_name, billing_country, and disclosure_country when available.
getAdvertiser	advertiser_id	One advertiser record with disclosed names, verification status, and political-ad disclosure information when available.
searchCreatives	advertiser_id or domain	Creative summaries with identifiers, format, media reference when available, and activity dates.
getCreative	advertiser_id and creative_id	One creative record with media variations, activity dates, served countries, and available impression ranges.
searchSuggestions	query	Advertiser and destination-domain suggestions.

The output identifiers are designed to be reused. A typical sequence starts with searchAdvertisers, uses the returned advertiser_id in searchCreatives, and then passes an advertiser_id and creative_id to getCreative for the fuller creative record.

Example: list an advertiser's creatives

{
  "scraperType": "searchCreatives",
  "advertiser_id": "AR13536189912721653761",
  "ad_format": "image",
  "maxItems": 20
}

Each search result is a single dataset item. Fields not supplied by the source are null or absent; a creative search summary does not contain the detail-only fields returned by getCreative.

The following is a schema-backed illustration, not a verified live response. The AR… and CR… values stand for the identifiers returned by a search. A recorded source smoke-test example is still required before publication.

{
  "advertiser_id": "AR…",
  "creative_id": "CR…",
  "creative_format": "image",
  "media": null,
  "activity_start": null,
  "activity_end": null
}

Search settings and pagination

country narrows searchAdvertisers by the advertiser billing country and accepts a two-letter ISO-3166 code. report_type accepts all or political for advertiser and creative tasks. ad_format, surfaces, sort_key, and descending apply to searchCreatives; sort_key also supports advertiser ordering, with a different set of available choices shown in the input form.

maxItems defaults to 50 for advertiser and creative searches. Pagination stops when that number is saved, when the source has no next page, or when a page contains no records. Setting maxItems to 0 removes the Actor limit, but does not guarantee a fixed number of available records.

An unrecognized advertiser_id, creative_id, or identifier pair completes with an empty dataset rather than a synthetic record. searchCreatives requires at least one of advertiser_id and domain; providing neither ends the run with an input error.

Response fields

Advertiser records use advertiser_id, advertiser_name, billing_country, disclosure_country, advertiser_name_info, report_type, unverified, and political_info when applicable. Creative records use creative_id, creative_format, media or media_variations, activity_start, activity_end, num_served_days, served_country, and impression-range fields such as impressions_min, impressions_max, and country_impression_range when available. Impression values are ranges rather than exact counts.

For a separate list of recent disapproved creative records, use the Google Ads Disapproved Creatives Scraper. It accepts no advertiser or keyword search and is the appropriate Actor when the disapproved-record feed, rather than advertiser or creative discovery, is required.