Snapchat Snap Map Place & Live Snap Extractor

Snap Map shows the public snaps and places people are posting about right now. This actor reads Snapchat's public web pages and turns them into a clean dataset: place coordinates, address, category, rating, opening hours, a 7×24 popularity heatmap and the public snap sample at each place, with media URLs, creators and timestamps. Search by keyword, paste place links, or browse US cities and categories. No Snapchat account, cookies, API key or proxy setup is needed.

What you can collect

• Place search — one keyword returns the Snap Map places Snapchat matches, plus the public Spotlight videos, creators, profiles, publishers, episodes and lenses shown for the same query.
• Place details — paste place URLs or UUIDs and get the full public place profile: geometry, address, phone, website, category, rating and reviews, opening hours, favorites and nearby places.
• Live snaps — every place page carries a sample of public snaps posted at or shared about the place: media URL, thumbnail, video or image type, creator username and display name, timestamp and snap source (map or spotlight). Snapchat mixes recent map posts with older Spotlight shares, so use snapMaxAgeHours when you need a fresh-only feed.
• 7×24 popularity — Snapchat's hourly popularity values for the whole week (168 values), plus the peak hour and day index. Use it as a per-place heatmap signal.
• US city and category discovery — browse a city hub or a category page such as bars, restaurants or historic landmarks. Each row includes the live-snap count, rating, popularity hours and coordinates, which makes it easy to map activity.
• Flat live-snap rows — switch the output to one row per snap when you want a snap-level dataset instead of nested arrays.

Modes

Mode	What it does	Main input
searchPlaces	Search Snap Map and optionally the other Explore result groups	keywords
placeDetails	Load full details for specific places	placeUrls
browseLocal	Browse a US city hub or category pages	cityUrls, optional categories

Input

Field	Type	Default	Description
mode	select	searchPlaces	Which collection mode to run
keywords	string list	—	Place names or landmarks for search mode; the form prefill uses ["Times Square"]
placeUrls	string list	—	Full place URLs, /place/... paths or bare place UUIDs
cityUrls	string list	—	US city names, Snapchat local URLs or local paths
categories	string list	—	Category slugs for browse mode, e.g. bars, restaurants, historic-landmarks
resultTypes	multi-select	["places"]	Explore groups to return: places, spotlight, users, profiles, publishers, episodes, lenses
outputType	select	placeRecords	One row per place, or one row per live snap
maxResultsPerKeyword	integer	10	Cap per result type per keyword
maxPlaces	integer	100	Cap for place-details mode
maxPlacesPerCity	integer	100	Cap per city in browse mode
maxSnapsPerPlace	integer	10	Live snaps to keep per place
includeSnapData	boolean	true	Add the public snap sample and the legacy first-snap fields
includePlaceDetails	boolean	true	Open each place page for coordinates, contact, rating and hours; nearby/reviews/live-snap output open pages automatically
includeNearbyPlaces	boolean	false	Add the places Snapchat lists at the same location
includeReviews	boolean	false	Add up to 20 public place reviews
includePopularityHours	boolean	true	Add the 168-value popularity series and peak
minRating	number	0	Keep places at or above this rating
requireLiveSnaps	boolean	false	Keep only places that currently have public snaps
snapMaxAgeHours	integer	0	Keep only snaps newer than this; 0 keeps all. Counts and latestSnapAt reflect kept snaps
sortBy	select	source	Order by source, rating, favorites or live-snap count
proxyConfiguration	proxy	—	Optional; the public pages work without a proxy

Legacy tasks keep working: maxPlacesPerKeyword from older versions is read in code and mapped onto maxResultsPerKeyword.

Output

Every row has recordType so mixed datasets stay readable: place, liveSnap, spotlight, user, profile, publisher, episode or lens. Empty fields are omitted, never written as null, "" or [].

Place fields

