cam-cambridge / thingiscrape

A python based Thingiverse.com object scraper and downloader

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Thingiscrape

Thingiverse REST API python wrapper

About

A python based Thingiverse.com object scraper and downloader. The program can search of objects using keywords, licenses, users, categories and then sort the results, for example returning the most popular or newest uploads.

Getting Started

First you need to install the requirements - there are not that many 😊.

pip install -r requirements.txt

You need to add an environment variable containing the Thingiscrape applications API token. Contact @dougbrion dajb3@cam.ac.uk to get the token or create your own Thingiverse application by visiting the following site: https://www.thingiverse.com/apps

export API_TOKEN "<your-api-token>"

Usage

To see the various options available to you type the following into your terminal.

python thingiscrape.py --help

Example usage:

python thingiscrape.py --search "yoda" --popular 1 --pages 2 --license "cc"

STL 3D model files will be downloaded to ./downloads/stls/ along with a json file containing the results from the request in ./downloads/json/.

About

A python based Thingiverse.com object scraper and downloader

License:MIT License


Languages

Language:Python 100.0%