{ "openapi": "3.0.1", "info": { "title": "Snapchat Ads Scraper", "description": "Search Snapchat's public Ads Gallery by advertiser, country, dates, or status. Search its political and advocacy archive by year, country, advertiser, or keyword, or sponsored content by creator name. Get structured ad, impression, targeting, creative, spend, and source-link data when published.", "version": "0.0", "x-build-id": "QZhhelZ5kfzjSZgEb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~snapchat-ads/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-snapchat-ads", "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/maximedupre~snapchat-ads/runs": { "post": { "operationId": "runs-sync-maximedupre-snapchat-ads", "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/maximedupre~snapchat-ads/run-sync": { "post": { "operationId": "run-sync-maximedupre-snapchat-ads", "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": [ "resultType" ], "properties": { "resultType": { "title": "Result type", "enum": [ "commercialAds", "politicalAds", "sponsoredCreatorContent" ], "type": "string", "description": "Choose the public Snapchat surface to search: commercial ads, political and advocacy ads, or sponsored creator content." }, "commercialDateFrom": { "title": "Activity date from", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional first date in the commercial ad activity window. Use YYYY-MM-DD." }, "commercialDateTo": { "title": "Activity date to", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string", "description": "Optional last date in the commercial ad activity window. Use YYYY-MM-DD." }, "commercialStatus": { "title": "Ad status", "enum": [ "active", "paused", "both" ], "type": "string", "description": "Choose active ads, paused ads, or both. If you leave this as both, active and paused ads are included.", "default": "both" }, "politicalYears": { "title": "Archive years", "minItems": 1, "type": "array", "description": "Add one or more four-digit years for the published political and advocacy ad archive.", "items": { "type": "string", "pattern": "^\\d{4}$" } }, "politicalKeyword": { "title": "Keyword", "minLength": 1, "type": "string", "description": "Optionally search the published political or advocacy ad record with free text." }, "creatorName": { "title": "Creator name", "type": "string", "description": "Enter one creator name to search public sponsored or branded Snapchat content." }, "advertiser": { "title": "Advertiser, brand, or organization", "minLength": 1, "type": "string", "description": "For Commercial ads or Political and advocacy ads, enter one advertiser, brand, or organization. It is required for Commercial ads and optional for Political and advocacy ads.", "default": "Amazon" }, "countries": { "title": "Country scope", "minItems": 1, "type": "array", "description": "For Commercial ads, add one or more supported EU/EEA countries. For Political and advocacy ads, add one country. Sponsored creator content ignores this field. Leave it empty to use the source's full country scope.", "items": { "type": "string", "minLength": 1 }, "default": [ "de" ] }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Maximum results to save for the selected surface. Leave it empty to return all available results until the source is exhausted." } } }, "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 } } } } } } } } } }