Skip to content

Latest commit

 

History

56 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

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

Releases

Packages

Used by

Contributors

Languages