Guía de la API de MakerWorld: endpoints de detalle de modelo, colecciones y búsqueda (2026)
TryAR Labs
¿Existe una API pública de MakerWorld?
Respuesta corta: no hay una oficial. MakerWorld no publica una API con claves, cuotas ni documentación. Lo que existe — y de lo que depende toda herramienta de terceros, incluida esta plataforma — son los endpoints JSON internos que llaman la propia aplicación web de MakerWorld y Bambu Handy.
Esta guía documenta los dos endpoints que usa en producción MakerWorld Estimator, los campos de respuesta con los que puedes contar y las rutas de búsqueda que realmente funcionan para los desarrolladores. Trata todo esto como no documentado pero observable: los endpoints pueden cambiar sin aviso, así que cachea siempre y degrada con elegancia.
Endpoint 1: detalle de modelo
GET https://makerworld.com/api/v1/design-service/design/{modelId}?handle=enEl modelId es el número de cualquier URL de modelo:
https://makerworld.com/en/models/1717122-statue-of-liberty
└── modelId = 1717122Una petición curl mínima tiene este aspecto:
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'Campos de respuesta que conviene conocer
| Campo | Tipo | Significado |
|---|---|---|
title |
string | Nombre del modelo |
coverUrl |
string | URL de la imagen de portada |
defaultInstanceId |
number | ID del perfil de impresión predeterminado |
instances |
array | Todos los perfiles de impresión (ver abajo) |
creator.name / creator.avatar |
string | Identidad del diseñador |
likeCount, downloadCount, printCount |
number | Estadísticas de interacción |
license |
string | Etiqueta de licencia (CC BY, Standard Digital File License, …) |
needAms |
boolean | Si se requiere multicolor/3D Printing Glossary">AMS |
ratingScore |
number | Valoración media |
description |
string | Descripción del modelo (puede contener HTML) |
El array instances[]
Cada instancia es un perfil de impresión — la unidad útil para estimar costes:
| Campo | Tipo | Significado |
|---|---|---|
id |
number | ID del perfil (#profileId-XXXX en las URLs) |
title |
string | Nombre del perfil |
prediction |
number | Tiempo de impresión en segundos (divide entre 3600 para horas) |
weight |
number | Peso total del filamento en gramos |
cover |
string | Imagen del perfil |
instanceFilaments |
array | [{ type, color, usedG, usedM }] por filamento |
extention.modelInfo.plates |
array | Desglose por placa: { index, name, thumbnail, prediction, weight, filaments } |
El array plates es lo que hace posible el coste por placa — número de placas, pesos por placa, tiempos de impresión por placa y colores por placa. Si falta plates, recurre a los totales a nivel de perfil.
Endpoint 2: colecciones (favoritos)
GET https://makerworld.com/api/v1/design-service/favorites/{collectionId}?handle=enEl ID de colección es el número de una URL de colección:
https://makerworld.com/en/collections/27910720-large-prints
└── collectionId = 27910720Este endpoint devuelve los metadatos de la colección (nombre, creador, descripción, portada) más la lista de diseños que contiene. Es la base para la estimación por lotes — obtén una vez y luego resuelve cada diseño con el endpoint de detalle de modelo (o reutiliza datos cacheados).
Nuestro propio flujo por lotes está documentado en la guía de precios de colecciones; el equivalente del lado de la API es GET /api/scrape/collection?url={collectionUrl} en la API del estimador.
Búsqueda: qué funciona en su lugar
La consulta "endpoint de búsqueda de modelos de MakerWorld" implica que existe una API de búsqueda pública. No hay ninguna documentada. La búsqueda del sitio es una llamada interna que usan los propios clientes de MakerWorld, sin contrato publicado.
Para búsquedas programáticas, usa rutas que sean estables y estén dentro de los términos:
- Búsqueda del directorio del estimador —
GET /api/models?q={query}&sort={sort}&page={n}devuelve modelos ya cacheados con costes precalculados. Rápido, documentado y amigable con la caché. Consulta la referencia de la API. list_modelsde MCP — el mismo catálogo para agentes de IA a través del servidor MCP.- Tu propio índice — si necesitas el catálogo completo de MakerWorld, constrúyelo a partir de IDs de modelo que recojas legítimamente (tus propias subidas, enlaces públicos que aporten tus usuarios) y cachea de forma agresiva.
Evita machacar los endpoints internos de búsqueda: no están documentados, están limitados por tasa en la práctica y son frágiles.
Fiabilidad, cabeceras y buen comportamiento
- Envía cabeceras de navegador.
Referer,Origin,accepty unuser-agentreal importan. Algunos entornos se identifican y Cloudflare los bloquea en cualquier caso — el servidor de desarrollo local de esta plataforma incluso recurre acurlpor ese motivo. - Reintenta con retroceso. Gestiona
403,429y5xxcon al menos un reintento demorado; el retroceso exponencial es mejor. - Cachea todo. Los datos de los modelos cambian poco. Nuestra caché de producción guarda filas por perfil y sirve las peticiones repetidas desde memoria/base de datos; un TTL sensato es de días, no de minutos.
- Aplica tiempos de espera estrictos. Los tiempos de espera de 10 segundos evitan que un upstream colgado bloquee tus workers.
- Sé un buen ciudadano. Nada de rastreo masivo de perfiles de usuario ni páginas de búsqueda; obtén lo que necesitas para una acción iniciada por el usuario.
Convertir los datos de la API en costes
Los gramos y segundos en bruto se convierten en dinero con un modelo de precios — tarifa de filamento por gramo, tarifa de máquina por hora, montaje por placa, tarifas de purga para multicolor y margen. Eso es exactamente lo que calcula esta plataforma:
- REST:
GET /api/scrape?url={makerworld_url}devuelve el modelo más un desglose completo de costes (referencia). - MCP: la herramienta
scrape_modelhace lo mismo para agentes de IA (configuración). - Navegador: pega cualquier URL de MakerWorld en la calculadora para obtener el resultado placa a placa.
- Licencias: comprueba el campo
licensecontra la referencia de licencias antes de presupuestar trabajo comercial.
La documentación completa a nivel de campo de nuestra API (parámetros, respuestas, autenticación, créditos) está en /api, con la especificación legible por máquina en /openapi.yaml.