{
  "openapi": "3.0.1",
  "info": {
    "title": "Snapchat Scraper & Video Downloader: Profile, Spotlight, Email",
    "description": "Scrape Snapchat profiles, Spotlight clips, Stories, AR Lenses and hashtag feeds, and download Spotlight videos through direct video links. Accepts profile, Spotlight and t.snapchat.com share links. Emails and phones from bios, AI titles, transcripts, comments, views. JSON + CSV.",
    "version": "0.1",
    "x-build-id": "IgqQKWQYk2jbSraPM"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~snapchat-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-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/memo23~snapchat-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-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/memo23~snapchat-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-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",
        "required": [
          "profileUrls"
        ],
        "properties": {
          "profileUrls": {
            "title": "Snapchat URLs, usernames or #hashtags",
            "type": "array",
            "description": "Paste any mix of:\n• Profile URLs — `https://www.snapchat.com/add/{u}` or `/@{u}` (or just `username`)\n• Spotlight clip URLs — `https://www.snapchat.com/spotlight/{id}`\n• Share links from the Snapchat app — `https://t.snapchat.com/{code}` or `https://snapchat.com/t/{code}` (resolved to the clip, profile or Lens they point at)\n• Lens URLs — `https://www.snapchat.com/lens/{uuid}` or `/unlock?uuid={uuid}`\n• Search / hashtag URLs — `https://www.snapchat.com/explore/{query}` (or just `#hashtag`)\n\nEach entry is auto-classified and the scraper emits the matching row type — one row per URL. Profile rows include AR Lenses, live story, Stories, Spotlights with AI titles + audio-transcription URLs, viewer comments and a contacts panel. Spotlight rows include the full audio transcript + 25-clip 'more like this' feed. Lens rows include the AR Lens detail + clips using it. Search rows aggregate matching spotlights, creators, lenses, episodes, places and topics.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "Max output rows",
            "minimum": 1,
            "type": "integer",
            "description": "Safety cap on billed output rows. In the default nested mode one URL = one row = one paid record; with 'One row per clip' on, every clip/snap row counts too. Useful to test cost on the first N rows before a full job. Free-plan runs are capped at 100 rows regardless. Default: 1000.",
            "default": 1000
          },
          "oneRowPerClip": {
            "title": "One row per clip (flat spreadsheet mode)",
            "type": "boolean",
            "description": "Profile URLs emit flat rows instead of one nested row: a profile summary row (bio, subscriber count, contacts, counts), then one row per Spotlight clip (views, shares, comments, AI title/keywords, transcript URL, direct video URL) and one row per story snap — each carrying the creator's username, profile URL and subscriber count, so every row stands alone in CSV or Excel. Each flat row is a billed output record and counts against Max output rows. Default: false (one nested row per URL).",
            "default": false
          },
          "includeSpotlightComments": {
            "title": "Include public Spotlight comments",
            "type": "boolean",
            "description": "Add the public viewer comments under each Spotlight clip: text, reactions, author display name and Bitmoji id, time, reply count and ranking score. A profile typically has 150–500. Each comment is billed at $0.0002 (see Pricing); stories, Spotlights, Lenses and related accounts in the row are not billed extra. Default: off.",
            "default": false
          },
          "maxCommentsPerSpotlight": {
            "title": "Max comments per Spotlight (0 = no limit)",
            "minimum": 0,
            "type": "integer",
            "description": "When > 0, keeps only the top-N comments per Spotlight by Snapchat's ranking score. Useful for sentiment analysis when you only need top engagement. Ignored when the toggle above is OFF.",
            "default": 0
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of profile pages processed in parallel.",
            "default": 5
          },
          "minConcurrency": {
            "title": "Min concurrency",
            "minimum": 1,
            "type": "integer",
            "description": "Minimum number of profile pages processed in parallel.",
            "default": 1
          },
          "maxRequestRetries": {
            "title": "Max request retries",
            "minimum": 0,
            "type": "integer",
            "description": "Number of retries before a failed request is given up.",
            "default": 5
          },
          "proxy": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Apify proxy settings. Proxy is off by default and runs are cheapest that way. Enable a residential pool only for very large input lists.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}