5.000 llamadas / mes
Cuota compartida por las claves de la cuenta. Mes natural de Europe/Madrid.
Conecta tu CRM, ERP o aplicación interna con la API de lectura de Goover. Consulta el catálogo y reutiliza los datos en tu flujo de trabajo.
Gestionar mis claves →Ver documentaciónGET /api/v1/catalog?kind=grant
Authorization: Bearer TU_CLAVE
Accept: application/json
{ "data": [...],
"links": {...},
"meta": {...} }Cuota compartida por las claves de la cuenta. Mes natural de Europe/Madrid.
Identifica cada integración, rota sus credenciales y revoca las que ya no utilices.
Consulta oportunidades. No crea clientes, envía ofertas ni ejecuta análisis IA.
El endpoint https://goover.es/api/mcp ofrece las herramientas search_opportunities y get_opportunity mediante Streamable HTTP. Busca en el catálogo importado y devuelve referencias oficiales.
Necesitas un cliente compatible con cabeceras Authorization: Bearer. No utiliza OAuth y no accede a clientes, archivos privados ni análisis. Comparte las 5.000 llamadas mensuales y las dos claves con la API REST; la inicialización también consume una llamada.
Authorization: Bearer TU_CLAVE y Accept: application/json.Endpoint: https://goover.es/api/v1/catalog. Usa el dominio de tu instalación y HTTPS en producción. La URL mostrada corresponde a este entorno.
| Parámetro | Valores / límite | Uso |
|---|---|---|
| q | Texto, hasta 180 caracteres | Buscar términos en el catálogo. |
| kind | grant, tender, award, guide | Ayuda, licitación, adjudicación o guía. |
| cpv | Entre 2 y 8 dígitos | Código de clasificación CPV. |
| status | open, closed, awarded, resolved, upcoming | Estado de la oportunidad. |
| page | 1–1.000 | Página de resultados, 50 por página. |
Combina los parámetros con & y codifica correctamente los caracteres especiales. Los filtros del buscador visual no están disponibles automáticamente en la API: utiliza los documentados aquí.
data contiene las oportunidades; links incluye enlaces de paginación y meta los totales y la página actual. Avanza con page y detente cuando links.next sea nulo. Las páginas no son una instantánea inmutable: deduplica por id si sincronizas mientras cambia el catálogo.
id, kind, title, description, organization, status, amount, amount_basis, currency, deadline, source, source_url, territories, cpv_codes, documents y requirements, entre otros.
Los campos pueden ser nulos o estar vacíos si la fuente no publica esa información. amount no equivale a una ayuda concedida a tu empresa: interpreta amount_basis y consulta las bases. Las fechas de publicación y revisión se devuelven en formato ISO; los plazos utilizan fecha de calendario.
{
"data": [{
"id": 123,
"kind": "grant",
"title": "Ejemplo ilustrativo de convocatoria",
"amount": "6000.00",
"amount_basis": "Presupuesto total de la convocatoria; no es el importe por beneficiario",
"currency": "EUR",
"deadline": null
}],
"links": { "next": null },
"meta": { "current_page": 1, "per_page": 50 }
}Respuesta abreviada e ilustrativa. Los importes y los campos concretos dependen del registro de origen.
Estos ejemplos consultan una página de ayudas. Configura GOOVER_API_URL con el endpoint de tu instalación y GOOVER_API_KEY con una clave de Goover, no con la clave de OpenAI. Las dependencias se indican en cada ejemplo.
curl --get "$GOOVER_API_URL" \
--header "Authorization: Bearer $GOOVER_API_KEY" \
--header "Accept: application/json" \
--data-urlencode 'kind=grant' \
--data-urlencode 'q=digitalización' \
--data-urlencode 'page=1' \
--fail-with-bodyconst url = new URL(process.env.GOOVER_API_URL);
url.search = new URLSearchParams({kind: 'grant', page: '1'});
const response = await fetch(url, {
headers: {
Authorization: `Bearer ${process.env.GOOVER_API_KEY}`,
Accept: 'application/json'
},
signal: AbortSignal.timeout(30000)
});
if (!response.ok) throw new Error(`Goover HTTP ${response.status}`);
const result = await response.json();
console.log(result.data);
console.log(response.headers.get('X-API-Monthly-Remaining'));Ejecuta este código en el servidor; no publiques la clave en JavaScript del navegador.
import os
import requests
response = requests.get(
os.environ['GOOVER_API_URL'],
params={'kind': 'grant', 'page': 1},
headers={
'Authorization': f"Bearer {os.environ['GOOVER_API_KEY']}",
'Accept': 'application/json'
},
timeout=30
)
response.raise_for_status()
print(response.json()['data'])Dependencia: requests.
$query = http_build_query(['kind' => 'grant', 'page' => 1]);
$curl = curl_init(getenv('GOOVER_API_URL') . '?' . $query);
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . getenv('GOOVER_API_KEY'),
'Accept: application/json',
],
]);
$body = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
if ($body === false || $status !== 200) {
throw new RuntimeException('Error consultando Goover: ' . $status);
}
curl_close($curl);
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result['data']);using System.Net.Http.Headers;
using System.Text.Json;
using var client = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
client.DefaultRequestHeaders.Authorization =
new AuthenticationHeaderValue("Bearer",
Environment.GetEnvironmentVariable("GOOVER_API_KEY"));
client.DefaultRequestHeaders.Accept.Add(
new MediaTypeWithQualityHeaderValue("application/json"));
var endpoint = Environment.GetEnvironmentVariable("GOOVER_API_URL")
?? throw new InvalidOperationException("Falta GOOVER_API_URL");
using var response = await client.GetAsync(endpoint + "?kind=grant&page=1");
response.EnsureSuccessStatusCode();
using var result = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
Console.WriteLine(result.RootElement.GetProperty("data"));5.000 llamadas por mes natural, hasta 2 claves activas y 30 solicitudes por minuto por IP. Las llamadas autenticadas admitidas consumen cuota aunque los filtros sean inválidos. La revocación no reinicia el consumo.
200: consulta correcta.401: clave ausente, inválida, caducada o revocada.403: cuenta bloqueada, dada de baja o clave no habilitada por el plan.422: filtros no válidos.429: límite por minuto o cuota mensual alcanzados.5xx: incidencia del servicio; reintenta con esperas crecientes.Consulta X-API-Monthly-Limit, X-API-Monthly-Remaining y X-API-Monthly-Reset en las respuestas que las incluyan. Ante 429, respeta Retry-After cuando esté presente y no hagas reintentos en bucle.
Un servicio propio o un conector HTTP puede consultar la API y transformar los resultados para tu CRM, ERP u hoja de cálculo. Son integraciones que debes configurar en tu sistema; no se ofrecen conectores nativos ni webhooks. La API REST es de lectura; el acceso MCP se describe más arriba.
Consultar una integración →