{ "openapi": "3.0.1", "info": { "title": "YouTube Ad Library — Google Ads Landing Page & EU DSA", "description": "YouTube ad library and Google ad library from the Google Ads Transparency Center. Landing page URLs with UTM parameters, direct MP4 video URLs, and EU DSA reach for YouTube, Search, and Display. No browser.", "version": "1.0", "x-build-id": "XkImSueW5XFYh0MAW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/drlipton~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-drlipton-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/drlipton~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-drlipton-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/drlipton~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-drlipton-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": { "domain": { "title": "Domain", "type": "string", "description": "Website domain to search ads for (e.g. 'klarna.com' or 'spotify.com'). Scheme and 'www.' are stripped automatically. This is the field to set for a first run." }, "region": { "title": "Region / Country (ISO-2)", "enum": [ "ALL", "US", "GB", "DE", "SE", "FR", "ES", "IT", "NL", "NO", "DK", "FI", "PL", "AT", "BE", "CH", "IE", "PT", "GR", "CZ", "RO", "HU", "CA", "AU", "BR", "MX", "IN", "JP", "KR", "SG", "TR", "ZA" ], "type": "string", "description": "ISO-2 country code (e.g. 'ALL', 'US', 'SE', 'DE', 'GB', 'FR', 'ES', 'IT', 'NL', 'NO', 'DK', 'FI', 'PL') or 'ALL' for worldwide.", "default": "ALL" }, "format": { "title": "Ad Format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Filter creatives by ad format: ALL, TEXT, IMAGE, or VIDEO.", "default": "ALL" }, "maxResults": { "title": "Max Results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of ad creatives to return. Start with 5–10 ($0.0075–$0.015). Raise this for a full pull. You are charged only for ads actually returned.", "default": 10 }, "fetchDetails": { "title": "Fetch Full Creative Details & EU DSA Reach", "type": "boolean", "description": "When enabled, calls LookupService/GetCreativeById for each creative to extract per-country EU DSA impression bounds, YouTube/Search/Display reach breakdown, and targeting criteria.", "default": true }, "advertiserId": { "title": "Advertiser ID (AR...)", "type": "string", "description": "Exact Google Ads Transparency Advertiser ID starting with 'AR' (e.g. 'AR04217635482122584065'). Use this instead of domain when you already have the ID." }, "query": { "title": "Brand / Advertiser Name or Query", "type": "string", "description": "Brand name, domain, or AR... advertiser ID. Brand names are resolved via Google Ads Transparency SearchSuggestions. If you also set domain, both targets are scraped." }, "startDate": { "title": "Start Date (YYYY-MM-DD)", "type": "string", "description": "Optional start date in YYYY-MM-DD or YYYYMMDD format." }, "endDate": { "title": "End Date (YYYY-MM-DD)", "type": "string", "description": "Optional end date in YYYY-MM-DD or YYYYMMDD format." }, "concurrency": { "title": "Detail Lookup Concurrency", "minimum": 1, "maximum": 25, "type": "integer", "description": "Number of concurrent HTTP RPC detail lookups when fetchDetails is enabled.", "default": 8 }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Apify Proxy settings (enabled by default on Apify Cloud to avoid shared datacenter IP 429 rate limits).", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }