{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper — Competitor & Political Ads", "description": "See every ad an advertiser is running. Search by brand name, website domain or advertiser ID and get each creative with format, first and last shown dates, days running, regions and images — plus spend, impressions and targeting for political ads where disclosure is required.", "version": "0.1", "x-build-id": "fbH0oPi7AKaxmpLlu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logical_vivacity~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logical_vivacity-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/logical_vivacity~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-logical_vivacity-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/logical_vivacity~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-logical_vivacity-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": [ "advertisers" ], "properties": { "advertisers": { "title": "Brands, websites or advertiser IDs", "type": "array", "description": "One per line. Three things work: a brand name (Nike), a website domain (ramp.com) or a Google advertiser ID (AR01234567890123456789). Spotlight works out which you gave it. A domain search is the precise one — it finds the ads pointing at that site even when the advertiser's legal name looks nothing like the brand.", "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "US", "GB", "CA", "AU", "IE", "NZ", "ZA", "IN", "SG", "AE", "IL", "DE", "FR", "ES", "IT", "NL", "BE", "AT", "CH", "PT", "PL", "SE", "NO", "DK", "FI", "TR", "BR", "MX", "AR", "JP", "KR", "ID", "PH", "TH", "VN" ], "type": "string", "description": "The country whose ad library you are reading. Ads are disclosed per country, so the same advertiser can return different ads — and different counts — in different regions. Run the same brand across several regions to see what it localises.", "default": "US" }, "maxAdsPerAdvertiser": { "title": "Maximum ads per advertiser", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many ads to return for each advertiser found. Big spenders run thousands; start at 20 to see the shape of their creative, then raise it once you know what you want.", "default": 20 }, "maxAdvertisersPerSearch": { "title": "Maximum advertisers per brand name", "minimum": 1, "maximum": 10, "type": "integer", "description": "Only used for brand-name searches. A name like \"Nike\" can match several registered advertisers — regional entities, agencies buying on the brand's behalf, and sometimes impersonators. Leave at 1 for the best match; raise it to see all of them side by side.", "default": 1 }, "adFormats": { "title": "Ad formats", "uniqueItems": true, "type": "array", "description": "Optional. Leave empty for every format. Pick one or more to return only those — for example video only, when you are researching YouTube creative.", "items": { "type": "string", "enum": [ "image", "text", "video", "html5" ], "enumTitles": [ "Image", "Text", "Video", "HTML5" ] } }, "includeAdDetails": { "title": "Include ad details", "type": "boolean", "description": "Off by default because it costs more — it opens each ad individually. Turn it on and every ad also carries all of its creative variations, the full set of image and preview assets, any YouTube video ids, and — for political and regulated ads in regions that require disclosure — the impressions range, spend range, per-region spend with start and end dates, and demographic targeting flags. This is the only way to get the spend and impressions data.", "default": false } } }, "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 } } }, "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 } } } } } } } } } }