Download all Snap Map content from a specific location.

View on PyPI

Install with pip or pipx or whatever trendy Python package manager you use:

pip install snapmap-archiver

Install Poetry with pip or pipx:

pip install poetry

Install the project dependencies:

poetry install

Run the app with Poetry:

poetry run python3 main.py [...args]

snapmap-archiver -o [OUTPUT DIR] -l="[LATITUDE],[LONGITUDE]"

Unfortunately you have to use the arbitrary -l="lat,lon" rather than just -l "lat,lon" when parsing negative numbers as argsparse interprets said numbers as extra arguments.

-l is not required if an input file or Snap URL is provided. It can also be used multiple times to download Snaps from multiple locations in one command.

E.g

snapmap-archiver -o ~/Desktop/snap -l='123.123,123.123' -l '445.445,445.445'

With -f or --file, you can specify a file containing a list of line-separated Snap URLs or IDs.

E.g

snapmap-archiver -o ~/Desktop/snaps -f ~/Desktop/snaps.txt

Inside snaps.txt:

https://map.snapchat.com/ttp/snap/Example/@-33.643495,115.741281,11.86z
Example
https://map.snapchat.com/ttp/snap/Example/
https://map.snapchat.com/ttp/snap/Example/

You can also just pass 1 or more normal Snap URLs or IDs to the package to download it individually like this:

snapmap-archiver -o ~/Desktop/snap 'https://map.snapchat.com/ttp/snap/Example/@-33.643495,115.741281,11.86z' 'Example'

Use the -t flag with a Unix timestamp or day, hour, or minute interval to skip the download of any snaps older than that point.

Example with a Unix timestamp:

snapmap-archiver -t 1714392291 -l '-123,123'

Examples with a dynamic time filter:

snapmap-archiver -t 3d -l '-123,123'  # Removes anything older than 3 days
snapmap-archiver -t 5h -l '-123,123'  # Removes anything older than 5 hours
snapmap-archiver -t 30m -l '-123,123'  # Removes anything older than 30 minutes

You can export a JSON file with info about downloaded snaps with the --write-json argument, which will contain information like the time the Snap was posted, and the Snap location.

It will write archive.json to the specified output directory.

The radius from the coordinates you provide that will be included for downloads. -r 20000 will download all Snaps within a 20km radius of your coordinates.

You can input a custom zoom depth value (-z) that correlates to a zoom level in the GUI. ArcGIS has documentation about this here, but essentially the lower the number, the further zoomed-out you are. 5 is the default and shouldn't cause any issues.