{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Center Scraper: Competitor Ads", "description": "Google Ads Transparency Center scraper. Search by brand name, website domain, advertiser ID or a pasted Transparency Center URL. Each ad comes with its advertiser, legal name, country, format, creative link and first and last shown dates. Filter by platform, format and date. No login.", "version": "0.1", "x-build-id": "FwMAdNtu9UHOnagPY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~google-ads-transparency/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-google-ads-transparency", "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/themineworks~google-ads-transparency/runs": { "post": { "operationId": "runs-sync-themineworks-google-ads-transparency", "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/themineworks~google-ads-transparency/run-sync": { "post": { "operationId": "run-sync-themineworks-google-ads-transparency", "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": "Website domains", "type": "array", "description": "Website domains to look up, e.g. [\"nike.com\", \"adidas.com\"]. Returns the ads Google's Ads Transparency Center has archived for every advertiser pointing to that domain. Do not include https:// or a path. Give domains, queries, advertiser IDs or start URLs, or any mix of them.", "items": { "type": "string" } }, "queries": { "title": "Brand or advertiser names", "type": "array", "description": "Brand or advertiser names, e.g. [\"Nike\", \"HubSpot\"]. Each is matched against advertiser names through the Transparency Center's own search box, then the ads of the best matching advertisers are returned. An advertiser is kept only when its name contains every word you typed. A bare domain such as nike.com is searched as a domain. Up to 10 per run. This searches advertiser names, not the words inside ads.", "items": { "type": "string" } }, "maxAdvertisersPerQuery": { "title": "Max advertisers per name", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many matching advertisers to fetch ads from for each brand or advertiser name. Exact name matches come first, then the advertisers with the most ads. Big brands often have several accounts (for example a parent company and a regional one).", "default": 3 }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Google advertiser IDs, which start with AR, e.g. [\"AR16735076323512287233\"]. You find them in the address of an advertiser's page on adstransparency.google.com, or in the advertiser_id field of an earlier run.", "items": { "type": "string" } }, "startUrls": { "title": "Ads Transparency Center URLs", "type": "array", "description": "Addresses copied from adstransparency.google.com: an advertiser page (/advertiser/AR...), a single ad (/advertiser/AR.../creative/CR...) or a website search (?domain=...). Filters already in the address (region, platform, format, start-date, end-date) are used for that address. An address with a filter the actor cannot read is skipped with an explanation, not run without it.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "region": { "title": "Region", "enum": [ "US", "GB", "CA", "AU", "IN", "DE", "FR", "ANYWHERE", "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "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", "IC", "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", "GF", "PF", "TF", "GA", "GE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "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", "UM", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW" ], "type": "string", "description": "Country to scope the ad archive to: every country the Transparency Center lists, or Anywhere for its whole archive. Google indexes ads per region, so the same domain can return different ads in different regions.", "default": "US" }, "platform": { "title": "Platform", "enum": [ "ALL", "SEARCH", "YOUTUBE", "MAPS", "PLAY", "SHOPPING" ], "type": "string", "description": "Only ads Google showed on this platform. Sent to Google with the search, the same as the platform menu on the Transparency Center site." }, "adFormat": { "title": "Ad format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only text, image or video ads. Sent to Google with the search and checked again on every row." }, "startDate": { "title": "Shown on or after", "type": "string", "description": "Only ads still running on or after this date (YYYY-MM-DD). An ad is kept when the span from its first shown to its last shown date overlaps your date window." }, "endDate": { "title": "Shown on or before", "type": "string", "description": "Only ads that had started by this date (YYYY-MM-DD). Use it with the start date for a window such as one month." }, "maxAdsPerDomain": { "title": "Max ads per domain or advertiser", "minimum": 1, "maximum": 500, "type": "integer", "description": "Most ads to return for each domain, advertiser or URL. Google returns ads newest first by the time they were last shown; above 100 the actor pages through further results.", "default": 100 }, "monitorMode": { "title": "Monitor mode (only new ads)", "type": "boolean", "description": "Run on a schedule and deliver ONLY ads not seen in a previous run, so each run shows the creatives a competitor started since the last one. You are charged per new ad, not for the whole archive each time. Ideal for weekly monitoring. Requires the same input across runs.", "default": false } } }, "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 } } } } } } } } } }