{ "openapi": "3.0.1", "info": { "title": "Snapchat Profile Scraper By Topic Search", "description": "Scrape Snapchat profiles with the Apify Snapchat Profile Scraper. Extract usernames, bios, follower counts, Snap scores, and public stories. Ideal for influencer research, social analytics, and marketing insights. Fast, reliable, and easy to integrate into automated workflows.", "version": "0.1", "x-build-id": "WUV8dFirENR4ji2sj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~snapchat-profile-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-snapchat-profile-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-profile-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-snapchat-profile-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-profile-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-snapchat-profile-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": { "searchQueries": { "title": "πŸ”Ž Topics or keywords to search", "uniqueItems": true, "type": "array", "description": "Subjects to discover creators for, e.g. skincare, food challenge, crypto. Each query is looked up on https://www.snapchat.com/explore/ and https://www.snapchat.com/topic/. Leave empty to run in classic mode on the usernames below.", "items": { "type": "string" } }, "expandRelatedTopics": { "title": "🌱 Follow related topics", "type": "boolean", "description": "Snapchat topic pages list hundreds of related topics (measured 258–444 per topic across 6 slugs). Turning this on crawls some of them for extra creators. Costs one extra request per related topic.", "default": false }, "relatedTopicDepth": { "title": "πŸͺœ Related-topic depth", "minimum": 1, "maximum": 2, "type": "integer", "description": "1 = only topics related to your query. 2 = also topics related to those. Depth 2 multiplies the request count fast β€” keep the cap below small.", "default": 1 }, "maxRelatedTopicsPerQuery": { "title": "πŸ”’ Max related topics per query", "minimum": 0, "maximum": 50, "type": "integer", "description": "How many related topic pages to crawl per query when β€œFollow related topics” is on.", "default": 5 }, "maxProfilesPerQuery": { "title": "🎚️ Max profiles per query", "minimum": 1, "maximum": 500, "type": "integer", "description": "Hard cap on how many discovered creators are actually scraped per query. Candidates are ranked by the view count of their top discovered Spotlight clip.", "default": 20 }, "minSpotlightViews": { "title": "πŸ“ˆ Minimum Spotlight views", "minimum": 0, "type": "integer", "description": "Only scrape creators whose discovered Spotlight clip has at least this many views. 0 disables the filter. Creators found on Topic pages carry no view stats, so any value above 0 keeps only Explore-page creators.", "default": 0 }, "includeBrandSafety": { "title": "πŸ›‘οΈ Include brand-safety signals", "type": "boolean", "description": "Adds the GARM brand-safety block Snapchat ships on discovered Spotlight clips (garmBrandSafety, isPetraBrandSafe, brandFriendliness, spotlightSnapStatus).", "default": true }, "urls": { "title": "πŸ‘€ Usernames or profile URLs", "uniqueItems": true, "type": "array", "description": "Add one or more Snapchat usernames (e.g. djkhaled305) or full profile URLs (e.g. https://www.snapchat.com/@djkhaled305). snapchat.com/add/ links are accepted too. Optional when you supply topics above.", "items": { "type": "string" } }, "maxRetries": { "title": "πŸ” Retries per page", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times a failing page is retried before the row is written as a failure.", "default": 3 }, "requestTimeoutSecs": { "title": "⏱️ Request timeout (seconds)", "minimum": 5, "maximum": 300, "type": "integer", "description": "Per-request timeout in seconds.", "default": 30 }, "proxyConfiguration": { "title": "πŸ”’ Proxy settings", "type": "object", "description": "Optional. Uses no proxy by default. Snapchat ranks Explore and Topic results by the exit IP country, so pick an explicit country here if you need reproducible or market-specific discovery. The country actually used is stamped on every row as runGeo.country." } } }, "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 } } } } } } } } } }