mvabdi / vsco-scraper

Easily allows for scraping a VSCO
MIT License
132 stars 25 forks source link
download download-photos downloader image image-scraper python-3 python3 scraper vsco vsco-scraper

VSCO Scraper

Allows for easy scraping of one VSCO at a time

Getting Started

Usage and installation of vsco-scraper

Prerequisites

Python 3 is required. Python 2 is not supported.

Installing

To install vsco-scraper:

 $ pip install vsco-scraper

To update vsco-scraper:

 $ pip install vsco-scraper --upgrade

Usage

To scrape a VSCO:

 $ vsco-scraper <username> --getImages

Images are downloaded into the <current directory/<username> folder

To scrape a user's journal on VSCO:

 $ vsco-scraper <username> --getJournal

Journal Images are downloaded into the <current directory>/<username>/journal/<journalname> folder

To scrape a user's collection on VSCO:

 $ vsco-scraper <username> --getCollection

Collection Images are downloaded into the <current directory>/<username>/<collection> folder

To scrape a user's profile picture on VSCO:

 $ vsco-scraper <username> --getProfile

Profile Pictures are downloaded into the <current directory>/<username>/<profile> folder

To scrape multiple VSCOs:

 $ vsco-scraper <filename-of-text-file> --multiple

*The scraper will read a text file, one username per line

To scrape multiple VSCOs images, journals and collections:

 $ vsco-scraper <filename-of-text-file> --all

*Same as above one username per line, but will also download journals and collection if it finds them

Options

Option Secondary Options Description
--getImages -i Grabs all of the user's images
--getJournal -j Grabs all of the images in the user's journals, then separates into separate folders
--getCollection -c Grabs all of the images in the user's collection
--getProfile -p Grabs a users profile picture
--multiple -m Grabs multiple users' images
--multipleJournal -mj Grabs multiple users' journals
--multipleCollection -mc Grabs multiple users' collections
--multipleProfile -mp Grabs multiple users' profile pictures
--all -a Scrape multiple users journals, collections, and images, will only download their journal and collection if they have one
--allProfile -ap Scrape multiple users profile pictures, journals, collections, and images. This is distinct from --all as this feature was added later
--cacheHit -ch This feature allows you to download media from an account even when the username changes by storing unique ids per user
--latest -l This allows the user to download media once per query per user, i.e if you run the same command repeatedly, it should download media once

Author

Contributors

License

This project is licensed under the MIT License - see the LICENSE.md file for details

Acknowledgments