La API de GREM da acceso programático a lo que ofrece el panel: las herramientas (valoración, textos, vídeo, fotos, PDF, sitios), sus inmuebles, leads y eventos. Todas las solicitudes van a una sola dirección:
https://developers.grem.capital/api/v1
La descripción completa legible por máquina es /openapi.json; la interactiva está en /docs.
Cree una clave
En el panel abra API → Claves y pulse Crear clave. La clave se muestra una sola vez: guárdela en un gestor de secretos. Una clave nueva recibe todos los ámbitos; puede limitarlos al crearla. Detalles: Autenticación.
Compruebe la clave
curl https://developers.grem.capital/api/v1/ping \
-H "Authorization: Bearer gsk_live_xxx"
{"ok": true, ...} significa que la clave funciona. GET /ping es gratuito y no necesita ámbito. GET /me muestra qué puede hacer exactamente la clave.
Llame a una herramienta síncrona
La valoración exprés responde al momento:
curl -X POST https://developers.grem.capital/api/v1/valuation/express \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 6b1f0c2e-6c1e-4a8e-9f5d-3c2a1b0e9d87" \
-d '{"propertyCategory":"apartment","addressText":"Torstraße 12, Berlin","totalArea":64,"rooms":2,"currency":"EUR"}'
{
"estimate": { "pricePoint": <number>, "rangeLow": <number>, "rangeHigh": <number>, "confidence": "<level>", "currency": "EUR" },
"requestId": "req_..."
}
Idempotency-Key hace segura la repetición: repetir la solicitud con la misma clave devuelve el primer resultado y no cobra de nuevo.
Lance un trabajo asíncrono
Las herramientas largas responden 202 con un trabajo. Si quiere el resultado por webhook, suscríbase primero (paso 5): un trabajo lanzado antes de la suscripción no envía su evento.
curl -X POST https://developers.grem.capital/api/v1/text/generate \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"city":"Berlin","totalArea":64,"rooms":2,"propertyCategory":"apartment","language":"en"}'
{ "jobId": "...", "status": "...", "state": "pending", "requestId": "req_..." }
Consulte el estado (gratis) hasta que state sea completed, partial o failed:
curl https://developers.grem.capital/api/v1/text/generate/jobs/JOB_ID \
-H "Authorization: Bearer gsk_live_xxx"
Cómo funcionan los trabajos y cómo descargar los archivos: Trabajos y resultados.
Reciba el resultado por webhook
En lugar de consultar, suscríbase al evento: GREM envía un POST a su URL cuando el trabajo termina. Suscríbase antes de lanzar el trabajo: un trabajo lanzado antes de la suscripción no envía su evento.
curl -X POST https://developers.grem.capital/api/v1/webhooks \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/grem-hook","events":["text.completed","text.failed"]}'
La respuesta contiene el secreto de firma whsec_..., que se muestra una vez. Cómo verificar la firma: Webhooks.
Pruebe sin gastar: una clave con prefijo gsk_test (elija el tipo de clave Prueba al crearla) funciona en el sandbox: las herramientas responden con resultados de muestra, no se crea ni se cobra nada.
Siguientes pasos
- Herramientas por API: todas las herramientas y lo que hacen.
- Errores: cómo leer los rechazos y qué repetir.
- Límites y cobro: cuántas solicitudes y qué se cobra.
- SDK de TypeScript: un cliente listo sin dependencias.