MakerWorld API — Download Model Images
Documentation menu
FetchLayer FetchLayer API

Download a model image

Stream a model cover, gallery image, render or designer avatar, using a url taken from a model, collection or designer result. Only MakerWorld image hosts are accepted. HTTP Range requests are supported. This is a GET with query parameters, not a JSON POST, and it bills as one request.

GET /media Utility
https://api.fetchlayer.dev/makerworld/media
OpenAPI JSON

Headers

Authorization string required

Bearer token — your FetchLayer API key.

Parameters

url string required

MakerWorld image URL, as returned on a model, collection or designer. Passed as a query parameter.

filename string optional

Content-Disposition filename to serve the file as (max 200 characters).

Range string optional

Standard HTTP Range request header, for example bytes=0-65535. Sent as a header, not a query parameter.

Response Fields

media

Download a model image

(body) binary

The file itself. 200 for the whole file, 206 for a requested byte range.

Content-Type header

Media type of the file, e.g. image/webp or image/jpeg.

Content-Range header

Byte range served, on a 206 response.

Accept-Ranges header

Present when the file supports range requests.

Request

curl -X GET "https://api.fetchlayer.dev/makerworld/media?url=https%3A%2F%2Fmakerworld.bblmw.com%2Fmakerworld%2Fmodel%2F...%2Fcover.png&filename=cable-tray-cover.png" \
  -H "Authorization: Bearer ss-your-key"

Response

{
  "note": "Binary file streamed back with Content-Type, Content-Length and Accept-Ranges headers."
}