{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Every Ad by Site", "description": "Google Ads Transparency Center ads by website, advertiser or name, to the last page, in 216 regions. $1 per 1,000 ads. Format, dates shown, image, ids.", "version": "0.1", "x-build-id": "kpt1VoBVpuvsBjSfp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/luzivanlt~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-luzivanlt-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/luzivanlt~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-luzivanlt-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/luzivanlt~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-luzivanlt-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": { "domains": { "title": "Websites", "type": "array", "description": "Websites whose ads you want, as the Transparency Center searches them: every advertiser that ran ads for the site and its subdomains (e.g. \"nike.com\"). A full link such as https://www.nike.com/ is read as nike.com. One search per website, using the Region and filters below.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser ids", "type": "array", "description": "Advertiser ids from the Transparency Center, AR and 20 digits, as in an advertiser page link (e.g. \"AR16735076323512287233\"). One search per id: every ad that advertiser ran in the Region, with the filters below.", "items": { "type": "string" } }, "advertiserNames": { "title": "Advertiser names", "type": "array", "description": "Names to look up, as you would type them in the Transparency Center search box (e.g. \"Nike\"). Each name reads the matching advertisers with the most ads, up to Max advertisers per name, with each advertiser's country and ad count on its rows.", "items": { "type": "string" } }, "startUrls": { "title": "Transparency Center links", "type": "array", "description": "Links copied from adstransparency.google.com: an advertiser page (e.g. https://adstransparency.google.com/advertiser/AR16735076323512287233?region=US) or a website search (https://adstransparency.google.com/?region=US&domain=nike.com). A link's region is used; the other filters come from this form. Other links stop the run before anything is read, naming the link.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "region": { "title": "Region", "enum": [ "anywhere", "AF", "AL", "DZ", "AS", "AD", "AO", "AQ", "AG", "AR", "AM", "AU", "AT", "AZ", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BT", "BO", "BA", "BW", "BR", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "BQ", "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", "FJ", "FI", "FR", "PF", "TF", "GA", "GE", "DE", "GH", "GR", "GD", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HU", "IS", "IN", "ID", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MR", "MU", "MX", "FM", "MD", "MC", "MN", "ME", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MK", "MP", "NO", "OM", "PK", "PW", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "QA", "CG", "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", "SE", "CH", "TJ", "TZ", "TH", "BS", "GM", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "YE", "ZM", "ZW" ], "type": "string", "description": "Only ads shown in this country, from the 216 regions the Transparency Center offers. Anywhere = ads shown in any region. Applies to every website, id and name; a link keeps its own region. Default: Anywhere. Example: US for the United States.", "default": "anywhere" }, "platform": { "title": "Platform", "enum": [ "any", "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "type": "string", "description": "Only ads shown on this Google platform: Search, YouTube, Shopping, Maps or Play. Any = every platform. The platform is a filter only: rows do not name it, so run one search per platform to tell them apart. Default: Any platform. Example: YOUTUBE.", "default": "any" }, "adFormat": { "title": "Ad format", "enum": [ "any", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only ads of this format: text, image or video. Any = every format. The format is on every row either way, so you can also keep every format and sort later. Default: Any format. Example: VIDEO for video ads only.", "default": "any" }, "startDate": { "title": "Shown from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only ads shown on or after this day, as YYYY-MM-DD (e.g. 2026-09-01). With no Shown until, the range ends today. Leave both empty for ads from any time. An ad shown before and during the range is included." }, "endDate": { "title": "Shown until", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only ads shown on or before this day, as YYYY-MM-DD (e.g. 2026-09-30). With no Shown from, the range starts on 2018-01-01. Leave both empty for ads from any time. Must not be before Shown from." }, "maxAdsPerSearch": { "title": "Max ads per search", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop each website, id, name or link after this many ads, from 1 to 50,000. Default 100. Each ad is charged once, so this caps what one search costs. A name counts the ads of all its advertisers together. Example: 5000.", "default": 100 }, "maxAdvertisersPerName": { "title": "Max advertisers per name", "minimum": 1, "maximum": 10, "type": "integer", "description": "For each name, how many matching advertisers to read, those with the most ads first, from 1 to 10. Default 1: the biggest advertiser of that name. Example: 3, to also get a brand's regional advertisers. Ignored for websites, ids and links.", "default": 1 } } }, "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 } } } } } } } } } }