{ "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. $1 per 1,000 ads.", "version": "1.0", "x-build-id": "GGaJrr2tTIay2Xej8" }, "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. Accepted forms:\n- Advertiser name: Nike (the advertiser with the closest name and the most ads is used; see \"Advertisers per name\")\n- Advertiser ID: AR16735076323512287233 (from the advertiser's Transparency Center URL)\n- Domain: nike.com (ads that lead to this website, from any advertiser)\n- Transparency Center URL: an advertiser page, a single ad page (/advertiser/AR.../creative/CR...) or a domain search (?domain=...)\nForce a type with a prefix: name:Booking.com, domain:booking.com, id:AR...", "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 that no other entry of the run returned, so two entries for the same advertiser (e.g. its name and its ID) can return up to twice as many different ads; each ad is returned and charged once. With details and ad text on, the Actor returns about 1,000 ads in 6 minutes, so the default run timeout of 1 hour fits about 9,000 ads: for bigger exports raise \"Timeout\" in the run options. Use a timeout of at least 60 seconds: the Actor stops starting new ads 25 seconds before the timeout, so that it always ends cleanly as succeeded with everything found so far.", "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 } } } } } } } } } }