{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Center Scraper & Monitor", "description": "Scrape the Google Ads Transparency Center by advertiser, website or link: Search, YouTube, Maps, Play, Shopping ads, with text and Google Ads IDs where Google keeps them and EU/EEA impressions. Check by name or ID if a company advertises, track YouTube ads, or monitor competitor ads: only new ones.", "version": "0.1", "x-build-id": "AaayO2Kz5Qk1wxBHY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kaleidoscopelabs~google-ads-transparency-data/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kaleidoscopelabs-google-ads-transparency-data", "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/kaleidoscopelabs~google-ads-transparency-data/runs": { "post": { "operationId": "runs-sync-kaleidoscopelabs-google-ads-transparency-data", "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/kaleidoscopelabs~google-ads-transparency-data/run-sync": { "post": { "operationId": "run-sync-kaleidoscopelabs-google-ads-transparency-data", "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": { "queries": { "title": "Advertisers, websites or names", "minItems": 1, "type": "array", "description": "One per line: a website such as pipedrive.com (the ads that lead to it, from any advertiser), an advertiser ID (AR and 20 digits), a Transparency Center link (its filters are kept), or an advertiser's name to search for.", "default": [ "pipedrive.com" ], "items": { "type": "string" } }, "output": { "title": "Output", "enum": [ "ads", "advertisers", "lookup" ], "type": "string", "description": "Ads: one record per ad. Advertisers: one record per advertiser found (legal name, country, D-U-N-S number, ad count), no ads. Lookup: one record per line (does it advertise, how many ads, the latest day shown), for a CRM or Clay table.", "default": "ads" }, "region": { "title": "Region", "enum": [ "anywhere", "AF", "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", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "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", "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", "MK", "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", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RW", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "SH", "KN", "LC", "MF", "PM", "VC", "SD", "SR", "SJ", "SZ", "SE", "CH", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UM", "VI", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW" ], "type": "string", "description": "The country the ads were shown in, or Anywhere. Through the API, give its two-letter code, such as DE. A search by name finds the advertisers whose ads ran there.", "default": "anywhere" }, "format": { "title": "Format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Which ads to read: all of them, or only text, image or video ads.", "default": "all" }, "platforms": { "title": "Platforms", "type": "array", "description": "Where the ads ran; none means every platform. One ad can run on several: a Google Search ad also shows on YouTube and Maps.", "items": { "type": "string", "enum": [ "search", "youtube", "maps", "play", "shopping" ], "enumTitles": [ "Google Search", "YouTube", "Google Maps", "Google Play", "Google Shopping" ] }, "default": [] }, "dateFrom": { "title": "Shown from", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$|^[Aa][Ll][Ll]$", "type": "string", "description": "Only ads shown on or after this day (UTC): a date, or a span back from today such as 30 days. Empty: the last 30 days in Ads and Advertisers output, every date in Lookup output; for every date in Ads and Advertisers output, turn on Every date (or send \"all\"). The Ads Transparency Center filters by date only within about the last 13 months, so a longer span is not every date." }, "dateTo": { "title": "Shown until", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$|^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "Only ads shown on or before this day (UTC): a date, or a span back from today such as 7 days. Leave it empty for today." }, "allDates": { "title": "Every date", "type": "boolean", "description": "Read every date the Ads Transparency Center holds instead of the last 30 days (Ads and Advertisers output, when Shown from is empty). A competitor's whole list can hold tens of thousands of ads: set Ads per advertiser or website and a maximum charge. Lookup output always reads every date.", "default": false }, "maxAds": { "title": "Ads per advertiser or website", "minimum": 0, "type": "integer", "description": "How many ads each advertiser, website or link gives, newest first; 0 for every ad. A monitor needs 0. In Advertisers output: how many of a website's ads are read to find its advertisers.", "default": 10000 }, "advertisersPerSearch": { "title": "Advertisers per name", "minimum": 0, "type": "integer", "description": "For a name searched: how many of the advertisers found to read, in the Transparency Center's order, not by size; 0 for all (25 in Lookup output). Narrow it with the region, or give the advertiser's ID.", "default": 25 }, "includeDetails": { "title": "Add ad details ($)", "type": "boolean", "description": "Adds each ad's text where Google keeps one, the countries and days it ran, EU/EEA and Turkey impressions, targeting and who paid. $1.00 per 1,000 ads, on top of the result price; runs take longer.", "default": false }, "readPictureText": { "title": "Read text in pictures ($)", "type": "boolean", "description": "Reads the headline, description and display URL of text ads that the Transparency Center shows only as a picture, in Latin script. Charged per ad whose headline is read; runs take longer.", "default": false }, "monitorName": { "title": "Monitor name", "pattern": "^[A-Za-z0-9]([A-Za-z0-9-]{0,38}[A-Za-z0-9])?$", "type": "string", "description": "Turns monitoring on: each run stores only the ads that earlier runs with this name did not find. Keep the name the same in every scheduled run, such as crm-competitors. A monitor moves on only when it reads each list to the end: keep Ads per advertiser or website above the list's size (0: no limit). Letters, digits and hyphens." } } }, "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 } } } } } } } } } }