Back to Blogs & Guides
BLOG

MakerWorld API गाइड: मॉडल डिटेल, कलेक्शन और सर्च एंडपॉइंट (2026)

October 4, 2026
8 मिनट पढ़ें
TryAR Labs TryAR Labs

क्या कोई Public MakerWorld API है?

संक्षिप्त उत्तर: कोई आधिकारिक नहीं। MakerWorld keys, quotas या documentation वाला API प्रकाशित नहीं करता। जो मौजूद है — और जिस पर इस प्लेटफ़ॉर्म सहित हर third-party tool निर्भर करता है — वे internal JSON endpoints हैं जिन्हें MakerWorld का अपना web app और Bambu Handy कॉल करते हैं।

यह गाइड MakerWorld Estimator द्वारा production में इस्तेमाल किए जाने वाले दो endpoints, भरोसेमंद response fields, और वे search रास्ते दर्ज करती है जो developers के लिए वास्तव में काम करते हैं। यहाँ सब कुछ undocumented पर observable मानें: endpoints बिना सूचना के बदल सकते हैं, इसलिए हमेशा cache करें और gracefully degrade करें।

Endpoint 1: Model Detail

FORMULA 
GET https://makerworld.com/api/v1/design-service/design/{modelId}?handle=en

modelId किसी भी मॉडल URL में मौजूद संख्या है:

FORMULA 
https://makerworld.com/en/models/1717122-statue-of-liberty
                                  └── modelId = 1717122

एक न्यूनतम curl request ऐसा दिखता है:

FORMULA 
curl 'https://makerworld.com/api/v1/design-service/design/1717122?handle=en' \
  -H 'accept: application/json, text/plain, */*' \
  -H 'referer: https://makerworld.com/' \
  -H 'origin: https://makerworld.com' \
  -H 'user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36'

जानने लायक Response fields

Field Type अर्थ
title string मॉडल का नाम
coverUrl string कवर इमेज URL
defaultInstanceId number डिफ़ॉल्ट प्रिंट प्रोफ़ाइल ID
instances array सभी प्रिंट प्रोफ़ाइल (नीचे देखें)
creator.name / creator.avatar string डिज़ाइनर की पहचान
likeCount, downloadCount, printCount number एंगेजमेंट आँकड़े
license string लाइसेंस टैग (CC BY, Standard Digital File License, …)
needAms boolean क्या multi-color/3D Printing Glossary">AMS ज़रूरी है
ratingScore number औसत रेटिंग
description string मॉडल विवरण (इसमें HTML हो सकता है)

instances[] array

हर instance एक प्रिंट प्रोफ़ाइल है — लागत अनुमान के लिए उपयोगी इकाई:

