{ "openapi": "3.0.1", "info": { "title": "EU Ad Library Monitor: Meta & Google Competitor Ads", "description": "Track Facebook, Instagram and Google competitor ads in one dataset. Monitor new creatives and observed changes, skip unchanged ads for free, and add an AI summary. EU country filters, clear coverage reports, no login.", "version": "0.1", "x-build-id": "zKlnTUzTAmnl9SrIu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/olliolli~meta-ad-library-eu/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-olliolli-meta-ad-library-eu", "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/olliolli~meta-ad-library-eu/runs": { "post": { "operationId": "runs-sync-olliolli-meta-ad-library-eu", "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/olliolli~meta-ad-library-eu/run-sync": { "post": { "operationId": "run-sync-olliolli-meta-ad-library-eu", "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": { "watchlist": { "title": "Competitors", "type": "array", "description": "1–10 competitors with name, optional numeric metaPageId and optional googleDomain. Example: [{\"name\":\"Coolblue BE\",\"metaPageId\":\"1809566712696587\",\"googleDomain\":\"coolblue.be\"}]. Exact identifiers avoid unrelated namesakes." }, "country": { "title": "EU country", "enum": [ "AT", "BE", "BG", "HR", "CY", "CZ", "DK", "EE", "FI", "FR", "DE", "GR", "HU", "IE", "IT", "LV", "LT", "LU", "MT", "NL", "PL", "PT", "RO", "SK", "SI", "ES", "SE" ], "type": "string", "description": "Country in which the ads were shown.", "default": "BE" }, "mode": { "title": "Mode", "enum": [ "monitor", "snapshot" ], "type": "string", "description": "Monitor: only new and changed observations. Snapshot: charge delivered ads each run. Missing ads alone are never reported as stopped.", "default": "monitor" }, "stateName": { "title": "Monitor name", "type": "string", "description": "Reuse with the same watchlist and country. Avoid overlapping runs.", "default": "eu-ad-watch" }, "maxAdsPerSource": { "title": "Ads per competitor per platform", "minimum": 1, "maximum": 200, "type": "integer", "description": "Bounded observations per competitor and platform; smaller limits may produce partial scans.", "default": 20 }, "maxPagesPerSource": { "title": "Maximum pages per source", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum source pages per connection attempt. Automatic Meta recovery may make one second bounded attempt; OUTPUT reports the total.", "default": 3 }, "maxRunSeconds": { "title": "Processing time limit", "minimum": 30, "maximum": 240, "type": "integer", "description": "Internal time limit before a clean stop.", "default": 150 }, "includeEuDetails": { "title": "Attempt public EU details (experimental)", "type": "boolean", "description": "Google details supported. Meta demographic mapping is not yet validated; unavailable fields remain empty.", "default": false }, "includeDigest": { "title": "AI digest (requires owner configuration)", "type": "boolean", "description": "Only successful AI summaries are charged. Currently unavailable until the owner configures and validates Workers AI.", "default": false }, "connection": { "title": "Meta connection", "enum": [ "auto", "datacenter", "residential" ], "type": "string", "description": "Automatic uses at most one datacenter and one residential Meta session per run. No further IP rotation, logins or captcha handling.", "default": "auto" } } }, "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 } } } } } } } } } }