{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper: Competitor Ads + Days Running", "description": "Scrape every ad a competitor runs on Google Search, Display and YouTube, from Google's official Ads Transparency Center. Each creative comes with how many days it has been running, so proven winners are obvious. Run it again and it reports what launched, stopped and changed.", "version": "0.1", "x-build-id": "Q2y1X2pNCoQrkaNbc" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/f0rty7even~google-ads-transparency-tracker/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-f0rty7even-google-ads-transparency-tracker", "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/f0rty7even~google-ads-transparency-tracker/runs": { "post": { "operationId": "runs-sync-f0rty7even-google-ads-transparency-tracker", "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/f0rty7even~google-ads-transparency-tracker/run-sync": { "post": { "operationId": "run-sync-f0rty7even-google-ads-transparency-tracker", "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": { "advertiserDomains": { "title": "Advertiser websites", "type": "array", "description": "The websites whose ads you want, one per line. A full URL is fine, only the domain is used. A domain can return more than one advertiser when resellers and partners also advertise on it.", "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs (optional)", "type": "array", "description": "Exact advertiser IDs, which look like AR16735076323512287233. Use these instead of a website when you want one specific advertiser account rather than everyone advertising on a domain. You can read the ID out of any Ads Transparency Center URL.", "items": { "type": "string" } }, "region": { "title": "Country", "type": "string", "description": "Two-letter country code for the country whose ads you want, such as US, GB, DE or AE. Google reports ads per country, so the same advertiser returns a different set in each one.", "default": "US" }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser (spend cap)", "minimum": 1, "maximum": 50000, "type": "integer", "description": "Hard stop after this many ads for each advertiser. Large brands run tens of thousands of creatives, so this is the setting that controls what a run costs. Leave empty to take everything.", "default": 200 }, "trackChanges": { "title": "Track changes between runs", "type": "boolean", "description": "Remember this run and compare the next one against it, so later runs report what launched, what stopped and what changed. The first run has no baseline and is never charged for changes. Turn this off for a one-off snapshot.", "default": true }, "includeStoppedAds": { "title": "Include ads that stopped running", "type": "boolean", "description": "Add a row for each ad that was live last run and has since disappeared. These rows carry the last known detail rather than fresh data. Only applies when change tracking is on.", "default": true }, "stateStoreName": { "title": "Change history store", "type": "string", "description": "Name of the key-value store holding the history used to compare runs. The default is fine. Change it only to keep two schedules from overwriting each other, for example a weekly and a monthly run over the same advertisers.", "default": "google-ads-tracker-state" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Proxy used to reach the Ads Transparency Center. The default is usually fine; a different IP helps if Google starts rate limiting a long run.", "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 } } }, "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 } } } } } } } } } }