{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper - Competitor Ads, No Login", "description": "Returns the ads any advertiser runs on Google Search, YouTube, Shopping, Maps and Play, from Google's Ads Transparency Center: format, first and last day shown, picture or YouTube link, ad text where Google publishes it, regions with impression ranges. By domain, brand or advertiser id. No login.", "version": "1.0", "x-build-id": "JnnoayJbKHTT1eNXS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/benthepythondev~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-benthepythondev-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/benthepythondev~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-benthepythondev-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/benthepythondev~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-benthepythondev-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": { "queries": { "title": "Domains, brands, advertiser ids or links", "type": "array", "description": "One entry per search. A domain (nike.com) returns every ad that links to it and is the most reliable choice. A brand name (Nike) is matched to the advertisers with the most ads. An advertiser id (AR16735076323512287233) or a link copied from adstransparency.google.com (advertiser page, single ad or domain search) works too.", "items": { "type": "string" } }, "maxResults": { "title": "Maximum ads per search", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Ads to save for each domain or advertiser. Google lists up to 100 ads per request; 1,000 ads take about five seconds.", "default": 20 }, "region": { "title": "Region", "type": "string", "description": "Two-letter country code such as US, DE or GB: only ads shown in that country. Leave empty for ads shown anywhere.", "default": "" }, "adFormat": { "title": "Ad format", "enum": [ "ALL", "TEXT", "IMAGE", "VIDEO" ], "type": "string", "description": "Keep only text, image or video ads.", "default": "ALL" }, "platforms": { "title": "Platforms", "type": "array", "description": "Keep only ads shown on these Google platforms. Leave empty for all.", "items": { "type": "string", "enum": [ "SEARCH", "YOUTUBE", "SHOPPING", "MAPS", "PLAY" ], "enumTitles": [ "Google Search", "YouTube", "Google Shopping", "Google Maps", "Google Play" ] } }, "startDate": { "title": "Shown on or after", "type": "string", "description": "Only ads shown on or after this day (YYYY-MM-DD)." }, "endDate": { "title": "Shown on or before", "type": "string", "description": "Only ads shown on or before this day (YYYY-MM-DD)." }, "includeDetails": { "title": "Include each ad's details", "type": "boolean", "description": "Opens every ad's own record: the regions it ran in with first and last day, impression ranges where Google publishes them (EU), all variations, and the ad's text or YouTube link when Google draws the ad with a script. Charged as a second event per ad. A link to a single ad always returns its details.", "default": false }, "maxAdvertisersPerQuery": { "title": "Advertisers per brand name", "minimum": 1, "maximum": 10, "type": "integer", "description": "A brand name can belong to several advertiser accounts (one per country or agency). This many of them are read, those with the most ads first. Not used for domains and ids.", "default": 3 }, "onlyNewAds": { "title": "Only ads not delivered before", "type": "boolean", "description": "For scheduled runs: skips every ad an earlier run with the same monitor name delivered, so you pay only for ads that are new to you. From the second run on, the ads shown since the last run are checked. The memory is a key-value store in your own account.", "default": false }, "monitorId": { "title": "Monitor name", "type": "string", "description": "Name of the memory used by the option above. Give each watch its own name; without a name the search itself (entries, region, format, platforms) is the name." } } }, "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 } } } } } } } } } }