Página de aterrizaje del inmueble
POST /site/create: ámbito tools:sitegen, al momento. Una página de aterrizaje con enlace para compartir de un inmueble, suyo o cualquiera público.
| Campo | Tipo | Descripción |
|---|---|---|
objectId | cadena | obligatorio: id del inmueble |
siteName | cadena | nombre del enlace en su lista |
language | cadena | ENG (por defecto), RUS, UKR, DEU, SPA, AZE, ARB, FRA, ZHO, TUR |
coverPhotoId | cadena | foto del inmueble que se muestra primero |
brandColor | cadena | color de acento #RRGGBB |
showPhone | sí/no | mostrar su teléfono en la página (por defecto no) |
curl -X POST https://developers.grem.capital/api/v1/site/create \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"objectId":"OBJECT_ID","siteName":"Torstraße 12","language":"SPA"}'
Respuesta:
| Campo | Descripción |
|---|---|
landingId | id del sitio |
baseUrl | dirección del sitio |
link | el enlace creado: nombre, idioma, código y dirección |
Sin objectId, 400; un inmueble inaccesible, 403 o 404.
Presentación en PDF
POST /pdf/create: ámbito tools:pdf, trabajo. Un PDF con su marca para un inmueble, suyo o cualquiera público.
| Campo | Tipo | Descripción |
|---|---|---|
pdfName | cadena | obligatorio: nombre del documento, hasta 200 caracteres |
objectId | cadena | obligatorio: id del inmueble |
language | cadena | ENG (por defecto), RUS, UKR, DEU, SPA, AZE, ARB, FRA, ZHO, TUR |
descriptionType | cadena | presentation (por defecto), description o social |
currency | cadena | UAH, USD, EUR, AZN, GBP, AED, CNY, TRY, GEL |
priceForPdf | número | otro precio para el documento |
coverPhotoId | cadena | foto de portada |
descriptionOverride | cadena | su propio texto solo para este documento, hasta 3000 caracteres |
brandColor | cadena | color de acento #RRGGBB |
curl -X POST https://developers.grem.capital/api/v1/pdf/create \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"pdfName":"Torstraße 12 - presentación","objectId":"OBJECT_ID","language":"SPA"}'
El idioma debe ir en mayúsculas y ser de esta lista: ru o en devuelven 400.
202 con jobId. El trabajo terminado (GET /pdf/create/jobs/{id}):
| Campo | Descripción |
|---|---|
link | dirección directa del documento |
pageCount | páginas |
sizeBytes | tamaño |
coverImageUrl | portada |
El archivo también está en GET /artifacts/v1/ai/pdf-generator/files/{id}/download. Eventos: pdf.completed / pdf.failed.
Folleto personal
POST /flyer/create: ámbito tools:flyer, al momento. Un folleto de agente (A4, cuadrado o historia) con su foto, cifras de la plataforma y un código QR a su enlace de referido. El folleto en sí es gratuito; solo se cobra la llamada a la API.
| Campo | Tipo | Descripción |
|---|---|---|
language | cadena | ENG (por defecto) y el resto de códigos, como en la página de aterrizaje; mayúsculas o minúsculas, da igual |
layouts | array | a4 (impresión), feed45, square, story, link; por defecto ["a4"]; al menos uno; mayúsculas o minúsculas, da igual |
formats | array | png, jpg, pdf; por defecto ["png","pdf"]. El PDF solo se genera para a4; de uno a tres; mayúsculas o minúsculas, da igual |
name, role, city, kicker | cadena | nombre, rol, ciudad, subtítulo |
photoRef | cadena | avatar: su foto de perfil, o una imagen como data:image/... |
ctaUrl | cadena | enlace de referido para el QR (solo dominios de la plataforma) |
slogan | array | hasta 2 líneas |
features | array | hasta 6 elementos { "icon", "title" }; icon: crm, ai, globe, publisher, marketing, shield, wallet, chart, lock o handshake |
joinTitle, joinNote | cadena | llamada a unirse |
builtFor | array | para quién es, hasta 6 líneas |
footer | array | hasta 2 líneas |
contacts | objeto | contactos: teléfono, correo, etc. |
Los campos desconocidos se descartan.
curl -X POST https://developers.grem.capital/api/v1/flyer/create \
-H "Authorization: Bearer gsk_live_xxx" \
-H "Content-Type: application/json" \
-d '{"language":"SPA","layouts":["a4"],"formats":["pdf"],"name":"Anna Schmidt","role":"Agente inmobiliaria","city":"Berlin","photoRef":"avatar"}'
Respuesta:
| Campo | Descripción |
|---|---|
files | archivos generados |
files[].layout, files[].format | diseño y tipo de archivo |
files[].width, files[].height, files[].bytes | tamaño |
files[].path | ruta de descarga: https://developers.grem.capital/api/v1/artifacts + path |
ctaUrl | el enlace impreso en el QR |
historyId | registro en el historial de folletos |
Borrador a partir de documentos o de un sitio web
POST /draft/extract: ámbito tools:draft, al momento. GREM lee folletos, listas de precios o el sitio web de un promotor y crea un borrador de inmueble con campos y fotos. Límite: 2 borradores al día por cuenta; el siguiente se rechaza con 403 hasta el día siguiente. Solo se cobra la llamada a la API, sin precio de herramienta.
Cuerpo: multipart/form-data:
| Parte | Descripción |
|---|---|
data | cadena JSON: {"type": "property"} o {"type": "complex"}, opcionalmente con "site": "https://...": obligatorio |
| archivos | documentos (PDF, DOC/DOCX, imágenes) con cualquier nombre de parte |
Envíe archivos o site en data; si no, 400 con el campo files.
curl -X POST https://developers.grem.capital/api/v1/draft/extract \
-H "Authorization: Bearer gsk_live_xxx" \
-F 'data={"type":"complex"}' \
-F "[email protected]" -F "[email protected]"
La respuesta es el borrador creado (no publicado). Revíselo y complételo con GET /objects/{kind}/{id} y PUT /objects/{kind}/{id} (Inmuebles).