Docs

Diccionarios

Última actualización: 2026-10-022 min de lectura

En las respuestas de inmuebles, los campos de categoría y atributos llegan como códigos (por ejemplo type: "Residential", condition: "Cosmetic renovation", utilitySystem: ["gas", "water"]). Este endpoint convierte los códigos en etiquetas legibles en cualquiera de los 10 idiomas admitidos. Gratis y abierto a cualquier clave.

Dirección base: https://developers.grem.capital/api/v1.

Etiquetas para un idioma

GET /dictionaries?lang=es
Authorization: Bearer gsk_live_...

Devuelve todos los diccionarios aplanados a { code: label } para ese idioma:

{
  "version": "sha256-...",
  "lang": "es",
  "dictionaries": {
    "propertyType": { "Residential": "Residencial", "Commercial": "Comercial", ... },
    "condition": { ... },
    "utilitySystem": { ... },
    ...
  },
  "requestId": "req_..."
}

lang admitidos: en, ru, uk, de, es, az, ar, fr, zh, tr. Cualquier otro, 400. Si un código no tiene etiqueta en el idioma pedido, se devuelve la inglesa.

Variantes

  • Todos los idiomas a la vez: omita lang. Cada código llega con un objeto labels: { "value": "Residential", "labels": { "en": "Residential", "uk": "Житлова", ... } }.
  • Un diccionario: añada name, por ejemplo GET /dictionaries?name=propertyType&lang=es. Nombre desconocido, 404.

Diccionarios disponibles

propertyType, residentialType, commercialType, industrialType, condition, utilitySystem, amenities, onsiteAmenities, apartType, apartmentType, status, objectType.

La respuesta tiene una version y se guarda en caché un día: descárguela una vez y reutilícela. Con el tiempo pueden añadirse códigos; si falta un código en su copia guardada, muestre el código tal cual en lugar de fallar.

¿Le resultó útil este artículo?