{ "openapi": "3.0.1", "info": { "title": "Google Ads Scraper", "description": "Google Ads Scraper - Extract Ads from Google Ads Transparency Center, Extract comprehensive data from Google Ads including text, image, and video advertisements directly from the official Google Ads Transparency Center. Perfect for competitive intelligence, ad research, and market analysis.", "version": "0.0", "x-build-id": "GKe1YGEnm0GqxocE6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/happitap~google-ads-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-happitap-google-ads-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/happitap~google-ads-scraper/runs": { "post": { "operationId": "runs-sync-happitap-google-ads-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/happitap~google-ads-scraper/run-sync": { "post": { "operationId": "run-sync-happitap-google-ads-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": [ "startUrls" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "List of Google Ads Transparency Center URLs to scrape. Each URL must be from an advertiser page starting with https://adstransparency.google.com/advertiser/AR/. You can find these URLs by: (1) Searching for ads on Google Ads Transparency Center and clicking an advertiser name, or (2) Searching for an advertiser/domain name directly. Example: https://adstransparency.google.com/advertiser/AR08888592736429539329?region=US&preset-date=Last+30+days. Format: Array of URL objects. Required to specify which advertisers to scrape ads from.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxAds": { "title": "Maximum Ads per Advertiser", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Maximum number of ads to extract from each advertiser URL. This limits how many ads the scraper will collect to control runtime and costs. For example, setting this to 100 will extract up to 100 ads from each advertiser. Set to 0 for unlimited ads (not recommended for large advertisers). Default: 500. Format: Positive integer. Why needed: Prevents excessive scraping and helps manage Actor runtime costs, especially for advertisers with thousands of ads.", "default": 500 }, "includeRegionStats": { "title": "Include Region Statistics", "type": "boolean", "description": "Whether to include detailed regional impression statistics for each ad. When enabled, extracts data about impressions by region, platform (YouTube, Search, etc.), and date ranges. This provides deeper insights but increases data size. Default: true. Format: Boolean (true/false). Why needed: Regional stats show where ads are performing best, helping with geographic targeting analysis and competitive intelligence.", "default": true }, "includeTargeting": { "title": "Include Targeting Information", "type": "boolean", "description": "Whether to include ad targeting data such as demographics, geography, contextual targeting, and advertiser lists. This shows how advertisers are targeting their audiences. Default: true. Format: Boolean (true/false). Why needed: Targeting data reveals advertiser strategies and helps understand audience segmentation approaches.", "default": true }, "includeVariations": { "title": "Include Ad Variations", "type": "boolean", "description": "Whether to include all variations of each ad (different headlines, descriptions, images, CTAs). Ads often have multiple versions tested simultaneously. When disabled, only the primary variation is included. Default: true. Format: Boolean (true/false). Why needed: Ad variations show A/B testing strategies and creative approaches used by advertisers.", "default": true }, "adFormats": { "title": "Ad Formats to Extract", "uniqueItems": true, "type": "array", "description": "Filter which ad formats to extract. Options: TEXT (text-only ads), IMAGE (display/banner ads), VIDEO (video ads including YouTube). Leave empty to extract all formats. Default: All formats. Format: Array of strings. Why needed: Allows focusing on specific ad types relevant to your analysis, reducing data volume and processing time.", "items": { "type": "string", "enum": [ "TEXT", "IMAGE", "VIDEO" ] }, "default": [] }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Proxy settings to avoid IP blocking and rate limiting. Enable Apify residential proxies if you experience blocking or rate limiting. Disabled by default to reduce costs. Format: Proxy configuration object. Why needed: Ensures reliable scraping without getting blocked by Google's anti-bot systems when enabled.", "default": { "useApifyProxy": 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 } } } } } } } } } }