Snapchat User Stories Scraper 👻

🤖 What does Snapchat User Stories Scraper do?

This actor scrapes public stories content from Snapchat profiles. It extracts comprehensive story metadata, engagement metrics, and media URLs, perfect for social media monitoring and content analysis.

✨ Key Features

• 🎥 Extract detailed story metadata including:
  • Video content URLs and thumbnails
  • View and share counts
  • Upload dates and duration
  • Video dimensions
  • Hashtags and descriptions
• 📊 Capture engagement metrics
• 🔄 Proxy support for reliable scraping
• 💾 Structured data output

📋 Output Data Structure

Each story contains:

• Video metadata (URL, thumbnail, duration, dimensions)
• Engagement stats (views, shares)
• Creator information
• Hashtags and descriptions
• Upload timestamp
• Context cards (related sounds, profile links)
• Deep linking parameters

💡 Use Cases

• Social Media Content Analysis
• Influencer Marketing Research
• Engagement Tracking
• Content Performance Monitoring
• Trend Analysis
• Competitive Intelligence

🔧 Input Parameters

• usernames: Array of Snapchat usernames to scrape
• proxyConfiguration: Optional proxy settings

Input Example

A full explanation of an input example in JSON.

1{
2    "usernames": [
3		"fcbarcelona", "realmadrid"
4	]
5}

Output sample

The results will be wrapped into a dataset which you can always find in the Storage tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

1[
2	{
3		"videoMetadata": {
4			"name": "Spotlight Snap",
5			"description": "#fcbarcelona #laligahighlights",
6			"thumbnailUrl": "https://bolt-gcdn.sc-cdn.net/bp/Tc9g4501N7pZ0xcgzn4ks.256.IRZXSOY?mo=GkcaDRoAGgAyAVFIAlAuYAFaEERmTGFyZ2VUaHVtYm5haWyiARAIgAIiCxIAKgdJUlpYU09ZogEQCJoKIgsSACoHSVJaWFNPWQ%3D%3D&uc=46",
7			"viewCount": "31801",
8			"contentUrl": "https://bolt-gcdn.sc-cdn.net/bp/Tc9g4501N7pZ0xcgzn4ks.27.IRZXSOY?mo=GmAaDRoAGgAyAVFIAlAuYAFaEFNwb3RsaWdodFNoYXJpbmeiATgIGxInCiUgAUofChpbLCYpJissOzk_QUI_PTJWbWl4bkE1NVteYRD0A2gCIgsSACoHSVJaWFNPWZADkGc%3D&uc=46",
9			"creator": {
10				"$case": "personCreator",
11				"personCreator": {
12					"username": "FC Barcelona",
13					"url": "https://www.snapchat.com/add/FC%20Barcelona",
14					"name": ""
15				}
16			},
17			"durationMs": "13200",
18			"width": 540,
19			"height": 960,
20			"keywords": [],
21			"shareCount": "0",
22			"uploadDate": "2024-11-04T13:14:19.662Z"
23		},
24		"hashtags": [
25			"#fcbarcelona",
26			"#laligahighlights"
27		],
28		"contextCards": [
29			{
30				"contextType": 2,
31				"title": "@fcbarcelona's Sound",
32				"subtitle": "",
33				"url": "",
34				"thumbnailUrl": "https://cf-st.sc-cdn.net/d/6YKRUxipwtyh6YMgtaJbK?bo=Eg0aABoAMgEESAJQCGAB&uc=8",
35				"snapcodeUrl": "",
36				"thumbnailType": 2,
37				"hasBadge": false
38			},
39			{
40				"contextType": 3,
41				"title": "FC Barcelona",
42				"subtitle": "FC Barcelona",
43				"url": "https://www.snapchat.com/add/FC Barcelona",
44				"thumbnailUrl": "https://cf-st.sc-cdn.net/aps/bolt/aHR0cHM6Ly9jZi1zdC5zYy1jZG4ubmV0L2Qvbm1ObmtrTUhDbUxEUk5WRzNlZnBuP2JvPUVnMGFBQm9BTWdFRVNBSlFHV0FCJnVjPTI1._RS0,90_FMjpeg",
45				"snapcodeUrl": "https://app.snapchat.com/web/deeplink/snapcode?username=FC Barcelona&type=SVG&bitmoji=enable",
46				"thumbnailType": 0,
47				"hasBadge": true
48			}
49		],
50		"engagementStats": {
51			"viewCount": "31801",
52			"shareCount": "3"
53		},
54		"deeplink": "https://click.snapchat.com/aVHG?pid=snapchat_download_page&af_dp=https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYZXhybHN1cm9rAZL3T-HpAZL3T96OAAAAAQ?sc_referrer%3Dweb&af_web_dp=https://snapchat.com/download?purpose%3Dweb_stories%26sp%3Dspotlight&af_ios_url=https://apps.apple.com/app/apple-store/id447188370?pt%3D614006%26ct%3Dspotlight%26mt%3D8",
55		"oneLinkParams": {
56			"oneLinkBaseUrl": "https://click.snapchat.com/aVHG",
57			"pidKeys": [
58				"af_pid",
59				"utm_source"
60			],
61			"pidFallbackValue": "consumer_web",
62			"campaignKeys": [
63				"af_c",
64				"utm_campaign"
65			],
66			"campaignFallbackValue": "spotlight",
67			"googleClickIdParam": "af_sub1",
68			"deepLinkUrl": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYZXhybHN1cm9rAZL3T-HpAZL3T96OAAAAAQ?sc_referrer=web",
69			"iosAppStoreUrl": "https://apps.apple.com/app/apple-store/id447188370?pt=614006&ct=spotlight&mt=8",
70			"desktopPageUrl": "https://snapchat.com/download?purpose=web_stories&sp=spotlight"
71		},
72		"description": "#fcbarcelona #laligahighlights",
73		"username": "fcbarcelona"
74	},
75    ...
76]