Printables API v1
Search and browse public 3D models on Printables, read the designers who publish them, follow their collections, and track the design contests the community competes in — all from https://api.fetchlayer.dev/printables, with your FetchLayer key and nothing else.
Before you filter anything
Every id-shaped filter on a model search — category, licence, material, printer, design tool — takes an id, never a name. There are 639 valid printer values alone, and an id that does not exist comes back as an empty result set rather than an error, so a guessed "Prusa MK4" reads as "no models match". POST /filter-values returns the whole vocabulary in one call, costs no credit, and is meant to be cached.
Two limits worth knowing
- Model files are described, not downloadable. A model's file listing carries each file's name, size, kind and slicing settings, but no download URL — Printables issues those only to a signed-in account, so no public one exists.
GET /mediastreams images and the instructions PDF, not geometry. - Read
notes[]on every response. It is where a truncated walk or an upstream limit is reported. A short result set with a note in it is a capped result, not an empty corner of the site.
Available endpoints
POST Search models by keyword
/search-models POST Browse models without a keyword /browse-models POST Get one model in full /model-detail POST Get a designer's profile /user-profile POST List a designer’s published models /user-models POST List a designer's public collections /user-collections POST Get one collection /collection-detail POST List design contests /contests POST Get one contest and its winners /contest-detail POST Get the ids the filters take /filter-values POST Parse a Printables URL /resolve-url GET Download an image or document /media