Field Type अर्थ
id number प्रोफ़ाइल ID (URLs में #profileId-XXXX)
title string प्रोफ़ाइल का नाम
prediction number प्रिंट समय सेकंड में (घंटों के लिए 3600 से भाग दें)
weight number कुल फिलामेंट वज़न ग्राम में
cover string प्रोफ़ाइल इमेज
instanceFilaments array प्रति फिलामेंट [{ type, color, usedG, usedM }]
extention.modelInfo.plates array प्रति-प्लेट ब्रेकडाउन: { index, name, thumbnail, prediction, weight, filaments }

plates array ही per-plate costing को संभव बनाता है — plate count, plate weights, plate print times और per-plate colors। अगर plates न हो, तो profile-level totals पर वापस जाएँ।

Endpoint 2: Collections (Favorites)

FORMULA 
GET https://makerworld.com/api/v1/design-service/favorites/{collectionId}?handle=en

collection ID किसी collection URL में मौजूद संख्या है:

FORMULA 
https://makerworld.com/en/collections/27910720-large-prints
                                   └── collectionId = 27910720

यह endpoint collection metadata (नाम, creator, विवरण, कवर) के साथ उसके अंदर की design list लौटाता है। यह batch estimation का आधार है — एक बार fetch करें, फिर हर design को model detail endpoint से resolve करें (या cached डेटा दोबारा उपयोग करें)।

हमारा अपना batch flow collection pricing guide पर दर्ज है; API-पक्ष के समकक्ष estimator API पर GET /api/scrape/collection?url={collectionUrl} है।

Search: इसके बजाय क्या काम करता है

"MakerWorld search models endpoint" query एक public search API का संकेत देती है। कोई documented एक नहीं है। साइट का search एक internal कॉल है जिसका उपयोग MakerWorld के अपने clients करते हैं, बिना किसी प्रकाशित contract के।

Programmatic search के लिए, वे रास्ते इस्तेमाल करें जो स्थिर हैं और terms के दायरे में हैं:

  1. Estimator directory search — GET /api/models?q={query}&sort={sort}&page={n} पहले से cached मॉडलों को precomputed costs के साथ लौटाता है। तेज़, documented, और cache-friendly। API reference देखें।
  2. MCP list_models — MCP server पर AI agents के लिए वही catalogue।
  3. आपका अपना index — अगर आपको पूरा MakerWorld catalogue चाहिए, तो इसे वैध रूप से एकत्र किए गए model IDs (आपके अपने uploads, आपके users द्वारा दिए गए public links) से बनाएँ और जमकर cache करें।

internal search endpoints पर लगातार हमले से बचें: वे undocumented, व्यवहार में rate-limited, और fragile हैं।

Reliability, Headers और Etiquette

  • Browser-like headers भेजें। Referer, Origin, accept, और असली user-agent मायने रखते हैं। कुछ environments fingerprinted होते हैं और Cloudflare द्वारा ब्लॉक रहते हैं — इस प्लेटफ़ॉर्म का local dev server इसी कारण curl पर fallback भी करता है।
  • Backoff के साथ retry करें। 403, 429 और 5xx को कम से कम एक देरी वाले retry से संभालें; exponential backoff बेहतर है।
  • सब कुछ cache करें। Model data शायद ही बदलता है। हमारा production cache per-profile rows रखता है और repeat requests को memory/database से सर्व करता है; समझदार TTL मिनटों में नहीं, दिनों में होता है।
  • कठोर timeout रखें। 10-सेकंड request timeouts किसी hung upstream को आपके workers को जकड़ने से रोकते हैं।
  • अच्छे नागरिक बनें। user profiles या search pages की bulk crawling न करें; केवल वही fetch करें जो user-initiated कार्रवाई के लिए चाहिए।

API डेटा को लागत में बदलना

कच्चे grams और seconds एक pricing model के साथ पैसे बन जाते हैं — प्रति ग्राम फिलामेंट दर, प्रति घंटा मशीन दर, प्रति प्लेट सेटअप, multi-color के लिए purge fees, और margin। यह प्लेटफ़ॉर्म ठीक यही गणना करता है:

  • REST: GET /api/scrape?url={makerworld_url} मॉडल के साथ पूरा cost breakdown लौटाता है (reference)।
  • MCP: scrape_model tool AI agents के लिए वही करता है (setup)।
  • Browser: किसी भी MakerWorld URL को calculator में paste करें और plate-by-plate परिणाम पाएँ।
  • Licensing: कमर्शियल काम कोट करने से पहले license field को licence reference के सामने जाँचें।

हमारे API का पूरा field-level documentation (parameters, responses, auth, credits) /api पर है, और machine-readable spec /openapi.yaml पर।

Frequently Asked Questions

क्या कोई आधिकारिक public MakerWorld API है?
MakerWorld keys या documentation वाला कोई आधिकारिक public API प्रकाशित नहीं करता। इसका web app और mobile clients makerworld.com/api/v1/ के अंतर्गत internal JSON endpoints कॉल करते हैं — यह प्लेटफ़ॉर्म production में जो दो endpoints इस्तेमाल करता है वे model detail endpoint और collection (favorites) endpoint हैं। इन्हें undocumented मानें: ये बिना सूचना के बदल सकते हैं।
मैं किसी MakerWorld मॉडल का डेटा ID से कैसे पाऊँ?
GET https://makerworld.com/api/v1/design-service/design/{modelId}?handle=en को browser-like headers के साथ कॉल करें। model ID मॉडल URL में मौजूद संख्या है (makerworld.com/en/models/1717122-statue-of-liberty → 1717122)। Response में title, creator, stats, license, और print times, filament weights तथा plate layouts वाला instances array शामिल होता है।
MakerWorld API मेरे requests पर 403 क्यों लौटाता है?
Cloudflare client को fingerprint करता है। सादे scripts या Node से browser-like headers (Referer, Origin, sec-ch-ua, sec-fetch-*) के बिना भेजे गए requests आमतौर पर ब्लॉक हो जाते हैं, और कुछ environments headers की परवाह किए बिना ब्लॉक रहते हैं। पूरा browser header set भेजें, backoff के साथ retry करें, और जमकर cache करें।
MakerWorld search models endpoint क्या है?
कोई documented public search endpoint नहीं है। MakerWorld का site search एक internal कॉल है जिसका उपयोग उसका अपना web app करता है और यह third parties के लिए प्रकाशित नहीं है। पहले से cached मॉडलों पर programmatic search के लिए, platform के internal search को scrape करने के बजाय estimator का GET /api/models?q= या MCP list_models tool इस्तेमाल करें।

Related Articles & Guides

API

मुफ़्त 3D प्रिंट कॉस्ट API — मॉडल, लागत और फिलामेंट अनुमान लगाएँ

Read Guide → MCP

MCP Developer Hub: AI Agents को Estimator से जोड़ें

Read Guide → BLOG

MakerWorld क्या है? विक्रेताओं और क्रिएटर्स के लिए संपूर्ण गाइड

Read Guide →

Cite This Page

Use these formats to cite this page in research, reports, and documentation. Both snippets are copy-ready.

APA 7

APA 
TryAR Labs. (2026, October 4). MakerWorld API गाइड: मॉडल डिटेल, कलेक्शन और सर्च एंडपॉइंट (2026). MakerWorld Estimator. https://estimator.tryar.in/hi/blog/makerworld-api-guide

BibTeX

BIBTEX 
@misc{tryarlabs2026makerworldapiguide,
  title        = {{MakerWorld API गाइड: मॉडल डिटेल, कलेक्शन और सर्च एंडपॉइंट (2026)}},
  author       = {{TryAR Labs}},
  year         = {2026},
  month        = {oct},
  url          = {https://estimator.tryar.in/hi/blog/makerworld-api-guide},
  note         = {MakerWorld Estimator}
}

Calculate 3D Print Costs in Real-Time

Paste any MakerWorld model URL or upload your STL/3MF file to get instant, plate-by-plate pricing breakdowns with filament weights, time scaling, and hardware add-ons.

Open Cost Estimator