{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper - Competitor Ads by Domain", "description": "Competitor ads from Google's Ads Transparency Center by advertiser or domain: text, image and video ads, first and last shown, countries, ad text. Monitor new ads. $1.50 per 1,000 ads, failed searches free.", "version": "0.1", "x-build-id": "N1PZ8RK9vmQFeSixC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/tidytools~ads-transparency/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-tidytools-ads-transparency", "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/tidytools~ads-transparency/runs": { "post": { "operationId": "runs-sync-tidytools-ads-transparency", "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/tidytools~ads-transparency/run-sync": { "post": { "operationId": "run-sync-tidytools-ads-transparency", "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": { "advertisers": { "title": "Advertisers", "type": "array", "description": "Advertiser names (\"Nike\"), advertiser IDs (AR + 20 digits) or Ads Transparency Center links (https://adstransparency.google.com/advertiser/AR...), one per line. A name is matched against Google's advertiser list: by default the matching advertiser with the most ads is used (see \"Advertiser name matching\"). Invalid lines become a result row with errorType \"invalid_input\" (not charged).", "items": { "type": "string" } }, "domains": { "title": "Domains", "type": "array", "description": "Websites, one per line (nike.com or https://www.nike.com/us/): returns the ads that point to that domain, from every advertiser. Up to 500 advertisers and domains per run.", "items": { "type": "string" } }, "region": { "title": "Shown in country", "type": "string", "description": "Only ads shown in this country: a two-letter code such as US, GB, DE, FR, AU, JP or TW. \"anywhere\" (default) returns ads shown in any country.", "default": "anywhere" }, "format": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only text ads (Google Search), image ads (display) or video ads (YouTube).", "default": "all" }, "lastDays": { "title": "Shown in the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only ads shown in the last N days (0 = any time). Ignored when \"Shown from\" is set.", "default": 0 }, "dateFrom": { "title": "Shown from (YYYY-MM-DD)", "type": "string", "description": "Only ads shown on or after this date." }, "dateTo": { "title": "Shown until (YYYY-MM-DD)", "type": "string", "description": "Only ads shown on or before this date." }, "maxAdsPerSearch": { "title": "Max ads per advertiser or domain", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many ads for each advertiser or domain line (newest first). Large brands have thousands of ads; the run SUMMARY shows Google's total count for every search.", "default": 100 }, "includeDetails": { "title": "Ad details (countries and variations)", "type": "boolean", "description": "One extra lookup per ad: every image or video variation, and each country the ad was shown in with the last date shown there. Charged as \"Ad details\" only when they come back.", "default": false }, "extractAdText": { "title": "Read the ad text", "type": "boolean", "description": "The Transparency Center shows text ads as pictures. With this on, the words of each text or image ad (headline, description, display URL, call to action) are read from its image with an AI vision model. Charged as \"Ad text\" only when text was found; video ads are skipped.", "default": false }, "onlyNewAds": { "title": "Only ads not seen in earlier runs", "type": "boolean", "description": "Competitor monitoring: return (and charge) only ads that earlier runs with the same monitor name did not return. Schedule the run daily or weekly and connect a webhook, Slack or Google Sheets integration.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Separate monitors keep separate lists of seen ads. Only used with \"Only ads not seen in earlier runs\".", "default": "default" }, "advertiserMatch": { "title": "Advertiser name matching", "enum": [ "most-ads", "all" ], "type": "string", "description": "How a name is turned into advertisers. \"Most ads\": the matching advertiser with the most ads (\"Nike\" -> Nike, Inc.). \"All matches\": every advertiser whose name contains the text, up to the limit below (useful for brands with one advertiser account per country).", "default": "most-ads" }, "maxAdvertisersPerName": { "title": "Max advertisers per name", "minimum": 1, "maximum": 10, "type": "integer", "description": "With \"All matches\": at most this many advertisers per name.", "default": 5 }, "maxConcurrency": { "title": "Parallel lookups", "minimum": 1, "maximum": 4, "type": "integer", "description": "Ad details and ad text lookups at the same time. Requests to Google are paced (about 2 per second) whatever this is.", "default": 2 } } }, "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 } } } } } } } } } }