{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Advertisers, Ads & Creatives", "description": "Scrape every ad an advertiser runs on Google from the Ads Transparency Center: search by brand name, advertiser ID or domain, filter by country, date, format and platform. Get ad images, YouTube links, first/last shown dates, regions, EU reach and ad text where Google shows it. $2 per 1,000 ads.", "version": "1.0", "x-build-id": "Yy4N9FmnK57nbOXU4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fairfetch~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fairfetch-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/fairfetch~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-fairfetch-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/fairfetch~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-fairfetch-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", "required": [ "advertisers" ], "properties": { "advertisers": { "title": "Advertisers, domains or URLs", "type": "array", "description": "One entry per line: an advertiser name (Nike; the closest name with the most ads is used, see \"Advertisers per name\"), an advertiser ID (AR16735076323512287233, from the advertiser's Transparency Center URL), a domain (nike.com: ads that lead to that site, from any advertiser) or a Transparency Center URL (an advertiser page, a single ad or a ?domain= search). Force a type with a prefix: name:Booking.com, domain:booking.com or id:AR16735076323512287233.", "items": { "type": "string" } }, "region": { "title": "Region (country)", "enum": [ "anywhere", "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "BQ", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CK", "CR", "CI", "HR", "CW", "CY", "CZ", "CD", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "XK", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "CG", "RE", "RO", "RW", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "TW", "TJ", "TZ", "TH", "BS", "GM", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "VI", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW" ], "type": "string", "description": "Only ads shown in this country. \"Anywhere\" returns ads from all regions. With a country set, impressionsMin/Max are the times shown in that country (Google publishes them only for EU / EEA countries and Türkiye; elsewhere they stay empty).", "default": "anywhere" }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Only ads shown on or after this date (US Pacific time, like the website). A date (2026-01-31) or a relative period (\"30 days\", \"6 months\"). Leave empty for any time." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Only ads shown on or before this date. Leave empty for today." }, "adFormat": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Text ads (Search), image ads (display, Shopping) or video ads (YouTube).", "default": "all" }, "platform": { "title": "Google platform", "enum": [ "all", "google_search", "youtube", "google_shopping", "google_maps", "google_play" ], "type": "string", "description": "Only ads shown on this Google platform. Google records platforms for ads shown since 4 Sep 2023; older ads are left out when a platform is selected.", "default": "all" }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 0, "maximum": 50000, "type": "integer", "description": "Maximum number of ads returned per advertiser (per domain for domain entries), most recently shown first. 0 = no limit (up to 50,000). Each entry returns up to this many ads no other entry of the run returned, and each ad is charged once. With details and ad text on, about 1,000 ads take 6 minutes; 100 ads about 40-70 seconds. Use a run timeout of at least 60 seconds (the Actor stops 25 seconds before it and keeps everything found); raise it above 1 hour for more than about 9,000 ads.", "default": 100 }, "includeDetails": { "title": "Include ad details", "type": "boolean", "description": "One extra request per ad for all variations, every region the ad ran in with its last shown date, and for ads shown in the EU / EEA or Türkiye the number of times shown (in total and per country, also per platform), the topic and the audience selection. Ads whose details Google does not return are left out and not charged. Included in the price.", "default": true }, "decodePreviews": { "title": "Extract ad text, images and video links", "type": "boolean", "description": "Decode Google's ad preview to get the ad text (headline, description, product title), image URLs and the YouTube video of most video ads (some previews carry no video ID). Google renders text for only about 1 in 10 ads; most text ads come as a picture only (previewImageUrl). One extra request per ad that has a preview. Included in the price.", "default": true }, "maxAdvertisersPerName": { "title": "Advertisers per name", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many advertisers to take for each advertiser name (brands often have several accounts, e.g. per country). The best matches with the most ads come first. The rows and the run summary name the advertisers whose ads were returned.", "default": 1 }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "Requests in flight at the same time. Higher is faster but more likely to be throttled by Google.", "default": 4 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 5, "maximum": 120, "type": "integer", "description": "Timeout for a single HTTP request.", "default": 30 }, "maxRetries": { "title": "Max retries per request", "minimum": 0, "maximum": 10, "type": "integer", "description": "Retries for network errors, HTTP 5xx and Google throttling. With a proxy, every throttled retry uses a new IP address.", "default": 5 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "On by default (Apify residential proxy, included in the price): Google blocks IP addresses that send many requests to the Transparency Center (CAPTCHA page). Blocked requests are retried on a new IP. Turning it off is only advised for small local runs.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }