InmoData
Entrar
get/public/v2/traditionalAPI pública

Construye búsquedas, comparadores y análisis sobre inventario vigente.

Explorar mercado tradicional

Consulta oferta deduplicada de venta y arriendo con filtros geográficos, físicos y comerciales.

Los valores corresponden a publicaciones de mercado y no equivalen a precios de cierre notarial.

AudienciaIntegradores y productos externos
AutenticaciónAPI key
EstabilidadContrato público versionado

Cuándo usarlo

Buscador de inmuebles
Análisis de oferta
Comparables de mercado

Comportamiento

Listado paginado de avisos deduplicados del mercado tradicional (venta, arriendo y variantes).

Autenticación (obligatoria)

  • X-Api-Key: <tu_api_key> o
  • Authorization: Bearer <tu_api_key>

Parámetros principales

ParámetroUso
qBúsqueda por texto en título o dirección (coincidencia parcial).
limit / offsetPaginación. Si omites limit, el servidor usa un límite alto por defecto (ver documentación del query).
sw_lat, sw_lng, ne_lat, ne_lngLas cuatro acotan un área rectangular en el mapa. Si envías una esquina, deben ir las cuatro; si no envías ninguna, no hay filtro por mapa.
Otros query paramsFiltros opcionales por campos del aviso (city, business_type, normalized_type, etc.). Ver esquema TraditionalMarketListFilters debajo.

Respuesta

Array de objetos TraditionalMarketRow. Orden típico: avisos más recientes primero.

API key requerida

Envía tu clave en X-Api-Key o Authorization: Bearer. No expongas la credencial en código cliente público.

Parámetros de la solicitud

Campos definidos por el contrato OpenAPI.

limit
query·anyOf

Máximo de filas a devolver. Si se omite, el servidor aplica un límite alto por defecto (actualmente 5000).

offset
query·integer

Desplazamiento para paginación (filas a saltar).

q
query·anyOf

Texto libre: busca coincidencia parcial en el **título** del aviso o en la **dirección**. No es un filtro de igualdad exacta sobre una columna concreta.

sw_lat
query·anyOf

Esquina suroeste del área de mapa: latitud (debe ir con `sw_lng`, `ne_lat`, `ne_lng`).

sw_lng
query·anyOf

Esquina suroeste del área de mapa: longitud.

ne_lat
query·anyOf

Esquina noreste del área de mapa: latitud.

ne_lng
query·anyOf

Esquina noreste del área de mapa: longitud.

listing_id
query·anyOf

Sin descripción adicional.

property_id
query·anyOf

Sin descripción adicional.

source_system
query·anyOf

Sin descripción adicional.

title
query·anyOf

Sin descripción adicional.

property_type
query·anyOf

Sin descripción adicional.

normalized_type
query·anyOf

Sin descripción adicional.

business_type
query·anyOf

Sin descripción adicional.

area_m2
query·anyOf

Sin descripción adicional.

rooms
query·anyOf

Sin descripción adicional.

bathrooms
query·anyOf

Sin descripción adicional.

garages
query·anyOf

Sin descripción adicional.

antiquity
query·anyOf

Sin descripción adicional.

estrato
query·anyOf

Sin descripción adicional.

sale_price
query·anyOf

Sin descripción adicional.

rent_price
query·anyOf

Sin descripción adicional.

admin_price
query·anyOf

Sin descripción adicional.

sale_price_per_m2
query·anyOf

Sin descripción adicional.

rent_price_per_m2
query·anyOf

Sin descripción adicional.

neighborhood
query·anyOf

Sin descripción adicional.

address
query·anyOf

Sin descripción adicional.

latitude
query·anyOf

Sin descripción adicional.

longitude
query·anyOf

Sin descripción adicional.

h3_res7
query·anyOf

Sin descripción adicional.

h3_res8
query·anyOf

Sin descripción adicional.

h3_res9
query·anyOf

Sin descripción adicional.

geo_hash
query·anyOf

Sin descripción adicional.

city
query·anyOf

Sin descripción adicional.

country
query·anyOf

Sin descripción adicional.

country_code
query·anyOf

Sin descripción adicional.

description
query·anyOf

Sin descripción adicional.

