Snapchat Spotlight Comment & Reaction Scraper

{
  "description": "Scrape public Snapchat Spotlight comment threads and replies by video URL, creator, hashtag or country feed.",
  "properties": {
    "country": {
      "default": "US",
      "description": "(mode=byFeed) Country whose trending Spotlight feed is used.",
      "editor": "select",
      "enum": [
        "AF",
        "AL",
        "DZ",
        "AS",
        "AD",
        "AO",
        "AI",
        "AQ",
        "AG",
        "AR",
        "AM",
        "AW",
        "AU",
        "AT",
        "AZ",
        "BS",
        "BH",
        "BD",
        "BB",
        "BY",
        "BE",
        "BZ",
        "BJ",
        "BM",
        "BT",
        "BO",
        "BQ",
        "BA",
        "BW",
        "BV",
        "BR",
        "IO",
        "BN",
        "BG",
        "BF",
        "BI",
        "CV",
        "KH",
        "CM",
        "CA",
        "KY",
        "CF",
        "TD",
        "CL",
        "CN",
        "CX",
        "CC",
        "CO",
        "KM",
        "CG",
        "CD",
        "CK",
        "CR",
        "HR",
        "CU",
        "CW",
        "CY",
        "CZ",
        "CI",
        "DK",
        "DJ",
        "DM",
        "DO",
        "EC",
        "EG",
        "SV",
        "GQ",
        "ER",
        "EE",
        "SZ",
        "ET",
        "FK",
        "FO",
        "FJ",
        "FI",
        "FR",
        "GF",
        "PF",
        "TF",
        "GA",
        "GM",
        "GE",
        "DE",
        "GH",
        "GI",
        "GR",
        "GL",
        "GD",
        "GP",
        "GU",
        "GT",
        "GG",
        "GN",
        "GW",
        "GY",
        "HT",
        "HM",
        "VA",
        "HN",
        "HK",
        "HU",
        "IS",
        "IN",
        "ID",
        "IR",
        "IQ",
        "IE",
        "IM",
        "IL",
        "IT",
        "JM",
        "JP",
        "JE",
        "JO",
        "KZ",
        "KE",
        "KI",
        "KP",
        "KR",
        "KW",
        "KG",
        "LA",
        "LV",
        "LB",
        "LS",
        "LR",
        "LY",
        "LI",
        "LT",
        "LU",
        "MO",
        "MG",
        "MW",
        "MY",
        "MV",
        "ML",
        "MT",
        "MH",
        "MQ",
        "MR",
        "MU",
        "YT",
        "MX",
        "FM",
        "MD",
        "MC",
        "MN",
        "ME",
        "MS",
        "MA",
        "MZ",
        "MM",
        "NA",
        "NR",
        "NP",
        "NL",
        "NC",
        "NZ",
        "NI",
        "NE",
        "NG",
        "NU",
        "NF",
        "MK",
        "MP",
        "NO",
        "OM",
        "PK",
        "PW",
        "PS",
        "PA",
        "PG",
        "PY",
        "PE",
        "PH",
        "PN",
        "PL",
        "PT",
        "PR",
        "QA",
        "RO",
        "RU",
        "RW",
        "RE",
        "BL",
        "SH",
        "KN",
        "LC",
        "MF",
        "PM",
        "VC",
        "WS",
        "SM",
        "ST",
        "SA",
        "SN",
        "RS",
        "SC",
        "SL",
        "SG",
        "SX",
        "SK",
        "SI",
        "SB",
        "SO",
        "ZA",
        "GS",
        "SS",
        "ES",
        "LK",
        "SD",
        "SR",
        "SJ",
        "SE",
        "CH",
        "SY",
        "TW",
        "TJ",
        "TZ",
        "TH",
        "TL",
        "TG",
        "TK",
        "TO",
        "TT",
        "TN",
        "TM",
        "TC",
        "TV",
        "TR",
        "UG",
        "UA",
        "AE",
        "GB",
        "US",
        "UM",
        "UY",
        "UZ",
        "VU",
        "VE",
        "VN",
        "VG",
        "VI",
        "WF",
        "EH",
        "YE",
        "ZM",
        "ZW",
        "AX"
      ],
      "enumTitles": [
        "Afghanistan",
        "Albania",
        "Algeria",
        "American Samoa",
        "Andorra",
        "Angola",
        "Anguilla",
        "Antarctica",
        "Antigua and Barbuda",
        "Argentina",
        "Armenia",
        "Aruba",
        "Australia",
        "Austria",
        "Azerbaijan",
        "Bahamas",
        "Bahrain",
        "Bangladesh",
        "Barbados",
        "Belarus",
        "Belgium",
        "Belize",
        "Benin",
        "Bermuda",
        "Bhutan",
        "Bolivia, Plurinational State of",
        "Bonaire, Sint Eustatius and Saba",
        "Bosnia and Herzegovina",
        "Botswana",
        "Bouvet Island",
        "Brazil",
        "British Indian Ocean Territory",
        "Brunei Darussalam",
        "Bulgaria",
        "Burkina Faso",
        "Burundi",
        "Cabo Verde",
        "Cambodia",
        "Cameroon",
        "Canada",
        "Cayman Islands",
        "Central African Republic",
        "Chad",
        "Chile",
        "China",
        "Christmas Island",
        "Cocos (Keeling) Islands",
        "Colombia",
        "Comoros",
        "Congo",
        "Congo, The Democratic Republic of the",
        "Cook Islands",
        "Costa Rica",
        "Croatia",
        "Cuba",
        "Curaçao",
        "Cyprus",
        "Czechia",
        "Côte d'Ivoire",
        "Denmark",
        "Djibouti",
        "Dominica",
        "Dominican Republic",
        "Ecuador",
        "Egypt",
        "El Salvador",
        "Equatorial Guinea",
        "Eritrea",
        "Estonia",
        "Eswatini",
        "Ethiopia",
        "Falkland Islands (Malvinas)",
        "Faroe Islands",
        "Fiji",
        "Finland",
        "France",
        "French Guiana",
        "French Polynesia",
        "French Southern Territories",
        "Gabon",
        "Gambia",
        "Georgia",
        "Germany",
        "Ghana",
        "Gibraltar",
        "Greece",
        "Greenland",
        "Grenada",
        "Guadeloupe",
        "Guam",
        "Guatemala",
        "Guernsey",
        "Guinea",
        "Guinea-Bissau",
        "Guyana",
        "Haiti",
        "Heard Island and McDonald Islands",
        "Holy See (Vatican City State)",
        "Honduras",
        "Hong Kong",
        "Hungary",
        "Iceland",
        "India",
        "Indonesia",
        "Iran, Islamic Republic of",
        "Iraq",
        "Ireland",
        "Isle of Man",
        "Israel",
        "Italy",
        "Jamaica",
        "Japan",
        "Jersey",
        "Jordan",
        "Kazakhstan",
        "Kenya",
        "Kiribati",
        "Korea, Democratic People's Republic of",
        "Korea, Republic of",
        "Kuwait",
        "Kyrgyzstan",
        "Lao People's Democratic Republic",
        "Latvia",
        "Lebanon",
        "Lesotho",
        "Liberia",
        "Libya",
        "Liechtenstein",
        "Lithuania",
        "Luxembourg",
        "Macao",
        "Madagascar",
        "Malawi",
        "Malaysia",
        "Maldives",
        "Mali",
        "Malta",
        "Marshall Islands",
        "Martinique",
        "Mauritania",
        "Mauritius",
        "Mayotte",
        "Mexico",
        "Micronesia, Federated States of",
        "Moldova, Republic of",
        "Monaco",
        "Mongolia",
        "Montenegro",
        "Montserrat",
        "Morocco",
        "Mozambique",
        "Myanmar",
        "Namibia",
        "Nauru",
        "Nepal",
        "Netherlands",
        "New Caledonia",
        "New Zealand",
        "Nicaragua",
        "Niger",
        "Nigeria",
        "Niue",
        "Norfolk Island",
        "North Macedonia",
        "Northern Mariana Islands",
        "Norway",
        "Oman",
        "Pakistan",
        "Palau",
        "Palestine, State of",
        "Panama",
        "Papua New Guinea",
        "Paraguay",
        "Peru",
        "Philippines",
        "Pitcairn",
        "Poland",
        "Portugal",
        "Puerto Rico",
        "Qatar",
        "Romania",
        "Russian Federation",
        "Rwanda",
        "Réunion",
        "Saint Barthélemy",
        "Saint Helena, Ascension and Tristan da Cunha",
        "Saint Kitts and Nevis",
        "Saint Lucia",
        "Saint Martin (French part)",
        "Saint Pierre and Miquelon",
        "Saint Vincent and the Grenadines",
        "Samoa",
        "San Marino",
        "Sao Tome and Principe",
        "Saudi Arabia",
        "Senegal",
        "Serbia",
        "Seychelles",
        "Sierra Leone",
        "Singapore",
        "Sint Maarten (Dutch part)",
        "Slovakia",
        "Slovenia",
        "Solomon Islands",
        "Somalia",
        "South Africa",
        "South Georgia and the South Sandwich Islands",
        "South Sudan",
        "Spain",
        "Sri Lanka",
        "Sudan",
        "Suriname",
        "Svalbard and Jan Mayen",
        "Sweden",
        "Switzerland",
        "Syrian Arab Republic",
        "Taiwan, Province of China",
        "Tajikistan",
        "Tanzania, United Republic of",
        "Thailand",
        "Timor-Leste",
        "Togo",
        "Tokelau",
        "Tonga",
        "Trinidad and Tobago",
        "Tunisia",
        "Turkmenistan",
        "Turks and Caicos Islands",
        "Tuvalu",
        "Türkiye",
        "Uganda",
        "Ukraine",
        "United Arab Emirates",
        "United Kingdom",
        "United States",
        "United States Minor Outlying Islands",
        "Uruguay",
        "Uzbekistan",
        "Vanuatu",
        "Venezuela, Bolivarian Republic of",
        "Viet Nam",
        "Virgin Islands, British",
        "Virgin Islands, U.S.",
        "Wallis and Futuna",
        "Western Sahara",
        "Yemen",
        "Zambia",
        "Zimbabwe",
        "Åland Islands"
      ],
      "prefill": "US",
      "title": "Feed country",
      "type": "string"
    },
    "includeReplies": {
      "default": false,
      "description": "Emit direct replies as separate rows with parentCommentId and depth 1.",
      "prefill": false,
      "title": "Include replies",
      "type": "boolean"
    },
    "maxCommentsPerVideo": {
      "default": 100,
      "description": "Maximum comment rows per Spotlight video, including replies when enabled. Set high (for example 100000) for the full public thread.",
      "maximum": 100000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max comments per video",
      "type": "integer"
    },
    "maxItems": {
      "default": 1000000,
      "description": "Global cap on dataset rows. The default is effectively unlimited for backward compatibility.",
      "maximum": 1000000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max rows",
      "type": "integer"
    },
    "maxVideosPerSource": {
      "default": 50,
      "description": "For username, topic and feed modes, stop after this many Spotlight videos per source. Ignored for explicit URLs.",
      "maximum": 100,
      "minimum": 1,
      "prefill": 1,
      "title": "Max videos per source",
      "type": "integer"
    },
    "mode": {
      "default": "byUsername",
      "description": "Choose what to scrape: specific Spotlight videos, creator profiles, hashtags/topics, or the trending country feed.",
      "editor": "select",
      "enum": [
        "bySpotlightUrls",
        "byUsername",
        "byTopic",
        "byFeed"
      ],
      "enumTitles": [
        "Spotlight URLs or IDs",
        "Creator usernames",
        "Hashtags / topics",
        "Trending feed by country"
      ],
      "prefill": "byUsername",
      "title": "Mode",
      "type": "string"
    },
    "spotlightUrls": {
      "description": "(mode=bySpotlightUrls) One or more Spotlight URLs, @user/spotlight links, t.snapchat.com links, or raw snap IDs.",
      "editor": "stringList",
      "title": "Spotlight URLs or IDs",
      "type": "array"
    },
    "topics": {
      "default": [
        "food"
      ],
      "description": "(mode=byTopic) Hashtags or topics, or /tag, /explore and /topic URLs.",
      "editor": "stringList",
      "prefill": [
        "food"
      ],
      "title": "Hashtags or topics",
      "type": "array"
    },
    "usernames": {
      "default": [
        "brentrivera"
      ],
      "description": "(mode=byUsername) Snapchat usernames, @names, /add/name or /@name profile URLs.",
      "editor": "stringList",
      "prefill": [
        "brentrivera"
      ],
      "title": "Creator usernames",
      "type": "array"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "Snapchat Spotlight Comments Scraper",
  "type": "object"
}

{
  "actorOutputSchemaVersion": 1,
  "description": "Snapchat Spotlight comments and replies with commenter details, reactions, moderation fields, timestamps and hydrated video context.",
  "properties": {
    "comments": {
      "description": "Dataset containing all scraped Snapchat Spotlight comment, reply and error rows.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Spotlight comments and replies",
      "type": "string"
    }
  },
  "title": "Snapchat Spotlight Comment & Reaction Scraper Output"
}

{
  "actorSpecification": 1,
  "fields": {
    "properties": {
      "approvalState": {
        "description": "Moderation state (3 = approved)",
        "type": "integer"
      },
      "commentId": {
        "description": "Unique comment ID (highBits-lowBits)",
        "type": "string"
      },
      "commenterBitmojiAvatarId": {
        "description": "Commenter Bitmoji avatar ID",
        "type": "string"
      },
      "commenterBitmojiSelfieId": {
        "description": "Commenter Bitmoji selfie ID",
        "type": "string"
      },
      "commenterDisplayName": {
        "description": "Commenter display name",
        "type": "string"
      },
      "commenterId": {
        "description": "Commenter account UUID pair",
        "type": "string"
      },
      "commenterIsPostAuthor": {
        "description": "Whether the commenter is the video creator",
        "type": "boolean"
      },
      "commenterProfileId": {
        "description": "Commenter business profile UUID pair",
        "type": "string"
      },
      "commenterProfileLogoUrl": {
        "description": "Commenter profile logo URL",
        "type": "string"
      },
      "commenterProfileUrl": {
        "description": "Commenter profile URL when a username is available",
        "type": "string"
      },
      "commenterUsername": {
        "description": "Commenter username when Snapchat exposes it",
        "type": "string"
      },
      "creatorDisplayName": {
        "description": "Video creator display name",
        "type": "string"
      },
      "creatorIsOfficial": {
        "description": "Emitted only when the creator is officially verified",
        "type": "boolean"
      },
      "creatorProfileUrl": {
        "description": "Video creator profile URL",
        "type": "string"
      },
      "creatorUsername": {
        "description": "Video creator username",
        "type": "string"
      },
      "depth": {
        "description": "0 for root comments, 1 for replies",
        "type": "integer"
      },
      "error": {
        "description": "Error message for error rows",
        "type": "string"
      },
      "feedCountry": {
        "description": "ISO country code of the trending feed (byFeed mode)",
        "type": "string"
      },
      "inputUrl": {
        "description": "Input Spotlight URL (bySpotlightUrls mode)",
        "type": "string"
      },
      "inputUsername": {
        "description": "Input username for error rows",
        "type": "string"
      },
      "likeCount": {
        "description": "Sum of all reaction counts",
        "type": "integer"
      },
      "parentCommentId": {
        "description": "Parent comment ID for reply rows",
        "type": "string"
      },
      "postedAt": {
        "description": "ISO 8601 UTC time the comment was posted",
        "type": "string"
      },
      "rankingScore": {
        "description": "Snapchat ranking score when present",
        "type": "number"
      },
      "reactionCounts": {
        "description": "Reaction breakdown [{reactTypeId, count}]",
        "items": {
          "properties": {
            "count": {
              "type": "integer"
            },
            "reactTypeId": {
              "type": "string"
            }
          },
          "type": "object"
        },
        "type": "array"
      },
      "recordType": {
        "description": "Row type: comment or error",
        "type": "string"
      },
      "replyText": {
        "description": "Comment or reply text",
        "type": "string"
      },
      "reportCount": {
        "description": "Number of times the comment was reported",
        "type": "integer"
      },
      "scrapedAt": {
        "description": "ISO 8601 UTC scrape timestamp",
        "type": "string"
      },
      "snapId": {
        "description": "Spotlight snap ID this comment belongs to",
        "type": "string"
      },
      "snapUrl": {
        "description": "Canonical Spotlight video URL",
        "type": "string"
      },
      "sourceUsername": {
        "description": "Creator username (byUsername mode)",
        "type": "string"
      },
      "threadedReplyCount": {
        "description": "Number of direct replies",
        "type": "integer"
      },
      "topic": {
        "description": "Hashtag or topic slug (byTopic mode)",
        "type": "string"
      },
      "topicUrl": {
        "description": "Tag, explore or topic page used for discovery",
        "type": "string"
      },
      "updatedAt": {
        "description": "ISO 8601 UTC time the comment state last changed",
        "type": "string"
      },
      "videoAiDescription": {
        "description": "Snapchat-generated description for the video",
        "type": "string"
      },
      "videoAiTitle": {
        "description": "Snapchat-generated title for the video",
        "type": "string"
      },
      "videoBoostCount": {
        "description": "Video boost (like) count",
        "type": "integer"
      },
      "videoCaption": {
        "description": "Video caption or description",
        "type": "string"
      },
      "videoCommentCount": {
        "description": "Comment count reported by Snapchat",
        "type": "integer"
      },
      "videoDurationSeconds": {
        "description": "Video duration in seconds",
        "type": "number"
      },
      "videoHashtags": {
        "description": "Hashtags attached to the video",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "videoHeight": {
        "description": "Video height in pixels",
        "type": "integer"
      },
      "videoKeywords": {
        "description": "Snapchat-generated keywords for the video",
        "items": {
          "type": "string"
        },
        "type": "array"
      },
      "videoPostedAt": {
        "description": "ISO 8601 UTC video creation time",
        "type": "string"
      },
      "videoRecommendCount": {
        "description": "Video recommend count",
        "type": "integer"
      },
      "videoShareCount": {
        "description": "Video share count",
        "type": "integer"
      },
      "videoThumbnailUrl": {
        "description": "Video thumbnail URL",
        "type": "string"
      },
      "videoUrl": {
        "description": "Watermarked video URL",
        "type": "string"
      },
      "videoViewCount": {
        "description": "Video view count",
        "type": "integer"
      },
      "videoWidth": {
        "description": "Video width in pixels",
        "type": "integer"
      }
    },
    "type": "object"
  },
  "title": "Snapchat Spotlight Comments"
}