InmoData Logo
EntrarRegistrarse
get/public/v1/traditional

Listar avisos del mercado tradicional

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

Descripción

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.

Seguridad

  • ApiKeyHeader
  • ApiKeyBearer

Referencia de parámetros

Definición exacta según OpenAPI (complementa la descripción anterior).

ParámetroDescripción
limitANYOFquery
Máximo de filas a devolver. Si se omite, el servidor aplica un límite alto por defecto (actualmente 5000).
offsetINTEGERquery
Desplazamiento para paginación (filas a saltar).
qANYOFquery
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_latANYOFquery
Esquina suroeste del área de mapa: latitud (debe ir con `sw_lng`, `ne_lat`, `ne_lng`).
sw_lngANYOFquery
Esquina suroeste del área de mapa: longitud.
ne_latANYOFquery
Esquina noreste del área de mapa: latitud.
ne_lngANYOFquery
Esquina noreste del área de mapa: longitud.
listing_idANYOFquery
—
property_idANYOFquery
—
source_systemANYOFquery
—
titleANYOFquery
—
property_typeANYOFquery
—
normalized_typeANYOFquery
—
business_typeANYOFquery
—
area_m2ANYOFquery
—
roomsANYOFquery
—
bathroomsANYOFquery
—
garagesANYOFquery
—
antiquityANYOFquery
—
estratoANYOFquery
—
sale_priceANYOFquery
—
rent_priceANYOFquery
—
admin_priceANYOFquery
—
sale_price_per_m2ANYOFquery
—
rent_price_per_m2ANYOFquery
—
neighborhoodANYOFquery
—
addressANYOFquery
—
latitudeANYOFquery
—
longitudeANYOFquery
—
h3_res7ANYOFquery
—
h3_res8ANYOFquery
—
h3_res9ANYOFquery
—
geo_hashANYOFquery
—
cityANYOFquery
—
countryANYOFquery
—
descriptionANYOFquery
—
scraped_atANYOFquery
—
first_scraped_atANYOFquery
—
days_on_marketANYOFquery
—
total_scrape_daysANYOFquery
—
days_since_last_scrapeANYOFquery
—
is_staleANYOFquery
—
has_price_reductionANYOFquery
—
price_change_total_pctANYOFquery
—
quality_scoreANYOFquery
—
publisher_nameANYOFquery
—
publisher_phoneANYOFquery
—
urlANYOFquery
—
fingerprint_idANYOFquery
—
yearANYOFquery
—
monthANYOFquery
—
dayANYOFquery
—
est_airbnb_incomeANYOFquery
—
est_traditional_rentANYOFquery
—
airbnb_vs_traditional_multiplierANYOFquery
—
investment_recommendationANYOFquery
—
airbnb_comparables_countANYOFquery
—
traditional_rent_comparables_countANYOFquery
—
est_airbnb_yield_pctANYOFquery
—
est_traditional_yield_pctANYOFquery
—
est_airbnb_payback_yearsANYOFquery
—
est_traditional_payback_yearsANYOFquery
—
zone_avg_sale_price_per_m2ANYOFquery
—
zone_sale_comparables_countANYOFquery
—
sale_price_vs_zone_avg_pctANYOFquery
—
sale_price_valuation_labelANYOFquery
—
zone_avg_rent_price_per_m2ANYOFquery
—
zone_rent_comparables_countANYOFquery
—
rent_price_vs_zone_avg_pctANYOFquery
—
rent_price_valuation_labelANYOFquery
—
sale_price_vs_30d_ago_pctANYOFquery
—
rent_price_vs_30d_ago_pctANYOFquery
—
sale_trend_30dANYOFquery
—
gross_cap_rate_annual_pctANYOFquery
—
refreshed_atANYOFquery
—
synced_atANYOFquery
—
all_publishers_contains_jsonANYOFquery
—
all_urls_contains_jsonANYOFquery
—
all_sources_contains_jsonANYOFquery
—
property_images_contains_jsonANYOFquery
—

Respuestas

200Successful Response

application/json

[
  {
    "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",
    "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",
    "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",
    "longitude": 42,
    "month": 42,
    "neighborhood": "string",
    "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,
    "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,
    "url": "string",
    "year": 42,
    "zone_avg_rent_price_per_m2": 42,
    "zone_avg_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

application/json

{
  "detail": [
    {
      "ctx": {},
      "input": {},
      "loc": [],
      "msg": {},
      "type": {}
    }
  ]
}
502No se pudo consultar la fuente de datos en este momento.

Ejemplo de solicitud

Base URL y código de ejemplo (sin CORS desde el navegador).

getGET /public/v1/traditional
curl -sS -X GET \
  -H "X-Api-Key: TU_API_KEY" \
  "http://127.0.0.1:8000/public/v1/traditional"

Respuesta en vivo

La petición se envía vía el proxy del servidor Next.