scraped_at
query·anyOf

Sin descripción adicional.

first_scraped_at
query·anyOf

Sin descripción adicional.

days_on_market
query·anyOf

Sin descripción adicional.

total_scrape_days
query·anyOf

Sin descripción adicional.

days_since_last_scrape
query·anyOf

Sin descripción adicional.

is_stale
query·anyOf

Sin descripción adicional.

has_price_reduction
query·anyOf

Sin descripción adicional.

price_change_total_pct
query·anyOf

Sin descripción adicional.

quality_score
query·anyOf

Sin descripción adicional.

publisher_name
query·anyOf

Sin descripción adicional.

publisher_phone
query·anyOf

Sin descripción adicional.

url
query·anyOf

Sin descripción adicional.

fingerprint_id
query·anyOf

Sin descripción adicional.

year
query·anyOf

Sin descripción adicional.

month
query·anyOf

Sin descripción adicional.

day
query·anyOf

Sin descripción adicional.

est_airbnb_income
query·anyOf

Sin descripción adicional.

est_traditional_rent
query·anyOf

Sin descripción adicional.

airbnb_vs_traditional_multiplier
query·anyOf

Sin descripción adicional.

investment_recommendation
query·anyOf

Sin descripción adicional.

airbnb_comparables_count
query·anyOf

Sin descripción adicional.

traditional_rent_comparables_count
query·anyOf

Sin descripción adicional.

est_airbnb_yield_pct
query·anyOf

Sin descripción adicional.

est_traditional_yield_pct
query·anyOf

Sin descripción adicional.

est_airbnb_payback_years
query·anyOf

Sin descripción adicional.

est_traditional_payback_years
query·anyOf

Sin descripción adicional.

zone_avg_sale_price_per_m2
query·anyOf

Sin descripción adicional.

zone_sale_comparables_count
query·anyOf

Sin descripción adicional.

sale_price_vs_zone_avg_pct
query·anyOf

Sin descripción adicional.

sale_price_valuation_label
query·anyOf

Sin descripción adicional.

zone_avg_rent_price_per_m2
query·anyOf

Sin descripción adicional.

zone_rent_comparables_count
query·anyOf

Sin descripción adicional.

rent_price_vs_zone_avg_pct
query·anyOf

Sin descripción adicional.

rent_price_valuation_label
query·anyOf

Sin descripción adicional.

sale_price_vs_30d_ago_pct
query·anyOf

Sin descripción adicional.

rent_price_vs_30d_ago_pct
query·anyOf

Sin descripción adicional.

sale_trend_30d
query·anyOf

Sin descripción adicional.

gross_cap_rate_annual_pct
query·anyOf

Sin descripción adicional.

refreshed_at
query·anyOf

Sin descripción adicional.

synced_at
query·anyOf

Sin descripción adicional.

transport_system
query·anyOf

Sin descripción adicional.

max_transport_distance_m
query·anyOf

Sin descripción adicional.

min_transport_within_500m
query·anyOf

Sin descripción adicional.

min_transport_within_1km
query·anyOf

Sin descripción adicional.

min_transport_within_2km
query·anyOf

Sin descripción adicional.

max_metro_distance_m
query·anyOf

Sin descripción adicional.

max_mio_distance_m
query·anyOf

Sin descripción adicional.

max_transmilenio_distance_m
query·anyOf

Sin descripción adicional.

retail_system
query·anyOf

Sin descripción adicional.

max_retail_distance_m
query·anyOf

Sin descripción adicional.

min_retail_within_500m
query·anyOf

Sin descripción adicional.

min_retail_within_1km
query·anyOf

Sin descripción adicional.

min_retail_within_2km
query·anyOf

Sin descripción adicional.

max_shopping_center_distance_m
query·anyOf

Sin descripción adicional.

max_water_body_distance_m
query·anyOf

Sin descripción adicional.

min_water_bodies_within_500m
query·anyOf

Sin descripción adicional.

min_water_bodies_within_1km
query·anyOf

Sin descripción adicional.

max_park_distance_m
query·anyOf

Sin descripción adicional.

min_parks_within_500m
query·anyOf

Sin descripción adicional.

min_parks_within_1km
query·anyOf

