{ "openapi": "3.0.1", "info": { "title": "Snapchat Ads Library Scraper: EU Ads & Impressions", "description": "Returns ads from Snapchat's public EU Ads Library (EU-27 + Turkey) by advertiser name: impressions per country, targeting, dates, media and landing URLs, products. No login. Example: advertiserNames=[\"Nike\"]. Pay per event: $0.001 per ad.", "version": "0.1", "x-build-id": "iCteR9FtXGsBSb7gb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kyungminlee~snapchat-ads-library-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kyungminlee-snapchat-ads-library-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/kyungminlee~snapchat-ads-library-scraper/runs": { "post": { "operationId": "runs-sync-kyungminlee-snapchat-ads-library-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/kyungminlee~snapchat-ads-library-scraper/run-sync": { "post": { "operationId": "run-sync-kyungminlee-snapchat-ads-library-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": [ "advertiserNames" ], "properties": { "advertiserNames": { "title": "Advertiser names", "type": "array", "description": "REQUIRED. List of advertiser names, e.g. [\"Nike\", \"Zalando\"]. Matched partially (\"Nike\" also finds \"Nike, Inc.\"); use short brand names. Each name is searched separately with its own maxAdsPerAdvertiser limit. Snap's API cannot list ads by country or keyword alone.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Optional list of lowercase 2-letter codes, e.g. [\"de\", \"fr\"]: only ads delivered there. Allowed: 27 EU codes (at be bg hr cy cz dk ee fi fr de el hu ie it lv lt lu mt nl pl pt ro sk si es se; gr accepted for Greece) and tr. Empty = all 28.", "items": { "type": "string" } }, "dateFrom": { "title": "Active from", "type": "string", "description": "Optional date string YYYY-MM-DD, e.g. \"2026-01-01\": only ads running on or after it. Empty = 90 days before dateTo. Snap keeps about 12 months." }, "dateTo": { "title": "Active until", "type": "string", "description": "Optional date string YYYY-MM-DD, e.g. \"2026-10-01\": only ads running on or before it. Empty = today." }, "status": { "title": "Ad status", "enum": [ "ALL", "ACTIVE", "PAUSED" ], "type": "string", "description": "Enum ALL, ACTIVE or PAUSED (default ALL): ACTIVE = still delivering, PAUSED = stopped, ALL = both.", "default": "ALL" }, "maxAdsPerAdvertiser": { "title": "Max ads per advertiser", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Integer, default 100 (prefill 20): max ads saved per advertiser name (10 ads per request). Ads already saved for an earlier name in the run are skipped, not charged twice, and not counted. Each ad saved is one charged 'ad' event ($0.001).", "default": 100 }, "exactAdvertiserMatch": { "title": "Exact advertiser match", "type": "boolean", "description": "Boolean (default false). true = keep only ads whose advertiser or brand profile name equals the searched name, ignoring case, punctuation and legal suffixes (\"Nike\" = \"Nike, Inc.\"); skipped ads are not saved or charged. false = partial matches included.", "default": false }, "includeProducts": { "title": "Include catalog products", "type": "boolean", "description": "Boolean (default true). true = for dynamic product ads add a products array (title, link, image, brand, availability). false = smaller rows. No effect on price.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings object, default {\"useApifyProxy\": false} (works from Apify servers). Enable {\"useApifyProxy\": true} if you see repeated throttling (error E1009).", "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 }, "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 } } } } } } } } } }