{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Competitor Ads & Ad Copy", "description": "Scrape the Google Ads Transparency Center by brand, website or advertiser: every ad with format, dates, days running, countries, EU reach and the ad copy Google exposes (headlines, Shopping products, YouTube videos). Fast and cheap, no login.", "version": "0.1", "x-build-id": "tz2vnRzgZRXl5vdID" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ragequit~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ragequit-google-ads-transparency-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ragequit~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-ragequit-google-ads-transparency-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ragequit~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-ragequit-google-ads-transparency-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchQueries": { "title": "Brands or websites", "type": "array", "description": "Brand names (Nike, HelloFresh) or websites (nike.com). Websites return every ad that points to that domain; brand names are matched to advertiser accounts, like the search box of the Ads Transparency Center.", "items": { "type": "string" } }, "domains": { "title": "Exact domains", "type": "array", "description": "Optional. Domains to look up exactly as typed, for example shop.example.com.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Optional. Advertiser IDs starting with AR, as in the URL of an advertiser page (adstransparency.google.com/advertiser/AR...).", "items": { "type": "string" } }, "startUrls": { "title": "Ads Transparency Center URLs", "type": "array", "description": "Optional. Paste advertiser, ad (creative) or domain search URLs from adstransparency.google.com. Region, platform and format in the URL are respected.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxAdvertisersPerQuery": { "title": "Advertisers per brand name", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many matching advertiser accounts to scrape for each brand name. Big brands often run ads from several accounts.", "default": 3 }, "region": { "title": "Country", "type": "string", "description": "Only ads shown in this country: a two-letter code (US, GB, DE...) or an English country name. Use \"anywhere\" for all countries.", "default": "US" }, "platforms": { "title": "Platforms", "type": "array", "description": "Only ads shown on these Google platforms. Leave empty for all. Google applies this filter to ads shown since September 2023.", "items": { "type": "string", "enum": [ "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "enumTitles": [ "Google Search", "YouTube", "Google Shopping", "Google Maps", "Google Play" ] }, "default": [] }, "adFormat": { "title": "Ad format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format.", "default": "ALL" }, "startDate": { "title": "Shown since", "type": "string", "description": "Only ads shown on or after this date (YYYY-MM-DD). Google supports roughly the last 12 months." }, "endDate": { "title": "Shown until", "type": "string", "description": "Only ads shown on or before this date (YYYY-MM-DD)." }, "maxAdsPerTarget": { "title": "Max ads per brand, domain or advertiser", "minimum": 0, "type": "integer", "description": "Stop after this many ads for each target. 0 means all of them (big brands have thousands).", "default": 100 }, "includeDetails": { "title": "Include ad details and ad copy", "type": "boolean", "description": "Fetch each ad's detail page: all variations, every country it ran in with dates, reach (impressions) where Google publishes it (EU), and the ad text Google exposes (headline, description, display URL, Shopping product title, YouTube video). Slower, billed as a separate event.", "default": true }, "onlyNewAds": { "title": "Only new ads (monitoring)", "type": "boolean", "description": "Return only ads not seen in earlier runs. The first run returns everything and remembers it; later scheduled runs return just newly launched ads. Seen ads are kept in a named key-value store in your account.", "default": false }, "monitorStoreName": { "title": "Monitoring store name", "type": "string", "description": "Name of the key-value store that remembers seen ads. Use a different name for each separate monitor.", "default": "ads-transparency-monitor" }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many ad details to fetch at the same time.", "default": 5 }, "maxRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 20, "type": "integer", "description": "How many times to retry a request on a new IP address when Google rate-limits it.", "default": 6 }, "residentialFallback": { "title": "Switch to residential proxies when rate-limited", "type": "boolean", "description": "Start on cheap datacenter IPs and move to Apify residential proxies for the rest of the run if Google rate-limits them. Only applies when you use Apify datacenter proxies.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "The Ads Transparency Center rate-limits single IPs. Apify's datacenter proxies work well and are the cheapest option.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }