{ "openapi": "3.0.1", "info": { "title": "Snapchat Scraper - Profiles, Spotlight & Lenses", "description": "Scrape public Snapchat profiles: subscribers, bio, website, category and verified badge, plus Spotlight videos with view counts, Stories with snap media links, and the AR lenses an account publishes. Also pulls the public Spotlight feed and Lens chart. No login, no API key.", "version": "0.0", "x-build-id": "49B84YhxmubaaDipy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fanndev~snapchat-profile-spotlight-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fanndev-snapchat-profile-spotlight-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/fanndev~snapchat-profile-spotlight-scraper/runs": { "post": { "operationId": "runs-sync-fanndev-snapchat-profile-spotlight-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/fanndev~snapchat-profile-spotlight-scraper/run-sync": { "post": { "operationId": "run-sync-fanndev-snapchat-profile-spotlight-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": [ "mode" ], "properties": { "mode": { "title": "Mode", "enum": [ "profile", "spotlight", "highlights", "lenses", "related", "trending", "top-lenses", "reference" ], "type": "string", "description": "profile = public profile with subscriber count, bio, link and related accounts. spotlight = each Spotlight video of an account with its view count. highlights = Stories/highlights with every snap media URL. lenses = AR lenses published by the account. related = walk Snapchat's own 'related accounts' graph out from your seeds. trending = the public Spotlight feed (no username needed). top-lenses = the Lens hub chart (no username needed). reference = probe which surfaces are live right now.", "default": "profile" }, "username": { "title": "Username", "type": "string", "description": "A single Snapchat username. '@nasa', 'nasa' and 'https://www.snapchat.com/add/nasa' are all accepted." }, "usernames": { "title": "Usernames", "type": "array", "description": "Multiple Snapchat usernames or profile URLs to process in one run. Used by the profile, spotlight, highlights, lenses and related modes.", "items": { "type": "string" } }, "relatedDepth": { "title": "Related depth (related mode)", "minimum": 0, "maximum": 3, "type": "integer", "description": "How many levels to expand out from each seed. 0 = seeds only, 1 = seeds plus the accounts Snapchat lists as related, 2 = their related accounts too. Capped at 3 because each level multiplies the number of requests.", "default": 1 }, "locale": { "title": "Locale", "type": "string", "description": "Language for the text Snapchat renders (bio and titles are user-generated and stay as written). Snapchat otherwise follows the exit IP, so 'en-US' keeps output stable no matter where the run executes.", "default": "en-US" }, "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Maximum records for this run, across all usernames.", "default": 200 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many usernames to fetch in parallel.", "default": 4 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. Snapchat served every recon request without a proxy and no anti-bot challenge was seen; use one only if your IP is rate-limited or you want a specific country's locale.", "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 } } } } } } } } } }