{
"openapi": "3.0.1",
"info": {
"title": "Google Ads Transparency Center Scraper & Tracker",
"description": "Scrape Google Ads Transparency Center creatives, advertisers and dates. Track competitor Google ads and detect new, updated and safely ended ads.",
"version": "0.9",
"x-build-id": "Xm5ATpuodOCQT4CBp"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/luminar~google-ads-transparency-intelligence/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-luminar-google-ads-transparency-intelligence",
"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/luminar~google-ads-transparency-intelligence/runs": {
"post": {
"operationId": "runs-sync-luminar-google-ads-transparency-intelligence",
"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/luminar~google-ads-transparency-intelligence/run-sync": {
"post": {
"operationId": "run-sync-luminar-google-ads-transparency-intelligence",
"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": [
"searchTargets"
],
"properties": {
"productLevel": {
"title": "Run mode",
"enum": [
"BASELINE",
"CHANGES"
],
"type": "string",
"description": "Baseline returns the ads found now. Changes first returns the current ads as NEW; later runs of the same scope return only NEW, UPDATED, or safely proven ENDED ads. If nothing changed, no result row is delivered or charged. Run the same monitoring scope sequentially.",
"default": "BASELINE"
},
"searchTargets": {
"title": "Brands, domains, advertiser IDs, or Transparency URLs",
"minItems": 1,
"maxItems": 25,
"uniqueItems": true,
"type": "array",
"description": "Enter one target per line: a brand name, a domain such as nike.com, an AR... advertiser ID, or a Google Ads Transparency Center URL. Maximum 25 targets.",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"maxAdsPerTarget": {
"title": "Result limit per target",
"minimum": 1,
"maximum": 5000,
"type": "integer",
"description": "Maximum ads collected for each target. The Console starts at 15 for a low-cost test. Reaching the limit marks that target CAPPED, so it cannot safely prove that a missing ad ended. This value is also part of a Changes monitoring scope.",
"default": 100
},
"region": {
"title": "Country or region",
"enum": [
"ANYWHERE",
"US",
"GB",
"DE",
"FR",
"ES",
"IT",
"CA",
"AU",
"BR",
"IN",
"JP",
"MX",
"NL",
"AE",
"AR",
"AT",
"BA",
"BE",
"BG",
"CH",
"CZ",
"DK",
"EG",
"FI",
"GR",
"HR",
"HU",
"IE",
"IL",
"KR",
"ME",
"NO",
"NZ",
"PL",
"PT",
"RO",
"RS",
"SA",
"SE",
"SG",
"SI",
"SK",
"TR",
"UA",
"ZA"
],
"type": "string",
"description": "Choose where ads were shown. Pick Anywhere for the broadest view. Keep the same value between Changes runs.",
"default": "ANYWHERE"
},
"adFormat": {
"title": "Ad format",
"enum": [
"ALL",
"TEXT",
"IMAGE",
"VIDEO"
],
"type": "string",
"description": "Keep every format or return only text, image, or video ads.",
"default": "ALL"
},
"maxDeliveryEvents": {
"title": "Whole-run delivery limit",
"minimum": 1,
"maximum": 100000,
"type": "integer",
"description": "Maximum billed result rows across all targets combined. If reached, the Actor stops further delivery and reports that the run was limited instead of billing beyond this guard.",
"default": 10000
},
"timeoutSeconds": {
"title": "Whole-run time limit",
"minimum": 60,
"maximum": 3600,
"type": "integer",
"description": "Maximum run time in seconds. If the limit is reached before collection finishes, coverage is reported as PARTIAL instead of COMPLETE.",
"default": 900
}
}
},
"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
}
}
}
}
}
}
}
}
}
}