properties

Ficha completa de una propiedad

get/properties/{listingKey}

Request

  • Base URL: https://api.inmo.example/v1
  • URL: https://api.inmo.example/v1/properties/{listingKey}
  • Auth: one of:
    • none
    • API key in header X-API-Key

Response

La propiedad, con media y procedencia.

listingKeystring required

RESO ListingKey. ID estable con prefijo de fuente.

listingIdstring

RESO ListingId (ID de la fuente).

standardStatus'Active' | 'Active Under Contract' | 'Pending' | 'Closed' | 'Coming Soon' | 'Hold' | 'Withdrawn' | 'Canceled' | 'Expired' | 'Incomplete' | 'Delete'

RESO StandardStatus — lookup oficial. Se adopta el conjunto completo aunque el adaptador de Facebook sólo emita Active/Pending/Closed/Withdrawn.

propertyType'Residential' | 'Residential Lease' | 'Residential Income' | 'Commercial Sale' | 'Commercial Lease' | 'Business Opportunity' | 'Land' | 'Farm' | 'Manufactured In Park' required

RESO PropertyType — lookup oficial. En RESO la transacción (venta/renta) ya está codificada en el tipo (p. ej. Residential Lease). transactionType es una conveniencia derivada, no reemplaza a este campo.

propertySubType'Single Family Residence' | 'Condominium' | 'Townhouse' | 'Apartment' | 'Duplex' | 'Multi Family' | 'Manufactured Home' | 'Mobile Home' | 'Cabin' | 'Ranch' | 'Unimproved Land' | 'Office' | 'Retail' | 'Warehouse' | 'Other'

RESO PropertySubType — lookup oficial (subconjunto de uso común en MX).

transactionType'ForSale' | 'ForLease' required

Conveniencia derivada de PropertyType para la superficie REST/agentes. No es un campo RESO; RESO lo expresa dentro de PropertyType.

listPricenumber required

RESO ListPrice, en la unidad mayor de la moneda.

listPriceCurrencystring required

RESO ListPriceCurrency (ISO-4217). Obligatorio.

priceTrustedboolean

X-PriceTrusted. Falso si la moneda del precio es ambigua.

bedroomsTotalinteger nullable
bathroomsTotalIntegerinteger nullable
bathroomsHalfinteger nullable

Medios baños (0.5 c/u ya excluidos de bathroomsTotalInteger).

propertyKindstring nullable

Tipo elegido por el anunciante (casa, departamento, bodega, terreno…).

propertySubtypestring nullable

Subtipo (ej. casa de campo/ciudad/playa).

parkingSpotsinteger nullable
floorsinteger nullable

Niveles del inmueble.

floorNumberinteger nullable

Piso en el que está (depto/oficina/local).

lotSqmnumber nullable

Superficie de terreno; la construida es livingArea.

clearHeightMnumber nullable

Altura libre en metros (bodega/nave).

unitsinteger nullable

Unidades (edificio).

furnishedboolean nullable
livingAreanumber nullable
livingAreaUnits'SquareMeters' | 'SquareFeet'

RESO LivingAreaUnits. Obligatorio si hay área; nunca asumir.

publicRemarksstring nullable

RESO PublicRemarks (descripción).

latitudenumber nullable
longitudenumber nullable
unparsedAddressstring nullable

RESO UnparsedAddress (dirección en texto libre).

postalCodestring nullable
citystring nullable
stateOrProvincestring nullable
countrystring
coloniastring nullable

Extensión X-Colonia.

municipiostring nullable

Extensión X-Municipio.

photoCountinteger
originatingSystemNamestring

RESO OriginatingSystemName (la fuente/sistema de origen).

listAgentKeystring nullable

RESO ListAgentKey — Member que publica (individuo o agente).

listOfficeKeystring nullable

RESO ListOfficeKey — Office (agencia) del anuncio, si aplica.

contactPhonestring nullable

Teléfono que el anunciante publicó visible en su ficha (10 dígitos MX).

contactWhatsappstring nullable

Enlace wa.me al WhatsApp del anunciante, si hay teléfono.

publisherKeystring nullable

Clave del anunciante (teléfono) — enlaza a su perfil y demás publicaciones.

cachedPhotosinteger

Cuántas fotos propias servimos.

summarystring

Resumen en lenguaje natural, para agentes.

modificationTimestampstring date-time
firstSeenAtstring date-time
lastSeenAtstring date-time

Example response

{
  "listingKey": "fb:1664330911533509",
  "listPriceCurrency": "MXN",
  "provenance": {
    "source": "facebook-marketplace",
    "validations": [
      "schema-ok",
      "geocode-ok",
      "not-demand",
      "not-commercial"
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.