{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper — Competitor Ad Library", "description": "Spy on competitor ads in the Google Ads Transparency Center: every Google ad a company or website runs (Search, YouTube, Display, Shopping) with ad text, format, first/last shown dates, previews and countries, plus new-ad alerts. Pay per ad plus a small start fee, no platform fees.", "version": "1.0", "x-build-id": "vJPfdaYKrFCJX4d3Q" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/aaronoptimus~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-aaronoptimus-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/aaronoptimus~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-aaronoptimus-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/aaronoptimus~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-aaronoptimus-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": [ "searchTerms" ], "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "One per line: an advertiser or brand name (e.g. Nike), a website domain or URL (e.g. nike.com: every advertiser whose ads point there), an advertiser ID (AR followed by 20 digits), or a link copied from adstransparency.google.com (advertiser, ad or domain page).", "items": { "type": "string" } }, "resultType": { "title": "What to get", "enum": [ "ads", "advertisers" ], "type": "string", "description": "Ads: every ad with format, first/last shown dates, preview and links. Advertisers: who advertises (name, ID, country, verification, Google's approximate ad count); for a domain or ID, the advertiser accounts found in up to \"Max ads per search\" of its ads.", "default": "ads" }, "region": { "title": "Region", "enum": [ "anywhere", "US", "GB", "CA", "AU", "DE", "FR", "IN", "BR", "ES", "IT", "NL", "MX", "JP", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BQ", "BA", "BW", "BV", "IO", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "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", "GF", "PF", "TF", "GA", "GM", "GE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HK", "HU", "IS", "ID", "IR", "IQ", "IE", "IM", "IL", "JM", "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", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "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", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "UM", "UY", "UZ", "VU", "VE", "VN", "VG", "VI", "WF", "EH", "YE", "ZM", "ZW" ], "type": "string", "description": "Only ads shown in this country. Anywhere returns ads from all countries.", "default": "anywhere" }, "maxAdsPerSearch": { "title": "Max ads per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop each search term after this many ads (in Advertisers mode: how many ads of a domain or ID to look through). Big brands have thousands of ads. With a format, date or only-new filter, a search looks through at most 10× this number (at least 1,000).", "default": 100 }, "adFormat": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only ads of this format. Ads of other formats are skipped and not charged.", "default": "all" }, "shownInLastDays": { "title": "Shown in the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only ads shown within the last N days, today included (7 = the past week). Replaces \"Shown on or after\" when set. Handy for scheduled runs. 0 or empty = off." }, "dateFrom": { "title": "Shown on or after", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only ads shown on or after this date (YYYY-MM-DD), i.e. last shown on or after it. Google's archive starts on 2018-05-31." }, "dateTo": { "title": "Shown on or before", "pattern": "^$|^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Only ads shown on or before this date (YYYY-MM-DD), i.e. first shown on or before it." }, "maxAdvertisersPerName": { "title": "Advertiser accounts per name", "minimum": 1, "maximum": 10, "type": "integer", "description": "A name like \"Nike\" matches several advertiser accounts (Nike, Inc., Nike Retail BV, …). Exact matches come first, then names that contain your words, biggest first. Look-alike names (e.g. \"Nikes Tavern\") are never used.", "default": 3 }, "includeDetails": { "title": "Ad details", "type": "boolean", "description": "For each ad, also read its text (headline, description, display URL, business name) or Shopping product title and image from Google's preview, the countries it was shown in, its variations, and the YouTube video of video ads where Google shows it. Charged per ad only when details are found. Slower: up to two extra requests per ad.", "default": false }, "onlyNewAds": { "title": "Only new ads (monitoring)", "type": "boolean", "description": "Return only ads this tool hasn't delivered for the same search in earlier runs. The first run returns everything and remembers it. Schedule it daily or weekly to get competitors' new ads; you pay only for new ones.", "default": false }, "monitorStoreName": { "title": "Monitoring memory name", "type": "string", "description": "Name of the key-value store in your Apify account that remembers delivered ads. Use a different name for each separate monitoring job.", "default": "ads-transparency-monitor" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Google limits how many requests one IP can make. Apify Proxy is recommended; sessions and IPs rotate automatically.", "default": { "useApifyProxy": true } }, "useResidentialFallback": { "title": "Fall back to residential proxy when refused", "type": "boolean", "description": "If Google keeps refusing the default proxy, switch to Apify residential proxy IPs automatically. No extra cost to you.", "default": true }, "maxConcurrency": { "title": "Parallel searches", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many search terms run at the same time, each from its own proxy session.", "default": 3 }, "maxRetries": { "title": "Retries per request", "minimum": 1, "maximum": 12, "type": "integer", "description": "How often a refused or failed request is retried (each time from a new proxy IP, with a growing pause) before the search is reported as failed. Failed searches are free.", "default": 6 }, "saveRawSamples": { "title": "Save raw answers (troubleshooting)", "type": "boolean", "description": "Save the first few raw answers from Google to the run's key-value store (RAW-…). Only useful when reporting a problem.", "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 } } } } } } } } } }