Conecta BuildGets con tus programas, tu IA y tu web
Precios de obra de la Base BuildGets 2026 y lectura de presupuestos BC3 (FIEBDC-3) desde tu programa, tu asistente de IA o tu web. Sin instalar nada y con tu cuenta de BuildGets.
🧩 API
Una API REST con respuestas en JSON. Los precios y la lectura de BC3 no usan IA: son inmediatos y sin coste por consumo, solo con una cuota diaria por clave. La conversión de PDF y Excel sí usa IA y gasta conversiones de tu plan, como en la web.
1 · Tu clave
Créala en Mi cuenta › Claves de API (hasta 5 claves, una por programa). Empieza por bg_live_, se enseña una sola vez y se puede revocar cuando quieras. Envíala en cada llamada en la cabecera:
Authorization: Bearer bg_live_TU_CLAVE
No pongas la clave en el código de una página web ni en una app que se descarguen otros: úsala solo desde tu servidor. Para una web, usa el widget.
2 · Precios de obra
| Parámetro | Obligatorio | Qué es |
|---|---|---|
q | Sí | El trabajo a valorar, en castellano: «alicatado de baño con porcelánico», «tabique de pladur»… |
unidad | No | Unidad esperada: m2, m3, m, ud, kg… |
limite | No | Partidas a devolver, de 1 a 10 (5 por defecto). |
curl -H "Authorization: Bearer bg_live_TU_CLAVE" \
"https://www.buildgets.com/api/v1/precio.php?q=alicatado%20de%20ba%C3%B1o&unidad=m2&limite=2"
Respuesta (ejemplo):
{
"ok": true,
"consulta": "alicatado de baño",
"unidad": "m2",
"familia": null,
"partidas": [
{
"codigo": "RA12.010",
"ud": "m2",
"resumen": "Alicatado con baldosa de gres porcelánico en paramento interior de baño",
"precio": 38.5,
"url": "https://www.buildgets.com/precios/…"
}
],
"nota": "Precios de ejecución material en España (sin gastos generales, beneficio industrial ni IVA). Fuente: Base BuildGets 2026."
}
Cuando la consulta encaja con una familia de precios (por ejemplo, «pintura plástica»), familia trae el precio típico y el rango habitual: nombre, ud, tipico, desde, hasta, n (partidas en las que se basa) y url.
3 · Leer un presupuesto BC3
Envía el BC3 de una de estas tres formas (máximo 15 MB):
- Como archivo, en el campo
archivo(multipart/form-data). - Como texto: JSON
{"contenido": "~V|…"}. - Como enlace público: JSON
{"url": "https://…/obra.bc3"}.
curl -H "Authorization: Bearer bg_live_TU_CLAVE" \
-F "archivo=@obra.bc3" https://www.buildgets.com/api/v1/bc3.php
Devuelve titulo, version, pem (presupuesto de ejecución material), n_capitulos, n_partidas, capitulos (con sus subcapítulos y partidas: codigo, ud, resumen, cantidad, precio, importe, texto), avisos y visor: un enlace para abrirlo y editarlo en BuildGets durante 24 horas.
4 · Convertir un PDF o un Excel a BC3
La misma lectura que BuildGets PDF y BuildGets EXCEL. Envía el archivo en el campo archivo con tipo = pdf o excel, o un JSON {"tipo": "pdf", "url": "https://…"} con un enlace público (Google Drive, Dropbox…). PDF hasta 14 MB y 120 páginas; Excel (.xlsx o CSV) hasta 20 MB.
curl -H "Authorization: Bearer bg_live_TU_CLAVE" \
-F "tipo=pdf" -F "archivo=@presupuesto.pdf" https://www.buildgets.com/api/v1/convertir.php
Un Excel o un PDF de hasta 8 páginas termina en esa misma llamada. Uno más largo se convierte por partes de 8 páginas: la respuesta trae "estado": "en_curso" y su id, y cada GET …/convertir.php?id=cv_… convierte la parte siguiente hasta que el estado sea terminada, terminada_con_dudas (puede faltar alguna partida: lo explica resultado.revisar y conviene convertirlo en la web) o error, con su mensaje. Cada parte tarda de unos segundos a un par de minutos.
{
"ok": true,
"conversion": {
"id": "cv_…",
"tipo": "pdf",
"estado": "terminada",
"resultado": { "titulo": "…", "capitulos": 11, "partidas": 87, "pem": 48013.29, "n_sin_precio": 2, "cuadra_con_documento": true, "capitulos_detalle": [ … ] },
"bc3": "https://www.buildgets.com/bc3.php?t=…",
"bc3_caduca_horas": 24,
"proyecto_id": 1234,
"conversiones_gastadas": 1
}
}
El presupuesto queda también en Mis BuildGets. Cada conversión gasta las conversiones de tu plan, igual que en la web (con el Plan Gratis, un PDF de más de 25 páginas cuenta una por cada 25), y solo cuando termina bien.
5 · Límites y errores
| Límite | Valor |
|---|---|
| Llamadas por clave y día | 200 (la cuenta vuelve a empezar cada día) |
| Claves por cuenta | 5 |
| Tamaño de un BC3 | 15 MB |
| Conversiones de PDF y Excel | Las de tu plan, como en la web (máximo 40 al día desde la API y el asistente) |
Los errores llegan siempre con el mismo formato y un mensaje en castellano que se puede enseñar al usuario:
{ "ok": false, "error": { "tipo": "cuota", "mensaje": "…" } }
| Código | Cuándo |
|---|---|
| 400 | Faltan datos o no son válidos (datos). |
| 401 | Falta la clave, no es válida o está revocada (clave). |
| 405 | Método no admitido (metodo). |
| 429 | Se ha acabado la cuota del día (cuota). |
| 500 / 503 | Fallo de BuildGets: reintenta en unos minutos. |
Con GET https://www.buildgets.com/api/v1/ y tu clave ves el uso de hoy de esa clave (no gasta cuota).
🤖 Tu asistente de IA
Pide precios de obra, abre presupuestos BC3, convierte un PDF o un Excel y prepara presupuestos nuevos hablando con Claude, ChatGPT u otro asistente que admita conectores remotos (MCP). Necesitas una cuenta de BuildGets (vale la gratuita).
Cómo conectarlo
- Claude: Ajustes › Conectores › Añadir conector personalizado, y pega la dirección de abajo. Luego pulsa «Conectar».
- ChatGPT: Ajustes › Aplicaciones y conectores › Crear (con el modo desarrollador activado), y pega la misma dirección.
- Otros asistentes: añade un conector remoto (MCP) con esta dirección.
https://www.buildgets.com/mcp
Al pulsar «Conectar», el asistente te lleva a BuildGets para que inicies sesión y pulses «Permitir». No ve tu contraseña ni datos de otros usuarios, y puedes desconectarlo cuando quieras en Mi cuenta › Conexiones › Asistente de IA.
| Herramienta | Qué hace |
|---|---|
| Precios | Busca precios en la Base BuildGets 2026 y en tus bases propias. |
| Abrir BC3 | Lee un presupuesto BC3 y da un enlace para abrirlo en BuildGets. |
| Mis BuildGets | Lista y lee tus presupuestos guardados. |
| Presupuestos | Crea un presupuesto por capítulos y partidas, con mediciones, y lo revisa. |
| Convertir PDF y Excel | Pasa a BC3 un PDF o un Excel publicado en un enlace (Google Drive, Dropbox…), con la misma lectura que la web. Gasta conversiones de tu plan, como en la web. |
| Exportar a BC3 | Genera el BC3 del presupuesto. Gasta un uso de tu plan, como en la web. |
| Holded | Envía el presupuesto a tu Holded, si lo tienes conectado. |
Si tu asistente no admite el inicio de sesión, el conector también acepta una clave de API en la cabecera Authorization: Bearer bg_live_…. En ese caso, cada uso cuenta en la cuota diaria de esa clave.
Ejemplos para probarlo
| Pídele | Qué hace |
|---|---|
| «¿Cuánto cuesta el m² de alicatado de baño con porcelánico?» | Consulta la Base BuildGets 2026 y responde con el precio típico, el rango habitual y las partidas en que se basa, con su enlace. Precio de ejecución material, sin IVA. |
| «Abre este presupuesto: https://www.buildgets.com/ejemplos/presupuesto-reforma-bano.bc3» | Lee el BC3 y resume título, total, capítulos y número de partidas, con un enlace para abrirlo y editarlo en BuildGets. |
| «Hazme un presupuesto para reformar un baño de 5 m² en Madrid, calidad media» | Pregunta lo que falte, propone los capítulos, busca cada precio en la base, mide las partidas, revisa el resultado y te da el BC3 con su total (PEM, gastos generales, beneficio industrial e IVA). |
| «¿Qué presupuestos tengo guardados en BuildGets?» | Lista tus presupuestos guardados y puede abrir cualquiera para resumirlo. |
| «Convierte a BC3 el PDF de este enlace: …» | Pasa el presupuesto del PDF a BC3 con la lectura de BuildGets PDF y lo deja en Mis BuildGets. Gasta conversiones de tu plan. |
Límites
- Los precios son de obra en España (Base BuildGets 2026), de ejecución material: sin gastos generales, beneficio industrial ni IVA.
- Convertir PDF o Excel y exportar a BC3 gastan el mismo cupo de tu plan que en la web; el asistente lo avisa antes con el plan gratuito.
- Un PDF largo se convierte por partes de 8 páginas y puede tardar unos minutos.
- Para convertir un archivo, el asistente necesita que lo subas al chat (si lo admite) o un enlace público (Google Drive, Dropbox…).
Privacidad y ayuda
Qué datos recibe BuildGets del asistente y cuánto tiempo se guardan: Política de privacidad › Conexiones. ¿Algo no funciona? Escríbenos a soporte@buildgets.com.
🧱 Widget para tu web
Una calculadora de reformas (piso, baño, cocina u oficina, por calidad y m²) o un buscador de precios de obra, con tu color, para tu web de reformas, tu portal o tu blog. Créalo en Mi cuenta › Widget para tu web, indica en qué webs lo vas a poner y pega estas dos líneas donde quieras que aparezca:
<div data-buildgets-widget="wp_…"></div>
<script src="https://www.buildgets.com/widget.js" async></script>
- Solo se muestra en las webs que indiques (hasta 3, con sus subdominios). Si alguien copia el código en otra web, no aparece.
- No pone cookies ni lee nada de tu web. Se adapta al ancho y al móvil.
- En Mi cuenta ves sus vistas, cálculos y clics de los últimos 30 días.
🔗 Holded
Conecta tu cuenta de Holded en Mi cuenta › Holded con su clave de API (en Holded: Ajustes › Desarrolladores). Desde el editor de BC3, PDF y EXCEL, el botón «Holded» crea el cliente y un presupuesto con tus capítulos y partidas en Holded › Ventas › Presupuestos. La clave se guarda cifrada y nunca vuelve al navegador.
🔒 Seguridad
- Las claves de API y los accesos de los asistentes no se guardan: solo su huella cifrada (SHA-256). Si los pierdes, se revocan y se crean otros.
- El conector para asistentes usa el inicio de sesión estándar OAuth 2.1 con PKCE: accesos de 1 hora que se renuevan y se pueden desconectar en cualquier momento.
- Cada conexión ve solo los datos de su cuenta.
📄 Condiciones de uso de la API y del conector
Al usar la API, el conector para asistentes de IA o el widget aceptas estas condiciones, además de las Condiciones de Contratación y la Política de Privacidad:
- Uso permitido: consultar precios, abrir y convertir presupuestos para tu trabajo o el de tu empresa, y mostrar los resultados en tus propias herramientas o en tu web.
- No está permitido: revender o ceder el acceso a terceros; descargar o copiar la Base BuildGets de forma masiva o sistemática para crear otra base de precios; saltarse los límites de uso o usar varias claves o cuentas para multiplicarlos.
- Límites: cada clave y cada conexión tienen el cupo de su plan y un límite de peticiones. Si detectamos un uso abusivo o contrario a estas condiciones, podemos limitar o revocar la clave o la conexión, avisándote cuando sea posible.
- Atribución: si muestras precios de la Base BuildGets a terceros, cita la fuente como «Base BuildGets» con un enlace a buildgets.com/precios.
- Sin garantía: los precios son de referencia (ejecución material, sin GG, BI ni IVA) y las conversiones las hace un sistema automático. Revisa siempre el resultado antes de presentarlo o contratar; BuildGets no responde de decisiones tomadas solo con estos datos.
- Cambios: la API y el conector pueden cambiar o retirarse; avisaremos con antelación razonable de los cambios que te afecten.