Printables API — Every Model One Designer Published
Documentation menu
FetchLayer FetchLayer API

List a designer’s published models

Every model one designer has published, newest first, paged the same way as a search. Use it to measure a creator: how often they publish, what they publish into, and how downloads and makes are distributed across their catalogue rather than concentrated in one hit.

POST /user-models Designers
https://api.fetchlayer.dev/printables/user-models
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.

limit number optional

Maximum models returned (max 2000), or -1 for everything available. (default: 30)

pages number optional

Pages of results to collect in one request (max 100), or -1 for the maximum allowed.

cursor string optional

Resume from a previous response's nextCursor.

delayMs number optional

Milliseconds to wait between pages (max 30000).

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-models

List a designer’s published models

userId string

The resolved designer id.

models object[]

The matching models.

models[].id string

Model id — the handle for /model-detail.

models[].name string | null

Model title as published.

models[].url string

Public Printables permalink for the model.

models[].publishedAt string | null

When the current version was published.

models[].firstPublishedAt string | null

When the model first went public, which can predate publishedAt.

models[].category object

Category the designer filed it under, with its id and name.

models[].designer object

Designer id, handle, display name, profile URL, avatar, verification and company flag.

models[].image object

Cover image, with its absolute URL and dimensions. The full gallery is on /model-detail.

models[].stats object

Downloads, likes, views, makes, comments, rating average and count, collections, file and image counts.

models[].price number | null

Store price, or null for a free model.

models[].clubExclusive boolean

True when the model sits behind a paid membership.

models[].latestContestPlacement object

Most recent contest placing, when the model has one.

modelCount number

Models in this response.

pagesScraped number

Pages actually collected. Each page counts as one request against your plan.

nextCursor string | null

Pass back as cursor to continue, or null when the listing is exhausted.

hasNextPage boolean

Whether more results are available beyond 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-models" \
  -H "Authorization: Bearer ss-your-key" \
  -H "Content-Type: application/json" \
  -d '{"user":"printsmith","limit":200,"pages":5}'

Response

{
  "resultType": "user-models",
  "userId": "90210",
  "modelCount": 143,
  "pagesScraped": 4,
  "hasNextPage": false,
  "nextCursor": null,
  "notes": [],
  "models": []
}