{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: by website, with ad text", "description": "Type a website and get its Google ads (Search, YouTube, Display) from the Ads Transparency Center: dates, countries, EU impressions, the words inside image ads, and one honest row per company. Agency ads for other sites left out.", "version": "0.1", "x-build-id": "P3SzTQWZPeCj2Q7gq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/reachlens~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-reachlens-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/reachlens~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-reachlens-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/reachlens~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-reachlens-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": [ "searches" ], "properties": { "searches": { "title": "Websites, advertiser IDs or names", "type": "array", "description": "One per line. A website (hubspot.com) gives only that website's ads, even when an agency's account also runs ads for other clients. You can also give an advertiser ID (AR…), a Transparency Center link, or an advertiser name.", "items": { "type": "string" } }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 1, "maximum": 400, "type": "integer", "description": "Ads to read for each input, in the order Google lists them (not by date), up to 400. When empty: 100 (40 in one-row-per-company mode)." }, "onlyRecentAds": { "title": "Only ads shown in the last 30 days", "type": "boolean", "description": "Google also lists ads that stopped long ago. Leave on to get what the company runs now.", "default": true }, "output": { "title": "What to return", "enum": [ "ads", "advertisers" ], "type": "string", "description": "Every ad, or one row per company: is it advertising, how many ads, under which advertiser accounts (its own or an agency's), formats, countries. Companies with no ads, or a lookup Google refused, get a row too, free.", "default": "ads" }, "details": { "title": "Countries, dates and EU impressions per ad", "type": "boolean", "description": "Where each ad ran with first and last shown dates, times shown per EU and UK country, the Google surfaces it ran on and every variation's picture. Included in the ad price.", "default": true }, "adText": { "title": "Read the words inside image ads", "type": "boolean", "description": "Google publishes most search ads and image ads only as pictures. This reads their headline, description and display URL from the picture (OCR). Charged only for ads where words were read.", "default": false }, "trackChanges": { "title": "Mark new and stopped ads since your last run", "type": "boolean", "description": "Remembers what each input showed last time (in your own storage), so a scheduled run flags new ads and counts stopped ones.", "default": true }, "onlyNewAds": { "title": "Only return ads new since my last run", "type": "boolean", "description": "For scheduled monitoring: after the first run, only new ads come out, and only they are paid for.", "default": false }, "saveImages": { "title": "Keep a copy of each ad's image", "type": "boolean", "description": "Saves each ad's picture in your Apify storage with a lasting link (savedImageUrl). Charged per picture saved; pictures saved before are reused for free.", "default": false }, "proxy": { "title": "Proxy", "type": "object", "description": "Apify's datacenter proxies keep runs fast and cheap; when Google limits a read, the retry goes through residential proxies automatically, unless you pick proxy groups yourself.", "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 } } } } } } } } } }