hirepulse/google-ads-transparency-scraper
hirepulse--google-ads-transparency-scraperDestructive
This tool calls the Actor "hirepulse/google-ads-transparency-scraper" and retrieves its output results. Actor description: Scrape Google Ads Transparency Center records by company domain: ad creatives, formats, advertisers and first/last shown dates when available. Export JSON for competitor ad research, brand monitoring, n8n, Make and Apify MCP. Includes bulk domains and summary options.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | "ads": one record per ad (advertiser, format, first and last shown dates, preview and transparency links). "summary": one compact record per domain (runs_google_ads, total_ads, formats, advertisers, latest ad), charged per domain only, and domains without ads are free; best for lead lists and AI agents. Default: "ads". For a cheap agent check use mode="summary" with one domain. For an ad sample use mode="ads" and max_ads_per_domain=1. Example values: "ads" | ads |
| format | No | Only ads of this format: "all", "text", "image" or "video". Default: "all". Example values: "all" | all |
| country | No | Only ads shown in this country, as a two-letter ISO code. Example: "US", "GB" or "DE". Leave empty for ads shown in any country. | |
| date_to | No | Only ads shown on or before this date, YYYY-MM-DD. Example: "2026-09-30". Optional. | |
| domains | Yes | **REQUIRED** Required. Company websites, one per item, up to 100 per run. Full URLs are fine too. Example: ["nike.com", "adidas.com"]. Results include every advertiser whose ads lead to the domain, not only the brand itself. Example values: ["nike.com"] | |
| platform | No | Only ads shown on this Google platform: "all", "google_search", "youtube", "google_shopping", "google_play" or "google_maps". Default: "all". Example values: "all" | all |
| waitSecs | No | Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget. | |
| date_from | No | Only ads shown on or after this date, YYYY-MM-DD. Example: "2026-09-01". Set together with date_to. Optional. | |
| only_new_ads | No | Return only ads that your earlier runs did not return yet, for the same domain and filters (remembered in your own Apify account). Use it with a daily or weekly schedule to monitor new competitor ads. The per-domain fee still applies when the domain runs ads, even if none of them is new. Default: false. | |
| use_paid_upstream | No | Off by default. Supported paid sources also require the owner-controlled HIREPULSE_ALLOW_PAID_UPSTREAM=1 environment setting. Keep false for all quality and smoke checks. | |
| max_ads_per_domain | No | Ads mode only: most recent ads to return per domain, 1 to 120. Each returned ad is one charged result. Default: 3. For a cheap agent check use mode="summary" with one domain. For an ad sample use mode="ads" and max_ads_per_domain=1. Example values: 3 |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | Advisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key | |
| runId | Yes | Actor run ID | |
| stats | No | Run statistics | |
| status | Yes | Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED | |
| actorId | Yes | Stable Apify Actor ID from the run record | |
| summary | Yes | Past-tense summary of the run state | |
| exitCode | No | Actor process exit code; populated for terminal states (especially FAILED) | |
| nextStep | Yes | One primary follow-up action with identifiers interpolated | |
| storages | Yes | Dataset and key-value store metadata, keyed by alias. "default" is always the primary entry. | |
| actorName | No | "username/actor-name" | |
| startedAt | No | ISO timestamp when the run started | |
| finishedAt | No | ISO timestamp when the run finished (terminal states only) | |
| statusMessage | No | Pass-through from Apify run.statusMessage | |
| apifyConsoleUrl | No | Personalized Apify Console link to the run; present only for Console sessions |