# Snapchat Snap Map Scraper (`crawlerbros/snapchat-snap-map-scraper`) Actor Scrape public Snap Map place data from Snapchat by place name or landmark. Returns place coordinates, snap count, thumbnails and first-snap media URLs. No login or cookies required. - **URL**: https://apify.com/crawlerbros/snapchat-snap-map-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Automation, Developer tools, Social media - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Snapchat Snap Map Scraper Collect public Snap Map place data by searching for any landmark, venue, or location name. For each matching place, the actor returns precise coordinates, category details, snap counts, and media URLs from the most recent public snap posted at that location — all without needing a Snapchat account or proxy. ### What This Actor Does - Searches Snapchat's public Explore pages for places matching your keywords - Returns up to 20 matching places per keyword with full geographic metadata - Optionally fetches the most recent public snap at each place — video URL, preview, duration, and creator info - Works without login, cookies, or proxy — uses Snapchat's publicly accessible Explore pages ### Input | Field | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | `keywords` | string[] | Yes | — | Place names or landmarks to search on Snap Map. Examples: `Times Square`, `Eiffel Tower`, `Tokyo Station`, `Colosseum` | | `maxPlacesPerKeyword` | integer | No | `5` | Maximum number of matching places to return per keyword (1–20) | | `includeSnapData` | boolean | No | `true` | Fetch media URL and snap details for the most recent public snap at each place | | `proxyConfiguration` | object | No | — | Optional proxy. Snapchat Explore pages are publicly accessible without proxy | #### Example Input ```json { "keywords": ["Times Square", "Eiffel Tower", "Tokyo Station"], "maxPlacesPerKeyword": 5, "includeSnapData": true } ```` ### Output Each matching place produces one dataset record. Snap-specific fields are only present when the place has active snaps and `includeSnapData` is enabled. | Field | Type | Description | |-------|------|-------------| | `placeId` | string | Unique Snapchat place identifier (UUID) | | `keyword` | string | Search keyword that returned this place | | `displayName` | string | Place display name (e.g. `Times Square`) | | `locality` | string | Address or city string for the place | | `lat` | number | Centroid latitude of the place | | `lng` | number | Centroid longitude of the place | | `boundingBox` | object | Geographic bounding box — `{p1: {lat, lng}, p2: {lat, lng}}` where p1 is southwest and p2 is northeast | | `categoryName` | string | Place category (e.g. `Monument / Landmark`, `Restaurant`, `University`) | | `categoryIconUrl` | string | CDN URL for the category icon image | | `profilePhotoUrl` | string | Profile photo URL of the place | | `favoriteCount` | integer | Number of Snapchat users who have favorited this place | | `snapCount` | integer | Number of public snaps currently at this place on the Snap Map | | `firstSnapId` | string | Snap ID of the most recent public snap at this place | | `thumbnailUrl` | string | Thumbnail preview URL for the place's snap story | | `mediaUrl` | string | CDN media URL of the most recent snap (video or image) | | `previewUrl` | string | Low-resolution preview thumbnail URL of the most recent snap | | `mediaType` | string | Media type of the most recent snap: `video` or `image` | | `duration` | integer | Duration of the snap video in milliseconds | | `width` | integer | Width of the snap video in pixels | | `height` | integer | Height of the snap video in pixels | | `postedAt` | string | ISO 8601 UTC timestamp when the most recent snap was posted | | `overlayText` | string | Text overlay shown on the snap | | `snapTitle` | string | Title shown with the snap (when present) | | `creatorUsername` | string | Snapchat username of the snap creator | | `creatorDisplayName` | string | Display name of the snap creator | | `scrapedAt` | string | ISO 8601 UTC timestamp of when this record was collected | #### Example Output — Place with Snap ```json { "placeId": "150f13bc-fe7f-498c-80a2-418ed3c70a4b", "keyword": "Times Square", "displayName": "Times Square", "locality": "1560 Broadway, New York City", "lat": 40.7579747, "lng": -73.9855426, "boundingBox": { "p1": { "lat": 40.7579247, "lng": -73.9855926 }, "p2": { "lat": 40.7580247, "lng": -73.9854926 } }, "categoryName": "Monument / Landmark", "categoryIconUrl": "https://cf-st.sc-cdn.net/snapzen-assets/...", "profilePhotoUrl": "https://cf-st.sc-cdn.net/snapzen-assets/...", "favoriteCount": 42722, "snapCount": 5, "firstSnapId": "W7_EDlXWTBiXAEEniNoMPwAAYeWdidWZhaWZnAZ6-sUewAZ6-sUeWAAAAAQ", "thumbnailUrl": "https://cf-st.sc-cdn.net/n/I124gGgubE0...", "mediaUrl": "https://cf-st.sc-cdn.net/n/I124gGgubE0...", "previewUrl": "https://cf-st.sc-cdn.net/n/I124gGgubE0...", "mediaType": "video", "duration": 8000, "width": 540, "height": 960, "postedAt": "2026-06-13T01:55:49+00:00", "overlayText": "Spotlight Snap", "creatorUsername": "@exampleuser", "creatorDisplayName": "Example User", "scrapedAt": "2026-06-28T06:50:17.903547+00:00" } ``` #### Example Output — Place without Active Snaps ```json { "placeId": "0bae027e-72ae-44d5-b1b7-c4c94f71e912", "keyword": "Karachi Pakistan", "displayName": "Karachi Pakistan", "locality": "W5C3+JRW, کراچی", "lat": 24.921605, "lng": 67.154591, "boundingBox": { "p1": { "lat": 24.921555, "lng": 67.154541 }, "p2": { "lat": 24.921655, "lng": 67.154641 } }, "categoryName": "Residential Area", "categoryIconUrl": "https://cf-st.sc-cdn.net/aps/bolt/...", "profilePhotoUrl": "https://cf-st.sc-cdn.net/aps/bolt/...", "favoriteCount": 2, "scrapedAt": "2026-06-28T06:50:15.993182+00:00" } ``` ### Use Cases - **Location intelligence** — enrich a list of venues or landmarks with Snapchat Snap Map coverage data - **Event monitoring** — track snap activity at stadiums, concert venues, or public events in real time - **Tourism research** — identify which landmarks generate the most snaps and engagement on Snapchat - **Geospatial datasets** — collect precise coordinates and bounding boxes for landmarks using Snapchat's place database - **Social media monitoring** — observe what kinds of content appear at specific locations ### FAQ **Do I need a Snapchat account or cookies?** No. The actor uses Snapchat's public Explore pages (`snapchat.com/explore/...`) which are fully accessible without login or authentication. **Do I need a proxy?** No proxy is required. Snapchat Explore pages are served as standard HTML without IP-level restrictions. You can optionally add an Apify proxy for extra reliability at high volume. **Why do some records not have `mediaUrl` or snap fields?** Snaps expire. When the most recent snap at a place has expired, or when a place currently has no active public snaps, the snap-specific fields are absent. The place record is still returned with all place-level metadata. **How many places are returned per keyword?** By default 5, configurable up to 20. The number of results depends on how many places Snapchat associates with the search term — well-known landmarks typically return several results while very specific queries may return fewer. **Can I search for restaurants, neighborhoods, or addresses?** Yes. Any place name that Snapchat knows about works — landmarks, stadiums, restaurants, universities, parks, airports, and neighborhoods are all supported. **What is the `boundingBox` field?** The precise geographic rectangle that encloses the place, provided as `{p1: {lat, lng}, p2: {lat, lng}}` where p1 is the southwest corner and p2 is the northeast corner. Useful for mapping integrations and spatial queries. **Can I get all snaps at a place, not just the most recent one?** No. Snapchat's public Explore API exposes only the most recent public snap at each place. The full snap playlist requires the Snapchat mobile app API which is not accessible from web clients. *** ### Other Snapchat Scrapers Explore the full Snapchat scraper suite on Apify: | Actor | Description | |-------|-------------| | [Snapchat Profile Scraper](https://apify.com/crawlerbros/snapchat-profile-scraper) | Full profile metadata, highlights, lenses, and spotlight data | | [Snapchat Hashtag Scraper](https://apify.com/crawlerbros/snapchat-hashtag-scraper) | Spotlight videos by hashtag or topic with AI metadata | | [Snapchat User Stories Scraper](https://apify.com/crawlerbros/snapchat-user-stories-scraper) | Curated highlights and active story snaps | | [Snapchat Spotlight Video Downloader](https://apify.com/crawlerbros/snapchat-spotlight-video-downloader) | Download Spotlight videos with AI metadata, transcripts, and comments | | [Snapchat Search Scraper](https://apify.com/crawlerbros/snapchat-search-scraper) | Search across videos, lenses, users, places, and shows | | [Snapchat Lens Scraper](https://apify.com/crawlerbros/snapchat-lens-scraper) | AR lens metadata, trending lenses, and creator info | | [Snapchat Publisher Scraper](https://apify.com/crawlerbros/snapchat-publisher-scraper) | Discover publisher pages, shows, episodes, and spotlights | | [Snapchat Ads Gallery Scraper](https://apify.com/crawlerbros/snapchat-ads-gallery-scraper) | EU/UK ad transparency library — ads and sponsored content | | [Snapchat Spotlight Comments Scraper](https://apify.com/crawlerbros/snapchat-spotlight-comments-scraper) | Comment threads from Spotlight videos | | [Snapchat Topic Scraper](https://apify.com/crawlerbros/snapchat-topic-scraper) | Spotlight videos by topic with related tags | | [Snapchat Snapcode Scraper](https://apify.com/crawlerbros/snapchat-snapcode-scraper) | Download Snapcode images (SVG/PNG) for any username | | [Snapchat Snap Map Scraper](https://apify.com/crawlerbros/snapchat-snap-map-scraper) | Public Snap Map places and their latest snaps | | [Snapchat Discover Scraper](https://apify.com/crawlerbros/snapchat-discover-scraper) | Shows and stories from Snapchat's Discover feed | # Actor input Schema ## `keywords` (type: `array`): Place names or landmarks to search on Snap Map. Examples: Times Square, Eiffel Tower, Tokyo Station, Colosseum ## `maxPlacesPerKeyword` (type: `integer`): Maximum number of matching places to return per keyword. ## `includeSnapData` (type: `boolean`): Fetch media URL and details for the first (most recent) snap at each place. ## `proxyConfiguration` (type: `object`): Optional proxy. Snapchat Explore pages are publicly accessible without proxy. ## Actor input object example ```json { "keywords": [ "Times Square", "Eiffel Tower", "Tokyo Station" ], "maxPlacesPerKeyword": 5, "includeSnapData": true } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keywords": [ "Times Square", "Eiffel Tower", "Tokyo Station" ], "includeSnapData": true }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/snapchat-snap-map-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keywords": [ "Times Square", "Eiffel Tower", "Tokyo Station", ], "includeSnapData": True, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/snapchat-snap-map-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keywords": [ "Times Square", "Eiffel Tower", "Tokyo Station" ], "includeSnapData": true }' | apify call crawlerbros/snapchat-snap-map-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/snapchat-snap-map-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Snapchat Snap Map Scraper", "description": "Scrape public Snap Map place data from Snapchat by place name or landmark. Returns place coordinates, snap count, thumbnails and first-snap media URLs. No login or cookies required.", "version": "0.1", "x-build-id": "F0p6VZS4oD8mxexxf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~snapchat-snap-map-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-snapchat-snap-map-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/crawlerbros~snapchat-snap-map-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-snapchat-snap-map-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/crawlerbros~snapchat-snap-map-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-snapchat-snap-map-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": [ "keywords" ], "properties": { "keywords": { "title": "Place Keywords", "type": "array", "description": "Place names or landmarks to search on Snap Map. Examples: Times Square, Eiffel Tower, Tokyo Station, Colosseum", "items": { "type": "string" } }, "maxPlacesPerKeyword": { "title": "Max Places per Keyword", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum number of matching places to return per keyword.", "default": 5 }, "includeSnapData": { "title": "Include Sample Snap Data", "type": "boolean", "description": "Fetch media URL and details for the first (most recent) snap at each place.", "default": true }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Optional proxy. Snapchat Explore pages are publicly accessible without proxy." } } }, "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 } } }, "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 } } } } } } } } } } ```