Sin descripción adicional.

min_parks_within_2km
query·anyOf

Sin descripción adicional.

block_stratum
query·anyOf

Sin descripción adicional.

all_publishers_contains_json
query·anyOf

Sin descripción adicional.

all_urls_contains_json
query·anyOf

Sin descripción adicional.

all_sources_contains_json
query·anyOf

Sin descripción adicional.

property_images_contains_json
query·anyOf

Sin descripción adicional.

Respuestas

Estados públicos del contrato y estructura de cada respuesta JSON.

200Successful Response
[
  {
    "address": "string",
    "admin_price": 42,
    "airbnb_comparables_count": 42,
    "airbnb_vs_traditional_multiplier": 42,
    "all_publishers": [
      {}
    ],
    "all_sources": [
      {}
    ],
    "all_urls": [
      {}
    ],
    "antiquity": 42,
    "area_m2": 42,
    "bathrooms": 42,
    "business_type": "string",
    "city": "string",
    "country": "string",
    "country_code": "string",
    "day": 42,
    "days_on_market": 42,
    "days_since_last_scrape": 42,
    "description": "string",
    "est_airbnb_income": 42,
    "est_airbnb_payback_years": 42,
    "est_airbnb_yield_pct": 42,
    "est_traditional_payback_years": 42,
    "est_traditional_rent": 42,
    "est_traditional_yield_pct": 42,
    "estrato": 42,
    "fingerprint_id": "string",
    "first_scraped_at": "2024-01-01T00:00:00Z",
    "garages": 42,
    "geo_hash": "string",
    "geo_relocation": {},
    "gross_cap_rate_annual_pct": 42,
    "h3_res7": "string",
    "h3_res8": "string",
    "h3_res9": "string",
    "has_price_reduction": true,
    "investment_recommendation": "string",
    "is_stale": true,
    "latitude": 42,
    "listing_id": "string",
    "locality": "string",
    "location_quality": {},
    "longitude": 42,
    "market_liquidity": {},
    "month": 42,
    "neighborhood": "string",
    "net_admin_yield_annual_pct": 42,
    "normalized_type": "string",
    "price_change_total_pct": 42,
    "property_id": "string",
    "property_images": [
      {}
    ],
    "property_type": "string",
    "publisher_name": "string",
    "publisher_phone": "string",
    "quality_score": 42,
    "recommendation_confidence": "string",
    "refreshed_at": "2024-01-01T00:00:00Z",
    "rent_price": 42,
    "rent_price_per_m2": 42,
    "rent_price_valuation_label": "string",
    "rent_price_vs_30d_ago_pct": 42,
    "rent_price_vs_zone_avg_pct": 42,
    "rooms": 42,
    "sale_price": 42,
    "sale_price_per_m2": 42,
    "sale_price_valuation_label": "string",
    "sale_price_vs_30d_ago_pct": 42,
    "sale_price_vs_zone_avg_pct": 42,
    "sale_trend_30d": "string",
    "scraped_at": "2024-01-01T00:00:00Z",
    "source_system": "string",
    "synced_at": "2024-01-01T00:00:00Z",
    "title": "string",
    "total_scrape_days": 42,
    "traditional_rent_comparables_count": 42,
    "urban_education": {},
    "urban_environment": {},
    "urban_retail": {},
    "urban_stratification": {},
    "urban_transport": {},
    "url": "string",
    "year": 42,
    "zone_avg_rent_price_per_m2": 42,
    "zone_avg_sale_price_per_m2": 42,
    "zone_median_rent_price_per_m2": 42,
    "zone_median_sale_price_per_m2": 42,
    "zone_p25_rent_price_per_m2": 42,
    "zone_p25_sale_price_per_m2": 42,
    "zone_p75_rent_price_per_m2": 42,
    "zone_p75_sale_price_per_m2": 42,
    "zone_rent_comparables_count": 42,
    "zone_sale_comparables_count": 42
  }
]
401Falta cabecera de API key o la clave no existe / está revocada.
422Validation Error
{
  "detail": [
    {
      "ctx": {},
      "input": {},
      "loc": [],
      "msg": {},
      "type": {}
    }
  ]
}
502No se pudo consultar la fuente de datos en este momento.