vsco-scraper
vsco-scraper copied to clipboard
mvabdi
Easily allows for scraping a VSCO
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
- Hadjer Benzaamia - Collection PR - bz-hadjer
- sc1341 - PR - sc1341
- lazytownfan - PR - lazytownfan
- CanavarB - PR - CanavarB
- SilverMight - PR - SilverMight
License
This project is licensed under the MIT License - see the LICENSE.md file for details
Acknowledgments
- instagram-scraper for inspiration
mvabdi