Skip to content

mvabdi/vsco-scraper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

56 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

  • Mustafa Abdi - Initial work - mvabdi

Contributors

License

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

Acknowledgments

  • instagram-scraper for inspiration