{
  "openapi": "3.0.1",
  "info": {
    "title": "Snapchat Scraper - Profiles, Spotlight, Stories & Transcripts",
    "description": "Scrape public Snapchat profiles from $0.90 per 1,000: exact subscribers, bio, category, website, dates, related accounts. Spotlight videos with views, shares, comments, AI title, transcripts and top comments; story and highlight snaps; hashtag and keyword discovery; monitor mode. No login.",
    "version": "0.1",
    "x-build-id": "YVlD2csC2R7KGedmz"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/topapi~snapchat-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-topapi-snapchat-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/topapi~snapchat-scraper/runs": {
      "post": {
        "operationId": "runs-sync-topapi-snapchat-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/topapi~snapchat-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-topapi-snapchat-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": {
          "usernames": {
            "title": "Usernames or profile links",
            "type": "array",
            "description": "Public Snapchat accounts: bare usernames, @handles or profile links, e.g. \"nasa\", \"@kyliejenner\", \"https://www.snapchat.com/add/fcbarcelona\".",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "Snapchat links",
            "type": "array",
            "description": "Profile, Spotlight video, highlight, hashtag (/tag/...) or explore links, e.g. \"https://www.snapchat.com/spotlight/W7_EDlXW...\", \"https://www.snapchat.com/@nasa/highlight/<id>\".",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "hashtags": {
            "title": "Hashtags",
            "type": "array",
            "description": "Spotlight videos for each hashtag (about 32 per hashtag), e.g. \"fitness\", \"#food\". Always delivered as Spotlight video rows.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "Search terms (find accounts)",
            "type": "array",
            "description": "Keywords to find public accounts on Snapchat's explore search, e.g. \"pizza\", \"fitness coach\". Each account found is scraped like a username.",
            "items": {
              "type": "string"
            }
          },
          "urlsFromFile": {
            "title": "Usernames or links from a file",
            "type": "string",
            "description": "Link to a plain text or CSV file with one username or Snapchat link per line (e.g. a Google Sheets CSV export link)."
          },
          "scrapeProfiles": {
            "title": "Profile rows",
            "type": "boolean",
            "description": "One row per account: subscribers, bio, category, website, dates, Spotlight totals, plus its Spotlight videos, highlights, story and lenses nested inside.",
            "default": true
          },
          "scrapeSpotlights": {
            "title": "Spotlight video rows",
            "type": "boolean",
            "description": "One row per Spotlight video of each account: views, shares, comments, boosts, recommends, AI title and description, sound, MP4 link, top comments.",
            "default": false
          },
          "scrapeStories": {
            "title": "Story snap rows",
            "type": "boolean",
            "description": "One row per snap in each account's live public story (stories expire after 24 hours).",
            "default": false
          },
          "scrapeHighlights": {
            "title": "Highlight snap rows",
            "type": "boolean",
            "description": "One row per snap in each account's saved highlights, with the highlight's title.",
            "default": false
          },
          "nestContent": {
            "title": "Nest videos and snaps in profile rows",
            "type": "boolean",
            "description": "Keep the Spotlight videos, highlights (with every snap), story snaps and lenses inside the profile row. Off = profile fields and totals only.",
            "default": true
          },
          "postedAfter": {
            "title": "Posted after",
            "type": "string",
            "description": "Only videos and snaps posted on or after this date: \"2026-10-01\" or relative like \"7 days\", \"24 hours\". Pairs with a daily schedule."
          },
          "postedBefore": {
            "title": "Posted before",
            "type": "string",
            "description": "Only videos and snaps posted on or before this date, e.g. \"2026-10-31\"."
          },
          "minViews": {
            "title": "Minimum views",
            "minimum": 0,
            "maximum": 1000000000,
            "type": "integer",
            "description": "Skip Spotlight videos with fewer views. 0 = no minimum."
          },
          "minSubscribers": {
            "title": "Minimum subscribers",
            "minimum": 0,
            "maximum": 1000000000,
            "type": "integer",
            "description": "Skip accounts with fewer subscribers (accounts that hide the count are skipped too). 0 = no minimum."
          },
          "maxSubscribers": {
            "title": "Maximum subscribers",
            "minimum": 0,
            "maximum": 1000000000,
            "type": "integer",
            "description": "Skip accounts with more subscribers, e.g. 100000 for micro-creators. Empty or 0 = no maximum."
          },
          "verifiedOnly": {
            "title": "Verified accounts only",
            "type": "boolean",
            "description": "Only accounts with Snapchat's verified badge.",
            "default": false
          },
          "withWebsiteOnly": {
            "title": "With website only",
            "type": "boolean",
            "description": "Only accounts that list a website.",
            "default": false
          },
          "withEmailOnly": {
            "title": "With email only",
            "type": "boolean",
            "description": "Only accounts whose bio or website field carries an email address.",
            "default": false
          },
          "skipPersonalAccounts": {
            "title": "Skip personal accounts",
            "type": "boolean",
            "description": "Personal (non-public) accounts only show a username, display name and Snapcode; they are listed free. On = they are left out.",
            "default": false
          },
          "maxSpotlightsPerProfile": {
            "title": "Max Spotlight videos per profile",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Most recent Spotlight videos kept per account (rows and nested). Snapchat shows up to about 30. 0 = all shown."
          },
          "maxHighlightsPerProfile": {
            "title": "Max highlights per profile",
            "minimum": 0,
            "maximum": 200,
            "type": "integer",
            "description": "Saved highlights kept per account, in Snapchat's order, each with all its snaps. 0 = all on the profile page."
          },
          "maxStorySnapsPerProfile": {
            "title": "Max story snaps per profile",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Snaps of the live story kept per account. 0 = all."
          },
          "includeTranscripts": {
            "title": "Spotlight transcripts",
            "type": "boolean",
            "description": "Add the spoken words of each Spotlight video as plain text, from Snapchat's own caption file. Charged per transcript delivered ($0.00063). The caption link is always free.",
            "default": false
          },
          "maxCommentsPerSpotlight": {
            "title": "Comments per Spotlight video",
            "minimum": 0,
            "maximum": 25,
            "type": "integer",
            "description": "Top comments attached to each video (text, author, time, likes, replies). Snapchat publishes up to 25. 0 = none. Free.",
            "default": 25
          },
          "relatedProfilesLimit": {
            "title": "Related accounts to add",
            "minimum": 0,
            "maximum": 5000,
            "type": "integer",
            "description": "Also scrape the accounts Snapchat lists as related (\"Popular accounts like this\"), up to this many in total. 0 = off.",
            "default": 0
          },
          "maxRelatedDepth": {
            "title": "Related accounts depth",
            "minimum": 1,
            "maximum": 5,
            "type": "integer",
            "description": "1 = related accounts of your accounts; 2 = also their related accounts, and so on.",
            "default": 1
          },
          "addCreatorSubscriberCount": {
            "title": "Creator subscribers on hashtag and link videos",
            "type": "boolean",
            "description": "Fill creatorSubscriberCount on videos found by hashtag, search or link (one extra page per new creator). Videos read from a profile always carry it.",
            "default": false
          },
          "monitorMode": {
            "title": "Monitor mode (only new)",
            "type": "boolean",
            "description": "Deliver only Spotlight videos and snaps not delivered by earlier runs, and profile rows only when something changed (subscribers, bio, website, new video...). Pairs with a daily schedule.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor store name",
            "type": "string",
            "description": "Named key-value store that remembers what was delivered. Use one name per watch list, e.g. \"brands-weekly\".",
            "default": "snapchat-monitor"
          },
          "maxItems": {
            "title": "Max rows",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Stop after this many rows in total (all row types). 0 = no limit."
          },
          "maxResultsPerSearch": {
            "title": "Accounts per search term",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Accounts taken from each search term (Snapchat returns about 25), and Spotlight videos too when Spotlight rows are on.",
            "default": 20
          },
          "maxSpotlightsPerHashtag": {
            "title": "Videos per hashtag",
            "minimum": 0,
            "maximum": 100,
            "type": "integer",
            "description": "Spotlight videos taken from each hashtag page (Snapchat shows about 32). 0 = all shown."
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Pages read at the same time.",
            "default": 5
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Not needed: the run uses Apify's own connection first and Apify proxy only if Snapchat refuses it. Set your own proxy here to use only that."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}