Snapchat User Spotlight Scraper

Extract Snapchat Spotlight videos from public user profiles. This actor scrapes video metadata including views, engagement stats, hashtags, and more.

Why Choose Us?

• Comprehensive Data Extraction: Get detailed metadata for every Spotlight video including views, shares, comments, boosts, and engagement statistics
• Smart Proxy Management: Automatic proxy fallback system ensures high success rates even when facing blocks
• Bulk Processing: Process multiple usernames concurrently for maximum efficiency
• Incremental Saving: Data is saved as it's extracted, so you never lose progress
• Robust Error Handling: Automatic retries with exponential backoff and proxy rotation

Key Features

• Extract Spotlight video metadata from Snapchat user profiles
• Support for bulk username processing
• Automatic proxy fallback (no proxy → datacenter → residential)
• Detailed engagement statistics (views, shares, comments, boosts)
• Video metadata (thumbnails, content URLs, deeplinks)
• Hashtag extraction
• Incremental data saving to Apify dataset
• Comprehensive logging for monitoring

Input

Input Schema

{
  "startUrls": [
    { "url": "https://www.snapchat.com/@realmadrid" },
    { "url": "https://www.snapchat.com/@fcbarcelona" }
  ],
  "sortOrder": "recent",
  "proxyConfiguration": {
    "useApifyProxy": false
  },
  "maxRetries": 3,
  "requestDelay": 1
}

Input Fields

• startUrls (required): Array of Snapchat profile URLs or usernames
  • Can be full URLs: https://www.snapchat.com/@username
  • Or just usernames: username or @username
• sortOrder (optional): Sort order for videos (recent, popular, trending). Default: recent
• proxyConfiguration (optional): Proxy settings
  • Default: No proxy
  • If blocked, automatically falls back to datacenter proxy
  • If still blocked, falls back to residential proxy with retries
• maxRetries (optional): Maximum retry attempts (1-5). Default: 3
• requestDelay (optional): Base delay between requests in seconds (0-10). Default: 1

Output

Output Format

Each video is saved as a separate dataset item:

{
  "username": "realmadrid",
  "videoTitle": "Spotlight Snap",
  "description": "#RealMadrid",
  "viewCount": 12995,
  "shareCount": 13,
  "commentCount": 31,
  "boostCount": 1311,
  "recommendCount": 124,
  "uploadDate": 1766173649643,
  "uploadDateMs": "1766173649643",
  "thumbnailUrl": "https://...",
  "contentUrl": "https://...",
  "deeplink": "https://...",
  "hashtags": ["#RealMadrid"],
  "durationMs": "50120",
  "width": 540,
  "height": 960,
  "success": true
}

Output Fields

• username: Snapchat username
• videoTitle: Title of the video
• description: Video description/caption
• viewCount: Number of views
• shareCount: Number of shares
• commentCount: Number of comments
• boostCount: Number of boosts
• recommendCount: Number of recommendations
• uploadDate: Upload timestamp (milliseconds)
• thumbnailUrl: Video thumbnail image URL
• contentUrl: Direct video content URL
• deeplink: Deep link to open video in Snapchat app
• hashtags: Array of hashtags used in the video
• durationMs: Video duration in milliseconds
• width: Video width in pixels
• height: Video height in pixels
• rawData: Complete raw data object from Snapchat
• success: Boolean indicating if extraction was successful

🚀 How to Use the Actor (via Apify Console)

1. Log in at https://console.apify.com and go to Actors.
2. Find your actor (snapchat-user-spotlight-scraper) and click it.
3. Configure inputs:
   • Add Snapchat usernames or profile URLs in the startUrls field
   • Optionally configure proxy settings
   • Adjust retry and delay settings if needed
4. Run the actor.
5. Monitor logs in real time to see extraction progress.
6. Access results in the OUTPUT tab.
7. Export results to JSON or CSV.

Best Use Cases

• Social Media Analytics: Track engagement metrics for Snapchat Spotlight content
• Content Research: Discover trending videos and hashtags
• Competitor Analysis: Monitor competitor Spotlight performance
• Influencer Research: Analyze Spotlight video performance for influencer marketing
• Content Strategy: Identify successful content patterns and trends

Frequently Asked Questions

Q: How many usernames can I process at once?
A: The actor supports bulk processing. There's no hard limit, but processing time increases with the number of usernames.

Q: What happens if a request is blocked?
A: The actor automatically falls back through proxy types: no proxy → datacenter → residential, with retries at each level.

Q: How long does extraction take?
A: Processing time depends on the number of usernames and videos. Typically, 1-2 seconds per username plus network latency.

Q: Can I extract private profile data?
A: No, this actor only extracts publicly available Spotlight videos from public profiles.

Q: What if a username has no Spotlight videos?
A: The actor will log a warning and continue processing other usernames. The failed username will be marked with success: false.

Support and Feedback

For issues, questions, or feature requests, please contact support through the Apify platform.

Cautions

• Data is collected only from publicly available sources.
• No data is taken from private accounts or password-protected content.
• The end user is responsible for ensuring legal compliance (spam laws, privacy, data protection, etc.).
• Respect Snapchat's Terms of Service and rate limits.
• Use appropriate delays between requests to avoid overwhelming the platform.