makerworld.com APImakerworld.com ↗
Search MakerWorld 3D model listings by keyword, sort order, and pagination. Retrieve titles, images, tags, creator info, print profiles, and filament requirements.
curl -X GET 'https://api.parse.bot/scraper/ebc3d50a-0fe2-4bcf-9cbe-3429e1410ab2/search_models?limit=2&keyword=vase' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for 3D models on MakerWorld by keyword. Returns paginated listings with title, images, tags, creator info, and stats such as downloads, likes, and prints.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results per page (max 50). |
| offset | integer | Pagination offset (number of results to skip). |
| keyword | string | Search keyword (e.g., 'dragon', 'vase'). Empty string returns trending/popular models. |
| order_by | string | Sort order: 'score' (relevance), 'downloadCount', 'likeCount', 'createTime'. |
{
"type": "object",
"fields": {
"limit": "integer - results per page",
"total": "integer - total number of matching models",
"offset": "integer - current pagination offset",
"results": "array of model objects with id, title, slug, images, tags, creator, stats, created_at, license, is_exclusive"
},
"sample": {
"data": {
"limit": 3,
"total": 4746,
"offset": 0,
"results": [
{
"id": 1239342,
"slug": "improved-crystal-dragon",
"tags": [
"crystaldragon",
"Dragon",
"dragon"
],
"stats": {
"likes": 1790,
"prints": 5231,
"downloads": 11930,
"collections": 4681
},
"title": "Improved Crystal Dragon",
"images": [
"https://makerworld.bblmw.com/makerworld/model/US899654d90119de/design/2025-03-23_7b57e1b7cf1f2.png"
],
"creator": {
"name": "Frost",
"handle": "frost12"
},
"license": "BY-SA",
"created_at": "2025-03-23T10:11:56Z",
"is_exclusive": false
}
]
},
"status": "success"
}
}About the makerworld.com API
The MakerWorld API gives developers access to MakerWorld.com's 3D model catalog across 2 endpoints, returning fields like title, images, tags, download counts, and creator handles. The search_models endpoint supports keyword search with four sort options and full pagination, while get_model_detail returns per-model data including print profiles, filament requirements, license type, and plain-text descriptions.
Search and Browse Models
The search_models endpoint accepts a keyword string and returns a paginated list of model objects. Each result includes the model id, title, slug, preview images, tags, and a creator object with the designer's name and handle. Engagement stats — downloads, likes, prints, and collections — are returned for every result. Pass an empty keyword to get trending or popular listings. Use order_by to sort results by score (relevance), downloadCount, likeCount, or createTime. The limit and offset parameters control pagination up to 50 results per page, and the response includes a total count for building pagers.
Model Detail
The get_model_detail endpoint accepts a design_id — either a bare numeric string like 655976 or a slug-appended form like 655976-dragon-stand. It returns the full record for a single model: title, summary (HTML-stripped plain text), images, tags, license, created_at (ISO datetime), the creator object, and a stats block covering likes, downloads, prints, and collections. Print profiles and filament requirements are also included, making this endpoint suitable for downstream tools that need to know material and slicer settings before a print job.
Limitations and Coverage
The API covers publicly visible model listings. Data tied to a user's private library, purchase history, or account-level print farm jobs is not exposed. Search results reflect the same public index available on MakerWorld.com without requiring a logged-in session. Pagination is bounded by the limit (max 50) and offset parameters; very deep offsets may return fewer results depending on the total available.
- Build a 3D print catalog app that surfaces trending models using an empty keyword and
order_by=downloadCount. - Aggregate filament and material requirements from
get_model_detailto pre-check slicer compatibility before queuing prints. - Create a tag-based discovery feed by filtering
search_modelsresults on specifictagsreturned per model. - Track creator popularity by collecting
likesanddownloadsstats across a designer's published models. - Populate a print farm job queue by pulling model
slug,images, and print profiles from detailed model records. - Build a license compliance checker by reading the
licensefield fromget_model_detailfor each model before redistribution. - Compare upload velocity by sorting
search_modelsresults bycreateTimeand monitoringtotalcounts over time.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does MakerWorld have an official developer API?+
What does `search_models` return when I pass an empty keyword?+
keyword returns trending or popular models from the public index, ranked by the chosen order_by value. You still get the full result set with id, title, images, tags, creator, and stats fields, and total reflects how many models are in that pool.Does the API return user collections, saved lists, or private designs?+
Does `get_model_detail` return comments or user reviews?+
How deep can pagination go in `search_models`?+
offset and limit parameters let you page through results in batches of up to 50. The response total field tells you the full count of matching models, but very high offsets may return fewer results than expected if the underlying index caps deep pagination. Check total against your accumulated offset before assuming more pages exist.