{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Center Scraper with Ad Copy", "description": "Scrape ads from the Google Ads Transparency Center by website, advertiser name or ID. Get the ad text (headlines, descriptions), YouTube links of video ads, landing pages, where and when each ad ran, and EU reach and audience data. No login.", "version": "0.0", "x-build-id": "DS1hcobyQZ9rsdz8g" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/sinolens~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-sinolens-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/sinolens~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-sinolens-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/sinolens~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-sinolens-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": "Websites, advertisers or links", "type": "array", "description": "One per line. Each can be:
• a website (nike.com): ads of every advertiser that points to it;
• an advertiser name (Nike): the advertisers with that name, most ads first;
• an advertiser ID (AR16735076323512287233);
• a link from adstransparency.google.com (an advertiser page, one ad, or a website search).", "items": { "type": "string" } }, "resultType": { "title": "What to return", "enum": [ "ads", "advertisers" ], "type": "string", "description": "Ads: one row per ad. Advertisers: one row per advertiser (name, country, verification, number of ads), for example to find the companies behind a website or every advertiser with a word in its name.", "default": "ads" }, "region": { "title": "Country", "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", "HR", "CU", "CW", "CY", "CZ", "CI", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "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", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "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", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "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", "RO", "RU", "RW", "RE", "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", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TM", "TC", "TV", "TR", "UM", "VI", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW", "AX" ], "type": "string", "description": "Only ads shown in this country. The ads Google publishes differ by country; for the EU, Google also publishes how often each ad was shown and how its audience was chosen.", "default": "anywhere" }, "platform": { "title": "Platform", "enum": [ "all", "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "type": "string", "description": "Only ads shown on this Google service. Google applies this filter only to ads shown since 4 September 2023.", "default": "all" }, "adFormat": { "title": "Ad format", "enum": [ "all", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Only text, image or video ads.", "default": "all" }, "dateFrom": { "title": "Shown on or after", "type": "string", "description": "Only ads shown on or after this date (Pacific Time), for example 2026-01-01, or a period such as 30 days. Empty: any time since May 2018." }, "dateTo": { "title": "Shown on or before", "type": "string", "description": "Only ads shown on or before this date. Empty: today." }, "maxAdsPerSearch": { "title": "Maximum ads per search term", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Stop after this many ads for each website, name or ID. Large advertisers have tens of thousands of ads.", "default": 100 }, "maxAdvertisersPerName": { "title": "Maximum advertisers per name", "minimum": 1, "maximum": 100, "type": "integer", "description": "For advertiser names: how many matching advertisers to include (most ads first). Many brands have several accounts, for example one per region. In Advertisers mode, this is how many advertisers to return per search term (up to 100).", "default": 3 }, "includeDetails": { "title": "Add details and ad text", "type": "boolean", "description": "For each ad: the ad text (headline, description, display URL, call to action, landing page), YouTube link and video data, all variations, the countries where it ran with first and last dates, Google's topic, and for the EU the number of times shown and the audience selection. Charged per ad that gets details.", "default": true }, "readAdText": { "title": "Read text ads from their pictures", "type": "boolean", "description": "Google publishes most text ads only as a picture. With this on, the picture is read (OCR) to get the headline, description and display URL. Slower; no extra charge.", "default": true }, "deduplicate": { "title": "Skip duplicate ads", "type": "boolean", "description": "Save each ad only once per run, even if several search terms find it.", "default": true }, "maxConcurrency": { "title": "Parallel requests", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many requests to Google at the same time. Lower it if the log shows throttling.", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Google limits how many requests one IP address can make. The Actor connects directly first and switches to this proxy when Google starts limiting it. For thousands of ads with details, residential proxies work best.", "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 } } } } } } } } } }