{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper — Ads by Domain", "description": "Scrape Google Ads Transparency Center: all ads of an advertiser or domain with creative ID, format, preview, first/last shown. Region & date filters.", "version": "1.0", "x-build-id": "YTfssGEh9rp75POM2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cheapapi~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cheapapi-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/cheapapi~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-cheapapi-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/cheapapi~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-cheapapi-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": { "mode": { "title": "What do you want to get?", "enum": [ "ads", "presence", "advertisers" ], "type": "string", "description": "Ads: every ad of an advertiser or domain. Only check: one row per line with hasAds, total ads, formats and first/last shown dates, charged as one check ($0.0028) per checked line, with or without ads. Find advertisers: search the Transparency Center for advertiser accounts (e.g. to get their advertiser IDs).", "default": "ads" }, "targets": { "title": "Domains, advertiser names or advertiser IDs", "type": "array", "description": "One per line. Accepts a domain (nike.com), an advertiser name (Nike, Inc.; needs one extra lookup, charged as a check of $0.0028), an advertiser ID (AR13752565271262920705) or a link from adstransparency.google.com (advertiser page or domain search). In \"Find advertisers\" mode, enter names or domains to search for. Required (the run stops with a clear message if it is empty) unless you set a Source dataset ID (Advanced).", "items": { "type": "string" } }, "maxAdsPerTarget": { "title": "Maximum ads per advertiser or domain", "minimum": 1, "maximum": 700, "type": "integer", "description": "Stop after this many ads for each line (most recent first as ordered by Google). Up to 700. Not used in \"Only check\" mode, which always looks at the 40 most recent ads.", "default": 100 }, "region": { "title": "Region (where the ads were shown)", "enum": [ "anywhere", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "BQ", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "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", "KP", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TM", "TC", "TV", "TR", "UM", "VI", "UG", "UA", "AE", "GB", "US", "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.", "default": "anywhere" }, "platform": { "title": "Platform", "enum": [ "all", "googleSearch", "youtube", "googleShopping", "googleMaps", "googlePlay" ], "type": "string", "description": "Only ads shown on this Google platform.", "default": "all" }, "adFormat": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only ads of this format.", "default": "all" }, "dateFrom": { "title": "Shown from", "type": "string", "description": "Only ads shown on or after this date (YYYY-MM-DD, not earlier than 2018-05-31). If you set only one date, the other one is filled in automatically." }, "dateTo": { "title": "Shown until", "type": "string", "description": "Only ads shown on or before this date (YYYY-MM-DD)." }, "location": { "title": "Region by name (overrides Region)", "type": "string", "description": "Full location name instead of the Region list, e.g. United Kingdom or London,England,United Kingdom. Leave empty to use Region." }, "coordinates": { "title": "Coordinates (overrides Region)", "type": "string", "description": "Latitude,longitude, e.g. 52.52,13.405. The ads shown in the region around this point are returned. Overrides Region and Region by name." }, "targetType": { "title": "Treat every line as", "enum": [ "auto", "domain", "advertiserId", "advertiserName" ], "type": "string", "description": "Automatic detection works for almost everything. Force \"Advertiser name\" for names that look like domains (e.g. Booking.com as an advertiser name).", "default": "auto" }, "advertiserNameMatch": { "title": "Advertiser name matching", "enum": [ "best", "all" ], "type": "string", "description": "For advertiser names: which advertiser accounts to list ads for. Big brands often run several accounts; \"All\" combines them.", "default": "best" }, "combineAdvertiserIds": { "title": "Combine advertiser IDs into one list", "type": "boolean", "description": "Collect the ads of up to 25 advertiser IDs together as a single list (one search instead of one per ID). \"Maximum ads\" then applies to the combined list.", "default": false }, "sourceDatasetId": { "title": "Source dataset ID", "type": "string", "description": "Optional. Pick (or paste the ID of) an Apify dataset from an earlier run — for example a list of companies with a website column, or an earlier run of this Actor. From each row the Actor takes advertiserId (or advertiserIds), otherwise the first domain found in domain, website or url. Values are merged with the lines above and duplicates are removed. Up to 50,000 rows are read; rows without a domain or advertiser ID are skipped and counted in the run summary." }, "onlyNewAds": { "title": "Only new ads since the last run", "type": "boolean", "description": "Ads mode only. Remembers the creative IDs delivered for each advertiser/domain and delivers only ads that were not delivered before. Repeats are not delivered; each fetched repeat costs one ad check ($0.0001), and a line without new ads costs one check ($0.0028) plus its ad checks. The first run delivers everything. Schedule the same input daily or weekly to get just the new creatives.", "default": false }, "monitoringName": { "title": "Monitoring name", "type": "string", "description": "Each name keeps its own list of seen ads. Use one name per watch list (e.g. competitors-us) so separate schedules do not affect each other. Max 100 characters.", "default": "default" }, "processingSpeed": { "title": "Processing speed", "enum": [ "auto", "instant", "fast", "standard" ], "type": "string", "description": "How each search is processed. All speeds have the same price. Runs with up to 20 searches are always processed instantly. Automatic is best for almost every run.", "default": "auto" }, "maxWaitMinutes": { "title": "Maximum wait", "minimum": 1, "maximum": 120, "type": "integer", "description": "Searches not finished within this time are reported in the run summary. They may already have been processed, so each costs one check ($0.0028), plus $0.0001 per requested ad in Ads mode.", "default": 60 } } }, "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 } } } } } } } } } }