thingiverse-browser

author: Thijs Roumen date: 2020.07.02

usage: python browser.py -s searchTerm -n imageCount

A simple tool to retreive preview images and basic data of thingiverse models. It automatically runs a series of queries using the thingiverse API based on your search term stores that data in a CSV file and creates a folder structure with preview images to get a sense for the models in each category folder structure looks like this:

search term

+--- all-models-(number of models)
    +--- thingiverse_id1.jpg
    +--- thingiverse_id2.jpg
      ...
    +--- thingiverse_idn.jpg

+--- hasMakes-(n)
    +--- thingiverse_id1.jpg
    +--- thingiverse_id2.jpg
      ...
    +--- thingiverse_idn.jpg

+--- isRemix-(n)
    +--- thingiverse_id1.jpg
    +--- thingiverse_id2.jpg
      ...
    +--- thingiverse_idn.jpg

+--- isRemix-and-hasMakes-(n)
    +--- thingiverse_id1.jpg
    +--- thingiverse_id2.jpg
      ...
    +--- thingiverse_idn.jpg

+--- customizable-(n)
    +--- thingiverse_id1.jpg
    +--- thingiverse_id2.jpg
      ...
    +--- thingiverse_idn.jpg

+--- customizable-and-hasMakes(n)
    +--- thingiverse_id1.jpg
    +--- thingiverse_id2.jpg
      ...
    +--- thingiverse_idn.jpg

Getting Started

first of all sign up for a thingiverse account and set up an App on thingiverse (doesnt have to be public, but you need it to get an API key) https://www.thingiverse.com/developers/getting-started

make a separate file called "api-key" next to this python file and put just the API key in it

install all dependencies:

• requests: pip3 install requests
• json: pip3 install json
• csv: pip3 install csv