API v1.0 - Beta
API de BIA
Integra la potencia de BIA en tus aplicaciones. Accede a información de ayudas públicas y automatiza la gestión de subvenciones.
Inicio rápido
1. Obtén tu API Key
Disponible en el plan Premium. Accede a tu dashboard y genera tu clave API.
2. Autenticación
Incluye tu API Key en el header de todas las peticiones:
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
3. Primera llamada
Prueba la API con una búsqueda simple:
curl -X POST https://api.ayudas.ai/v1/search \
-H "Authorization: Bearer YOUR_API_KEY"\
-H "Content-Type: application/json"\
-d '{
"query": "ayudas digitalización pyme",
"location": "Madrid",
"limit": 10
}'Endpoints principales
POST
/v1/search
Busca ayudas y subvenciones según criterios específicos.
Parámetros:
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
| query | string | Sí | Términos de búsqueda |
| location | string | No | Comunidad autónoma o provincia |
| sector | string | No | Sector empresarial |
| limit | integer | No | Número de resultados (max 50) |
Respuesta:
{
"success": true,
"data": {
"results": [
{
"id": "ayuda_123",
"title": "Kit Digital 2025",
"organismo": "Red.es",
"amount_max": 24000,
"deadline": "2025-12-31",
"compatibility_score": 0.92,
"requirements": [...]
}
],
"total": 15,
"page": 1
}
}GET
/v1/grants/{id}
Obtiene información detallada de una ayuda específica.
POST
/v1/eligibility/check
Verifica la elegibilidad de tu empresa para una ayuda específica.
POST
/v1/alerts
Configura alertas automáticas para nuevas ayudas.
Límites de uso
Plan Premium
- • 1000 peticiones/hora
- • 10.000 peticiones/día
- • Sin límite mensual
Headers de respuesta
- • X-RateLimit-Limit
- • X-RateLimit-Remaining
- • X-RateLimit-Reset
SDKs y librerías
🟨
JavaScript/Node.js
Cliente oficial para JavaScript
npm install @bia/sdk🐍
Python
Cliente oficial para Python
pip install bia-sdk📦
Otros lenguajes
Próximamente
PHP, Ruby, Go...¿Listo para integrar BIA?
Accede a la API con el plan Premium y automatiza la gestión de ayudas