Field	Description
placeId	Snapchat place UUID
displayName, placeUrl	Place name and canonical Snapchat URL
lat, lng, boundingBox	Centroid and southwest/northeast bounds
address	Street, city, region, postal code, country and formatted address
categoryName, categoryId, placeType	Snapchat category and place type
phone, email, website, menuUrl, reservationUrl, storeUrl	Public contact and action links
rating, reviewCount, ratingProvider, ratings	Public rating summary (provider value is rounded to 2 decimals)
reviews	Optional review rows with text, rating, date and source URL
openingHours	Day-by-day ranges, special hours and time zone
isOpen	Open-now flag from local discovery pages
favoriteCount, favoriteDisplayCount	Snapchat favorite count
profilePhotoUrl, profilePhotoProvider, photoUrls	Public photos
popularityHours	168 hourly values, 7 days × 24 hours
popularityPeakHour, popularityPeakDayIndex, popularityPeakValue	Peak of the series (day index 0 = Sunday)
liveSnapCount, latestSnapAt, liveSnaps	Public snap sample after snapMaxAgeHours filtering, its latest timestamp and up to maxSnapsPerPlace rows
nearbyPlaces	Optional places at the same location
placeHierarchy	Neighborhood, ZIP, city and state breadcrumbs
snapCount, firstSnapId, thumbnailUrl	Legacy place-level snap fields
snapId, mediaUrl, previewUrl, mediaType, postedAt, creatorUsername, creatorDisplayName	Legacy first-snap aliases
scrapedAt, sourcePage	Collection timestamp and source surface

Live snap row fields (outputType: liveSnapRecords)

snapId, placeId, placeName, categoryName, city, lat, lng, mediaUrl, thumbnailUrl, previewUrl, mediaType, storyType, duration, postedAt, creatorUsername, creatorDisplayName, creatorUserId, scrapedAt.

Example: search

{
  "mode": "searchPlaces",
  "keywords": ["Times Square"],
  "maxResultsPerKeyword": 3,
  "includePlaceDetails": true,
  "includeSnapData": true,
  "includePopularityHours": true
}

Example: place details

{
  "mode": "placeDetails",
  "placeUrls": ["https://www.snapchat.com/place/times-square/c8b4f0ee-9992-11e8-88c9-673ed985ff70"],
  "includeNearbyPlaces": true,
  "includeReviews": true
}

Example: city browse

{
  "mode": "browseLocal",
  "cityUrls": ["new-york"],
  "categories": ["bars", "restaurants"],
  "outputType": "liveSnapRecords",
  "maxSnapsPerPlace": 5
}

How the popularity heatmap works

Snapchat publishes 168 popularity integers per place, one for every hour of the week. The array starts at hour 0 and runs through the week, so popularityPeakHour is index % 24 and popularityPeakDayIndex is index // 24 (0 = Sunday). The values are relative popularity, not absolute visitor counts.

Limits

• Snap Map mobile API is not used. The app's private endpoints (ms.sc-jpl.com) refuse every web and cloud TLS client, so this actor uses Snapchat's public web pages instead. Live snaps and popularity come from the public place pages.
• Local discovery covers the United States. Snapchat's /local directory returns 404 outside the US.
• 20 places per city or category page. The page reports a larger total but serves a 20-row display cap; split by category to get more rows.
• Search groups are capped by Snapchat. Places return up to 10 rows and other groups about 20–24; there is no cursor.
• Live snaps are a public sample, not a real-time feed. A place page exposes roughly 2–36 snaps mixing recent map posts with older Spotlight shares (verified samples span hours to over a year). snapMaxAgeHours keeps only the age you want, and liveSnapCount reflects the kept rows. City pages carry their own older story samples; the default includePlaceDetails: true and the liveSnapRecords output read the place pages instead.
• Some legacy snap fields are gone. The 2026 page payload no longer publishes duration, width, height, overlay text or sponsored flags, so those keys appear only when Snapchat supplies them.

FAQ

Do I need a Snapchat account or cookies? No. Every surface used here is public.

Do I need a proxy? No. The pages load directly. A proxy field is available if you want extra redundancy.

Why is a field missing on some places? Snapchat does not publish every field for every place. Missing values are omitted rather than filled with placeholders.

Can I get snaps for a radius or a map tile? That is the Snap Map app API, which is not reachable from web clients. Use place details or city browse for public snap data, and join lat/lng with your own geometry.

Are media URLs permanent? They are public CDN links that work without cookies or a Referer and are cached for a day. Snapchat can expire them, so download the media promptly if you need the file.

Is this affiliated with Snapchat? No. This actor independently reads Snapchat's public web pages and is not affiliated with or endorsed by Snap Inc.