Printables API — A Designer’s Public Collections
Documentation menu
FetchLayer FetchLayer API

List a designer's public collections

The collections a designer has made public, each with its model count, likes, timestamps and a sample of its cover thumbnails. Collections are curation signal: what a maker saves tells you what they are about to print, and which models the community keeps filing away.

POST /user-collections Designers
https://api.fetchlayer.dev/printables/user-collections
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

user string required

Designer handle, @handle, profile URL, or numeric designer id.

format string optional

json, or markdown to get the result rendered as text. (default: json)

timeoutMs number optional

Per-request time limit in milliseconds (max 600000).

Response Fields

user-collections

List a designer's public collections

userId string

The resolved designer id.

collections object[]

The designer’s public collections.

collections[].id string

Collection id — the handle for /collection-detail.

collections[].name string | null

Collection name.

collections[].modelCount number | null

Models in the collection. This is the real total.

collections[].likes number | null

Likes on the collection.

collections[].sampleModels object[]

A sample of the models, not the whole list — Printables publishes only the cover thumbnails.

collectionCount number

Collections in this response.

notes string[]

Caveats about this specific result — a truncated walk, a listing that may be incomplete, an upstream limit. Read it before treating a result set as complete.

requestedUrl string

The Printables page this result corresponds to.

scrapedAt string

ISO 8601 timestamp of when the data was collected.

resultType string

Which shape this response is, e.g. model-search or contest-detail.

blocked boolean

Always false on a successful response.

Request

curl -X POST "https://api.fetchlayer.dev/printables/user-collections" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"user":"printsmith"}'

Response

{
  "resultType": "user-collections",
  "userId": "90210",
  "collectionCount": 6,
  "notes": [],
  "collections": [
    {
      "id": "4412",
      "name": "Desk upgrades",
      "modelCount": 28,
      "likes": 94
    }
  ]
}