Documentación para desarrolladores

Conecta tus herramientas con los datos de LicitaIA

Consulta licitaciones y recomendaciones desde tu servidor con una API v1 estable, documentada y lista para probar.

La documentación es pública

La lectura Free usa una clave con licitaciones:read, 200 operaciones/mes por organización y 10/min. Las operaciones premium requieren Pro, Team o AAPP; el MCP privado recomienda OAuth.

Lee tus licitaciones desde tu servidor

Guarda la clave en una variable de entorno y envíala en x-api-key. Este ejemplo solo consulta datos. El identificador y la respuesta son ilustrativos.

# Nunca pongas la clave en el navegador
curl https://api.licitaia.org/api/v1/licitaciones \
  -H "x-api-key: $LICITAIA_API_KEY"
Servidor Node.jsfetch
const response = await fetch(
  'https://api.licitaia.org/api/v1/licitaciones',
  { headers: { 'x-api-key': process.env.LICITAIA_API_KEY } },
);
if (!response.ok) throw new Error(`API ${response.status}`);
const data = await response.json();

Ejecuta esta llamada en backend para que la clave no llegue al navegador.

Respuesta ilustrativa200
{
  "data": [{
    "id": "00000000-0000-4000-8000-000000000001",
    "title": "Servicio de mantenimiento",
    "presupuestoBase": 12000
  }]
}

Extracto ilustrativo: los ejemplos oficiales usan datos sintéticos y siguen el contrato OpenAPI.

La referencia completa vive en OpenAPI

Swagger UI permite explorar grupos, esquemas, autenticación y Try it out. El JSON y el Markdown se generan del mismo documento que la interfaz, para que una integración humana y un agente de programación vean el mismo contrato.

Una clave con permisos concretos

Crea y gestiona claves desde Equipo · API. El secreto se muestra una sola vez. Crear, rotar y revocar requiere ser owner o admin de la organización; consultar consumo está disponible para sus miembros.

La documentación no requiere login. El uso de la API requiere una conexión OAuth o una clave válida con los permisos de tu plan; Free incluye lectura básica.

Empieza por lecturas

Las rutas GET de licitaciones, recomendaciones, análisis y veredictos son de lectura. POST /api/v1/licitaciones/{id}/veredicto recalcula de forma determinista y no consume créditos. POST /api/v1/analisis puede iniciar un análisis y cobrar 2 créditos; si la API puede reutilizar un análisis existente, no lanza otro trabajo. Revisa la respuesta antes de automatizar costes.

Ver scopes y costes en la referencia

Lleva una búsqueda a Google Sheets con n8n

Importa la plantilla, conecta tu clave de lectura y elige una hoja. Cada ejecución manual consulta una página y actualiza las filas por identificador de licitación. Incluye los enlaces oficiales y avisa cuando la respuesta está limitada.

Compatible con la lectura Free: 200 operaciones al mes compartidas por organización. Necesitas tu instancia de n8n y una conexión de Google Sheets; esta plantilla no incluye su alojamiento ni sustituye una vigilancia exhaustiva.

Usa la API desde un cliente MCP

Claude, Codex y Cursor pueden usar el servidor MCP con la misma clave, scopes y cuota compartida de la API.

Ver pasos, permisos y ejemplos