-
Download this repo
-
Check you have python3 installed on your machine
python3 -v
If not, download and install it from here: https://www.python.org/downloads/
- Open the repository with a text editor. Get an API key from Flickr and add it to the file called
credentials.jsonwhich has the following text in it (replace the credentials with your own):
{"KEY":"YOUR_API_KEY", "SECRET":"YOUR_API_SECRET"}
- Install software requirements for this script by typing this command into the terminal. You may choose to use a virtual environment (see below).
pip3 install -r requirements.txt
- Then you can run the program to download with flickr. Check it works. I've used my name as there aren't too many results for it. For common search terms you will get 1000s of results and it will take a long time to download, and a lot of space.
python3 scraper.py --search "Tega Brain"
Note. If you want to stop the scraper running (without closing the terminal window). Press CNTRL + C (this shortcut stops terminal processes)
To scrape for a particular search term:
python scraper.py --search "SEARCH TERM"
You can also add a lat/lng coordinates to specify a geographic bounding box:
python scraper.py --search "SEARCH TERM" --bbox "minimum_longitude minimum_latitude maximum_longitude maximum_latitude"
To scrape for a particular group:
python scraper.py --group "GROUP URL"
Where GROUP URL is something like https://www.flickr.com/groups/scenery/pool/
Large-sized (1024px width) will be downloaded by default. You can download the original images by passing the flag --original.
Limit the number of pages of results downloaded by passing --max-pages N where N is pages of 500 results each.
python scraper.py --search "cicada" --max-pages 1
python3 -m venv env
source env/bin/activate
pip install -r requirements.txt