Get one collection
A single collection: name, description, owner, model count, likes and timestamps. Accepts a collection id or a Printables collection URL. Printables publishes only the collection's cover thumbnails, so sampleModels is a sample — modelCount is the authoritative total, and the full member list is not public.
/collection-detail Collections https://api.fetchlayer.dev/printables/collection-detail Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
collection string required Collection id, or a Printables collection URL.
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
collection-detail
Get one collection
collectionId string The resolved collection id.
collection object The collection record.
collection.name string | null Collection name.
collection.descriptionHtml string | null Description as authored, as HTML.
collection.owner object The designer who owns the collection.
collection.modelCount number | null Models in the collection — the real total.
collection.likes number | null Likes on the collection.
collection.sampleModels object[] A sample of members, each with id, slug, URL and cover image. Not the full list.
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/collection-detail" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"collection":"https://www.printables.com/collection/4412-desk-upgrades"}'Response
{
"resultType": "collection-detail",
"collectionId": "4412",
"notes": [],
"collection": {
"id": "4412",
"name": "Desk upgrades",
"modelCount": 28,
"likes": 94,
"owner": {
"handle": "printsmith"
},
"sampleModels": []
}
}