google_ads_transparency
Search and retrieve Google Ads Transparency Center data by advertiser ID or keyword, filtered by platform, region, date range, and creative format.
Instructions
Pulls ad data from the Google Ads Transparency Center, looked up by advertiser ID or keyword/domain, filterable by platform, region, date range, and creative format. Costs 5 API credits per request. [Credits: 5 API credits per request] Notes: Provide either advertiser_id or text (not necessarily both). political_ads=true requires region to be set. Pagination via next_page_token found in scrapingdog_pagination of the response. Note the endpoint path uses a slash (google/ads_transparency) rather than an underscore, unlike other endpoints in this category. Returns: { search_information: {total_results}, ad_creatives: [{advertiser_id, advertiser, ad_creative_id, format, link, total_days_shown, first_shown, last_shown}], scrapingdog_pagination: {next_page_token} }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| num | No | Maximum number of ad results to return per request. (default: 40) | |
| html | No | Set true to receive raw HTML of the page instead of parsed JSON. (default: false) | |
| text | No | Keyword or domain to search within the Google Ads Transparency Center, equivalent to typing into its search bar. Alternative to advertiser_id; when provided, advertiser_id is not required. | |
| region | No | Numeric region code to limit results to a geographic region, e.g. 2840 for the United States. Omit for global results. | |
| end_date | No | Latest date for returned ads, format YYYYMMDD, e.g. 20221231. To fetch a single day, set end_date to one day after start_date. | |
| platform | No | Filter results to a specific platform. Allowed values: PLAY (Google Play), MAPS (Google Maps), SEARCH (Google Search), SHOPPING (Google Shopping), YOUTUBE (YouTube). Leave blank for all platforms. | |
| start_date | No | Earliest date for returned ads, format YYYYMMDD, e.g. 20221201. | |
| advertiser_id | No | Unique ID assigned to a Google advertiser, found in the Ads Transparency Center URL (e.g. AR17828074650563772417 from https://adstransparency.google.com/advertiser/AR17828074650563772417). Accepts a single ID or comma-separated list. Alternative to `text`. | |
| political_ads | No | Set true to include only political advertisements (tracked/excluded from regular results by default). Must be combined with `region`. (default: false) | |
| creative_format | No | Filter ads by creative type. Allowed values: text, image, video. | |
| next_page_token | No | Token for fetching the next page of results, obtained from the previous response's scrapingdog_pagination.next_page_token. |