Todas las subvenciones en plazo, en tu código
Conecta tu CRM, ERP o producto con miles de convocatorias estatales, autonómicas, locales y europeas, actualizadas a diario.
Incluida en el plan Enterprise · 10.000 peticiones al mes
Filtros completos
Región, provincia, sector, CNAE, beneficiario, importe y plazo.
Siempre en plazo
Solo convocatorias abiertas; las vencidas desaparecen solas.
Claves por empresa
Crea y revoca claves cuando quieras desde Ajustes.
Acceso controlado
HTTPS, claves almacenadas mediante hash y límites de uso por cuenta.
Primeros pasos
- Entra en la app, ve a Ajustes → API y crea una clave. Se muestra una sola vez.
- Envíala en cada petición en la cabecera
Authorization: Bearer isk_…. - URL base:
https://yinlklwaztnredfkpdga.supabase.co/functions/v1/api-v1
curl "https://yinlklwaztnredfkpdga.supabase.co/functions/v1/api-v1/v1/grants?region=Andalucía&perfil=pyme&per_page=10" \
-H "Authorization: Bearer isk_TU_CLAVE"Endpoints
Catálogos para filtrar: regiones, sectores, provincias y tipos de beneficiario.
Búsqueda paginada de convocatorias en plazo. Filtros: q, region, sector, provincia, perfil, cnae, importe_min, importe_max, cierre_hasta, orden, page, per_page.
Ficha completa: descripción, beneficiarios, objetivos, importe, plazos, bases y documentos.
Documentación oficial publicada por el organismo.
Búsqueda inteligente: describe lo que buscas en lenguaje natural y la IA lo convierte en filtros.
Resumen con IA de la convocatoria y sus bases.
Requisitos, documentación y anexos extraídos con IA.
Compatibilidad con IA: puntuación, veredicto y motivos para una empresa.
Mínimis por CIF/NIF: ayudas recibidas en los 3 últimos años, acumulado por reglamento y margen disponible (BDNS).
Radar de oportunidades: subvenciones recomendadas para el perfil de una empresa (CNAE, comunidad, sector) o para un perfil enviado.
Empresas gestionadas por la cuenta (gestorías y grupos con plan Enterprise).
Expedientes: crear, listar, cambiar estado, asignar responsable y eliminar (GET, POST, PATCH, DELETE).
Avisos en tiempo real cuando una alerta encuentra ayudas nuevas, firmados con HMAC-SHA256.
Servidor MCP para Claude, ChatGPT y agentes de IA: buscar, radar, fichas y expedientes como herramientas.
Especificación OpenAPI 3.0.3 (sin autenticación), lista para Postman, generadores de clientes o LLMs.
Ejemplo de respuesta
{
"count": 128,
"page": 1,
"per_page": 10,
"results": [
{
"id": "6f1c…",
"titulo": "Ayudas a la digitalización de pymes",
"organo": "Agencia de Innovación",
"region": "Andalucía",
"sector": "Tecnología / I+D+i",
"perfiles": ["autonomo", "pyme"],
"fecha_cierre": "2026-11-30",
"importe_total": 2400000,
"url_ficha": "https://iasubvenciones.com/subvenciones/c/…"
}
]
}Errores y límites
- 401 — clave ausente, no válida o revocada.
- 404 — convocatoria inexistente o fuera de plazo.
- 429 — límite mensual alcanzado o plan sin API.
- Cabeceras
X-RateLimit-LimityX-RateLimit-Remainingen cada respuesta. - Errores con formato
{ "error": { "code", "message" } }.
Consulta OpenAPI para confirmar métodos, parámetros y respuestas. Radar, expedientes, webhooks y MCP comparten autorización y control de consumo del espacio de trabajo.
Diseñar una integración fiable con la API de subvenciones
Los ejemplos de código resuelven una primera consulta. Para convertirla en una función útil de tu producto, también debes decidir qué datos necesita el usuario, cómo manejarás paginación y errores y qué acciones podrá realizar la integración. La API conecta recursos del espacio de trabajo autorizado; no es una vía para acceder a datos de cualquier empresa.
Filtros e importes: entender la respuesta antes de mostrarla
Consulta los catálogos de filtros antes de enviar valores de región, sector, provincia o beneficiario. Usa la paginación de la respuesta y evita asumir que una primera página representa todas las coincidencias. Para una búsqueda en lenguaje natural, revisa los filtros interpretados en lugar de tratar una recomendación como un resultado jurídico.
Distingue presupuesto total de convocatoria de ayuda individual y no completes datos ausentes con estimaciones no identificadas. Muestra el plazo y el enlace oficial para que la persona pueda verificar condiciones. El catálogo principal se orienta a ayudas en plazo; no equivale a un histórico completo de concesiones.
Consultas, análisis y operaciones sobre expedientes
Buscar, recuperar una ficha y consultar documentos son operaciones de lectura. Los endpoints de expedientes permiten acciones de gestión, y los de IA preparan resúmenes, requisitos o análisis de compatibilidad con el contexto indicado. Consulta la especificación OpenAPI para confirmar método, parámetros y respuesta de cada operación.
No envíes una escritura con una empresa elegida únicamente en una pantalla sin verificar el contexto de la clave. Un cambio de estado interno no significa que se haya registrado una solicitud ante el organismo. Para análisis, conserva los datos de origen y permite revisión humana de condiciones y conclusiones.
Proteger claves y controlar errores
La clave se entrega al generarla y se almacena de forma protegida mediante hash en el servicio. Mantén la credencial que utilizas fuera del navegador y de repositorios públicos; revócala cuando deje de ser necesaria. Nunca uses una clave privada en un ejemplo que vayas a publicar.
Trata 401 como un problema de credencial, 404 como un recurso no disponible y 429 como un límite que requiere revisar cuota o ritmo de uso. No repitas indefinidamente una petición fallida. Diseña en tu cliente un tratamiento de errores de red y de respuestas incompletas que no convierta la incidencia en «no hay ninguna ayuda».
Añadir eventos y agentes después de verificar la lectura
Los webhooks permiten reaccionar a nuevas coincidencias y se firman con HMAC-SHA256. Tu receptor debe validar la firma y evitar que una entrega repetida cree registros duplicados. Recupera el detalle por API cuando sea necesario, en lugar de asumir que el aviso contiene toda la información.
MCP utiliza las mismas reglas de autorización y consumo para ofrecer herramientas a clientes compatibles. Comprueba transporte y autenticación antes de elegir un cliente concreto. Si tu flujo permite cambiar expedientes, añade una confirmación de usuario en el cliente antes de acciones relevantes. Disponer de una herramienta no hace correctas todas las interpretaciones del agente.
Ejemplo ilustrativo · No es un caso de cliente
De una consulta a una oportunidad revisable en el CRM
Ejemplo ilustrativo: tu servidor consulta ayudas para un perfil autorizado y muestra título, plazo y enlace sin prometer financiación. El usuario revisa una ficha y decide abrir un expediente. Una alerta genera un evento que tu receptor verifica antes de crear una tarea. La implementación controla duplicados, paginación, credenciales y cuotas. Cuando una consulta falla, informa de la incidencia y no presenta una lista vacía como prueba de ausencia de ayudas.
Antes de dar el siguiente paso
- Catálogos y filtros válidos
- Importes y fechas interpretados correctamente
- Paginación y errores tratados
- Clave privada protegida y revocable
- Firma y duplicados de eventos controlados
- Escrituras autorizadas y revisadas
Preguntas frecuentes
¿Dónde consulto los métodos y parámetros de cada endpoint?
En la especificación OpenAPI enlazada en esta página. Los recursos no comparten necesariamente el mismo método: los endpoints de escritura o análisis deben consultarse con su contrato específico.
¿El catálogo incluye ayudas vencidas?
La búsqueda principal está orientada a convocatorias en plazo. El histórico completo de concesiones es un alcance distinto de la consulta de oportunidades y de mínimis bajo demanda.
¿Puedo consultar mínimis como certificación definitiva?
No. La consulta a BDNS ayuda a revisar información disponible, pero debe contrastarse con las ayudas declaradas y el reglamento aplicable a la empresa o grupo.
¿Puedo utilizar la API en un producto para clientes finales?
Define con el equipo el modelo de distribución, destinatarios, acceso y volumen. No presupongas que una clave interna habilita automáticamente cualquier uso público o reventa.