Hey, this is old!

We have a full featured API now. We'll keep this one around for awhile, but don't build anything new with it.

Go to the new API

Upload API

We have created an extremely simple upload API that anyone can use. It is a very loosely coupled system, so there are no keys or passwords to setup. You give the user a form that POSTs some information to a URL, and the user handles the rest.

Post URL

Please POST your upload data to http://www.thingiverse.com/api/upload. POST method only. No GET.

Parameters

Name Required? Description
url Yes A base64 encoded URL where the model/design is located. For 3D models, STL is preferred.
service No The name of your service. Example: Ninja Star Generator
service_url No The url of your service. Example: http://ninjastars.example.com
name No The name of the thing to be created. The user will be prompted to edit this, and this will pre-populate that field.
description No The description of the thing to be created. The user will be prompted to edit this, and this will pre-populate that field.

Example Code

The example code below will show a form to a user that when submitted will create a new Thing. Thingiverse will confirm with the user that they want to do this, and then the form will download the file from the url specified, and give it the name and description supplied. It will also record the service name and url to show to visitors. We'll link back to you on any Thing pages that were uploaded from your service.