{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper - Competitor Ads & Ad Copy", "description": "Get every Google ad a competitor runs on Search, YouTube, Shopping, Maps and Play, by website, advertiser name or ID. Ad copy, landing pages, images, YouTube videos, countries, dates, EU impressions and targeting. Bulk-check which websites run Google Ads. Monitoring mode.", "version": "1.0", "x-build-id": "Y6Tas4nEYlHf8c5cy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/upendra_11~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-upendra_11-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/upendra_11~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-upendra_11-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/upendra_11~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-upendra_11-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": [ "targets" ], "properties": { "targets": { "title": "Websites, advertisers or Transparency Center links", "type": "array", "description": "One per line. A website (nike.com), an advertiser name (Nike, Inc.), an advertiser ID (AR16735076323512287233) or any adstransparency.google.com link (advertiser, domain or single-ad page). The type is detected automatically.", "items": { "type": "string" } }, "mode": { "title": "What to get", "enum": [ "ads", "advertisers" ], "type": "string", "description": "\"Ads\" saves every ad with its details. \"Advertiser check\" saves one row per input: does it run Google Ads, roughly how many ads, which advertiser accounts, when the latest ad ran (great for lead lists).", "default": "ads" }, "region": { "title": "Region", "enum": [ "anywhere", "AF", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "CV", "KH", "CM", "CA", "BQ", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CK", "CR", "CI", "HR", "CW", "CY", "CZ", "CD", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "XK", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MO", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "CG", "RE", "RO", "RW", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "SD", "SR", "SJ", "SE", "CH", "TW", "TJ", "TZ", "TH", "BS", "GM", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "VI", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW" ], "type": "string", "description": "Only ads shown in this country. \"Anywhere\" covers all regions.", "default": "anywhere" }, "platform": { "title": "Platform", "enum": [ "all", "google_search", "youtube", "google_shopping", "google_maps", "google_play" ], "type": "string", "description": "Only ads shown on this Google platform.", "default": "all" }, "adFormat": { "title": "Ad format", "enum": [ "all", "text", "image", "video" ], "type": "string", "description": "Only text, image or video ads.", "default": "all" }, "shownInLastDays": { "title": "Shown in the last N days", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only ads shown during the last N days (for example 7 or 30). 0 = any time. Ignored when you set a date range below.", "default": 0 }, "dateFrom": { "title": "Shown from (date)", "type": "string", "description": "Optional. Only ads shown on or after this date (YYYY-MM-DD).", "default": "" }, "dateTo": { "title": "Shown until (date)", "type": "string", "description": "Optional. Only ads shown on or before this date (YYYY-MM-DD). Defaults to today when only the start date is set.", "default": "" }, "maxAdsPerTarget": { "title": "Max ads per input", "minimum": 1, "maximum": 100000, "type": "integer", "description": "Upper limit of ads saved for each input line, newest first (Google lists ads by when they were last shown). Big brands have tens of thousands of ads.", "default": 100 }, "includeAdDetails": { "title": "Include ad copy and media", "type": "boolean", "description": "Adds headlines, descriptions, call to action, display URL, landing pages, images and YouTube videos, read from Google's ad previews (one light request per image or video ad). Google archives most text ads as a picture, so for those you get the image. Same price per ad.", "default": true }, "includeRegionStats": { "title": "Include countries and EU stats (slower)", "type": "boolean", "description": "Adds the countries where each ad ran (first/last shown per country), EU impressions per platform, EU targeting and who paid for the ad. Needs one extra request per ad to the Transparency Center, which Google rate-limits, so runs are slower (roughly 60 ads per minute). Same price per ad.", "default": false }, "maxAdvertisersPerName": { "title": "Advertisers per name", "minimum": 1, "maximum": 20, "type": "integer", "description": "When you enter a name, the best-matching advertiser account is used (exact name first, then the one with most ads). Raise this to also include other accounts with the same name (e.g. a brand's country subsidiaries).", "default": 1 }, "onlyNewAds": { "title": "Only new ads since the last run (monitoring)", "type": "boolean", "description": "Checks the most recently shown ads (up to \"Max ads per input\") and saves only ads this Actor has not returned before in your account. The first run returns everything as a baseline. Schedule it daily to get competitors' new ads.", "default": false }, "monitorName": { "title": "Monitor name", "type": "string", "description": "Use a different name for each separate monitor so they remember already-seen ads independently.", "default": "default" }, "maxRequestsPerSecond": { "title": "Max requests per second", "minimum": 1, "maximum": 10, "type": "integer", "description": "Starting speed for Google's Transparency Center (each request returns up to 100 ads). The Actor slows down automatically when Google asks it to and speeds up again gradually. Raising this makes Google more likely to limit the run.", "default": 1 } } }, "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 } } } } } } } } } }