{ "openapi": "3.0.1", "info": { "title": "Snapchat Popular Accounts Scraper By Snapcode & Bio Links", "description": "Scrape popular Snapchat accounts by Snapcode and bio links. Extract usernames, profile details, Snapcodes, bios, external links, follower data, Spotlight content, and engagement metrics. Ideal for creator discovery, influencer research, and audience analysis.", "version": "0.1", "x-build-id": "AmmMfmAZhPzNQUytC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~snapchat-popular-accounts-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-snapchat-popular-accounts-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/api-empire~snapchat-popular-accounts-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-snapchat-popular-accounts-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/api-empire~snapchat-popular-accounts-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-snapchat-popular-accounts-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", "properties": { "targetKeywords": { "title": "🎯 Target keywords", "type": "array", "description": "Search keywords to discover profiles (e.g. fashion, beauty, fitness). Each keyword is searched across Snapchat's Explore and Spotlight sections and the results are merged and deduplicated into one profile list per keyword.", "items": { "type": "string" } }, "profileUrls": { "title": "🔗 Profile or explore URLs", "type": "array", "description": "Direct Snapchat profile URLs (snapchat.com/add/username) or explore/spotlight listing URLs. Use with or without target keywords.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "contactExportLimit": { "title": "📇 Max contact cards per search", "minimum": 1, "maximum": 200, "type": "integer", "description": "Cap on how many profiles (and their contact cards) to export per keyword or URL. Keeps runs predictable." }, "fetchConcurrency": { "title": "⚡ Fetch concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many profiles to fetch at the same time." }, "includeSnapcodeCard": { "title": "🎯 Include snapcode contact card", "type": "boolean", "description": "Emit a structured snapcodeCard object per profile: the profile's real snapcode image URL plus a canonical add-link (snapchat.com/add/username). URL + metadata only — the snapcode image itself is never downloaded or stored.", "default": true }, "mineBioMentions": { "title": "🔎 Mine bio for cross-platform mentions", "type": "boolean", "description": "Scan each profile's bio text for @handle mentions and other-platform URLs (Instagram, TikTok, YouTube, Twitter/X, Facebook) into a bioMentions array. Catches informal handles creators write by hand, separate from the actual sameAsLinks profile field.", "default": true }, "keywords": { "title": "🔑 Keywords (legacy)", "type": "array", "description": "Legacy alias for 'Target keywords' above.", "items": { "type": "string" } }, "startUrls": { "title": "🔗 Start URLs (legacy)", "type": "array", "description": "Legacy alias for 'Profile or explore URLs' above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxProfilesPerUrl": { "title": "📊 Max profiles per URL (legacy)", "minimum": 1, "maximum": 200, "type": "integer", "description": "Legacy alias for 'Max contact cards per search' above.", "default": 10 }, "maxConcurrentProfiles": { "title": "⚡ Max concurrent profiles (legacy)", "minimum": 1, "maximum": 20, "type": "integer", "description": "Legacy alias for 'Fetch concurrency' above.", "default": 10 }, "proxyConfiguration": { "title": "🌐 Proxy configuration (optional)", "type": "object", "description": "Proxy settings for requests to Snapchat. Default: direct connection for speed. The actor automatically adjusts its connection if needed so your run keeps going." } } }, "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 } } } } } } } } } }