{ "openapi": "3.0.1", "info": { "title": "Google Ads Transparency Scraper & Ads Library API", "description": "See every ad a competitor runs on Google. Google Ads Transparency Center scraper and API by keyword, domain, advertiser ID or URL: ad copy read from screenshot text ads, YouTube video links, first and last shown dates, regions, EU reach, legal name. Google ad library export, no login.", "version": "0.1", "x-build-id": "QFF3aOFzO3AdJjpkd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/apimint~google-ads-transparency-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-apimint-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/apimint~google-ads-transparency-scraper/runs": { "post": { "operationId": "runs-sync-apimint-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/apimint~google-ads-transparency-scraper/run-sync": { "post": { "operationId": "run-sync-apimint-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", "properties": { "searchTerms": { "title": "Search terms", "type": "array", "description": "A brand or keyword, such as \"plumber\" or \"nike\". Google matches it against advertiser names and website domains (not ad text), then the Actor pulls every ad of the matching advertisers. Up to \"Max advertisers per search term\" advertisers per term.", "default": [], "items": { "type": "string" } }, "domains": { "title": "Domains", "type": "array", "description": "Websites whose ads you want, such as hubspot.com. Includes other advertisers whose ads point to the domain (resellers, agencies). https://, www. and paths are removed for you.", "default": [], "items": { "type": "string" } }, "advertiserIds": { "title": "Advertiser IDs", "type": "array", "description": "Google advertiser IDs, which start with AR (AR16735076323512287233 is Nike, Inc.). You find them in the Transparency Center URL of an advertiser.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Transparency Center URLs", "type": "array", "description": "Any adstransparency.google.com URL: an advertiser page, a domain search or a single ad. The URL's region, format and platform settings are used for that URL.", "default": [], "items": { "type": "string" } }, "region": { "title": "Region", "enum": [ "anywhere", "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "IO", "VG", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "BQ", "KY", "CF", "TD", "CL", "CN", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CW", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "SZ", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "HN", "HK", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "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", "KP", "MK", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SX", "SK", "SI", "SB", "SO", "ZA", "GS", "KR", "SS", "ES", "LK", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "SD", "SR", "SJ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UM", "VI", "UG", "UA", "AE", "GB", "US", "UY", "UZ", "VU", "VA", "VE", "VN", "WF", "EH", "YE", "ZM", "ZW" ], "type": "string", "description": "Only ads shown in this country. \"Anywhere\" returns ads from every country.", "default": "anywhere" }, "platform": { "title": "Platform", "enum": [ "any", "search", "youtube", "maps", "shopping", "play" ], "type": "string", "description": "Only ads shown on this Google platform.", "default": "any" }, "format": { "title": "Ad format", "enum": [ "any", "text", "image", "video" ], "type": "string", "description": "Only text, image or video ads.", "default": "any" }, "dateFrom": { "title": "Shown from", "pattern": "^(\\d{4}-\\d{2}-\\d{2}|\\d+\\s*(day|week|month|year)s?(\\s+ago)?)?$", "type": "string", "description": "Only ads shown on or after this date: YYYY-MM-DD (2026-09-01) or a relative period such as \"30 days\". Leave empty for all time." }, "dateTo": { "title": "Shown until", "pattern": "^(\\d{4}-\\d{2}-\\d{2}|\\d+\\s*(day|week|month|year)s?(\\s+ago)?)?$", "type": "string", "description": "Only ads shown on or before this date, same format. Leave empty for today." }, "maxAdsPerTarget": { "title": "Max ads per target", "minimum": 0, "type": "integer", "description": "Stop after this many ads for each search term, domain, advertiser or URL. 0 means no limit.", "default": 500 }, "maxAds": { "title": "Max ads in total", "minimum": 0, "type": "integer", "description": "Stop the whole run after this many ads. 0 means no limit. The run also stops at your maximum cost per run.", "default": 0 }, "maxAdvertisersPerTerm": { "title": "Max advertisers per search term", "minimum": 1, "maximum": 50, "type": "integer", "description": "How many matching advertisers (and matching domains) to scrape for each search term.", "default": 10 }, "termMustAppearInAd": { "title": "Search term must appear in the ad", "type": "boolean", "description": "Keep only ads whose headline, description, display URL or sitelinks contain the search term. Ads with no readable copy are left out.", "default": false }, "includeAdDetails": { "title": "Include ad details", "type": "boolean", "description": "All saved versions of each ad, the countries where it ran with first and last dates, and EU reach and targeting. Turn off for a faster list-only run.", "default": true }, "extractTextFromScreenshots": { "title": "Read text from screenshot ads", "type": "boolean", "description": "Google stores most text ads only as an image. This reads the headline, description, display URL and sitelinks from it. Included in the price. Free Apify plan: standard OCR (Tesseract). Paid plans: an AI model reads every screenshot (more accurate, faster).", "default": true }, "extractTextFromAllVersions": { "title": "Read text from every saved version", "type": "boolean", "description": "Also read the headline, description and display URL of every saved version of a text ad (in variations). Slower: most ads have 3–5 versions. The main ad copy is read either way. Same price.", "default": false }, "onlyNewAds": { "title": "Only new ads", "type": "boolean", "description": "Monitoring mode: skip ads already returned by earlier runs for the same target and filters. Skipped ads are not charged. Use it with a schedule.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Used for Google's ad-listing requests. If Google keeps blocking, the Actor switches to residential proxies by itself.", "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 } } } } } } } } } }