Get one collection and its models
Read a collection's title, description, owner, tags and like count, plus the models it contains with their popularity counts and URLs, paginated with a cursor. The collection's own modelCount includes models the owner has hidden, so it can exceed the number of models the listing returns.
/collection-detail Collections https://api.fetchlayer.dev/makerworld/collection-detail Headers
Authorization string required Bearer token — your FetchLayer API key.
Parameters
collection string required Collection id, or a MakerWorld collection URL.
limit number optional Maximum models returned (max 2000), or -1 for everything available. (default: 30)
pages number optional Requests made while collecting results. One request returns up to 100 items (max 100), or -1 for the maximum allowed. (default: 1)
cursor string optional Resume from a previous response's nextCursor.
delayMs number optional Milliseconds to wait between pages (max 30000).
timeoutMs number optional Per-request time limit in milliseconds (max 600000).
format string optional json or markdown. (default: json)
Response Fields
collection-detail
Get one collection and its models
collectionId string The resolved collection id.
collection object The collection record.
collection.description string Collection description.
collection.owner object The designer who curated it.
collection.modelCount number Models in the collection, including any the owner has hidden — so it can exceed the models returned.
collection.models object[] The models in this page of the collection, with designer, license, tags and stats.
collection.nextCursor string Pass back as cursor to continue through the collection.
collection.hasNextPage boolean Whether more models remain in the collection.
notes string[] Caveats about this specific result — a walk that stopped early, a listing MakerWorld truncated, an upstream ceiling that was hit. Read it: an empty array means the result is complete, a non-empty one means it is not.
requestedUrl string The MakerWorld page this result corresponds to.
scrapedAt string ISO timestamp of when the data was retrieved.
blocked boolean Always false on a successful response.
Request
curl -X POST "https://api.fetchlayer.dev/makerworld/collection-detail" \
-H "Authorization: Bearer ss-your-key" \
-H "Content-Type: application/json" \
-d '{"collection":"5512","limit":50,"pages":2}'Response
{
"collectionId": "5512",
"notes": [],
"collection": {
"title": "Desk tidy essentials",
"modelCount": 34,
"likeCount": 812,
"hasNextPage": false,
"models": [
{
"modelId": "412809",
"title": "Under-desk cable tray",
"stats": {
"downloadCount": 18422
}
}
]
}
}