SnapScrape is a Python tool that automates the downloading of Snapchat media based on specified search criteria. You can filter by media type, geographical location, and other attributes. The utility provides extensive options for customizing the downloaded media, including re-encoding videos with timestamps, writing media metadata to text files, and zipping the downloaded content. This tool is currently being employed to collect civilian videos from the Gaza Strip for Open Source Intelligence (OSINT) purposes.
- Download Snapchat media by URL, Snap IDs, or geographic location
- Filter media based on type (image, video)
- Optional re-encoding of videos with timestamps and titles
- Write media metadata to text files (media_id, overlay_text, snap_media_title, etc.)
- Zip downloaded files into one single archive
- Python 3.x
requestslibraryffmpegfor video re-encoding (optional)
- Clone the repository
git clone https://github.com/ef1500/snapscrape.git
- Change directory into the cloned repository
cd snapscrape
- Install the required packages
pip install -r requirements.txt
python snapscrape.py
--latitude, -lat Set the latitude for geographical search. Default is 31.448345381406952.
--longitude, -lon Set the longitude for geographical search. Default is 34.4039489649856.
--zoomlevel, -zl Set the zoom level. Default is 7.06892436484424.
--radius, -r Set the search radius in meters. Default is 37000.
--max_fuzz_radius, -fr Set the maximum fuzz radius. Default is 0.
--epoch, -e Override the epoch.
--location, -loc Directory to download the media. Default is "downloads".
--skip-videos, -sv Skip downloading videos.
--skip-images, -si Skip downloading images.
--no-media-id, -ni Don't write the media_id to a text file.
--no-overlay-text, -nt Don't write the overlay_text to a text file.
--no-thumbnail, -nth Don't write the thumbnails to a file.
--no-snap-media-title, -nst Don't write the snap_media_title to a file.
--no-media-timestamp, -nmt Don't write the timestamp to a file.
--no-encode-video-timestamp,-nevt Don't encode video with timestamp.
--no-encode-video-title, -nevtt Don't re-encode video with the snap_media_title.
--no-separate-media, -ns Don't create a separate folder for each media file.
--zip, -z Create a zip file after finishing.
--url, -u Download Snapchat media using URLs.
--snapid, -sid Download Snapchat media using Snap IDs.
--file, -f A text file containing a list of URLs or Snap IDs.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent