Saltar al contenido principal
Piloterr
Volver a la biblioteca

API de Centris Search

Busque anuncios Centris por ciudad o URL de resultados, en inglés o francés.

Activo1 crédito = 1 solicitudGET/v2/centris/search

Resumen del Endpoint

Documentación detallada, precios y ejemplos de uso.

DescripciónLink to Descripción

Busca anuncios residenciales en Centris.ca. Un lugar como montreal, o una URL de resultados en inglés o francés, devuelve { results, pagination } con el precio pedido, la etiqueta impresa, habitaciones, baños y la calle cuando la ficha los muestra.

price es el precio pedido en CAD. price_display es el texto impreso, por ejemplo $568,000.

Inicio rápidoLink to Inicio rápido

GET https://api.piloterr.com/v2/centris/search?query=montreal&language=en
GET https://api.piloterr.com/v2/centris/search?query=montreal&language=fr&page=2
GET https://api.piloterr.com/v2/centris/search?query=https://www.centris.ca/en/properties~for-sale~montreal
GET https://api.piloterr.com/v2/centris/search?query=https://www.centris.ca/fr/propriete~a-vendre~montreal&page=2

La página 1 y la página 2 de Montreal devuelven identificadores distintos. Envíe results[].url a /v2/centris/property.

ParámetrosLink to Parámetros

Parámetro Tipo Obligatorio Placeholder Ejemplo
query string sí montreal montreal
page integer no 2 2
language string no en fr

query es un lugar o una URL de resultados completa.

montreal con language=en llama a https://www.centris.ca/en/properties~for-sale~montreal. montreal con language=fr llama a https://www.centris.ca/fr/propriete~a-vendre~montreal. https://www.centris.ca/en/properties~for-sale~montreal conserva la ruta en inglés y los filtros que ya trae. https://www.centris.ca/fr/propriete~a-vendre~montreal conserva la ruta en francés. Una URL completa conserva el idioma de su ruta.

page empieza en 1. 2 pide los 20 anuncios siguientes. Si page se queda en 1, se conserva un valor page que ya esté en la URL.

language es en (predeterminado) o fr. Se usa cuando query es un lugar.

Campos de la respuestaLink to Campos de la respuesta

Campo Tipo Descripción
results[].id string Identificador Centris
results[].url string URL para /v2/centris/property
results[].address string o null Calle
results[].price number o null Precio pedido en CAD
results[].price_display string o null Etiqueta del precio
results[].bedrooms number o null Habitaciones
results[].bathrooms number o null Baños
pagination.next string o null URL de la página siguiente, o null en la última página

Casos de usoLink to Casos de uso

  • Recorrer la oferta de Montreal o Laval
  • Alimentar una herramienta inmobiliaria en Quebec
  • Elegir un id antes de Property

Códigos de errorLink to Códigos de error

Código Significado
400 Consulta vacía, dominio distinto de centris.ca, página no válida, o un idioma distinto de en o fr
401 Falta la clave API
404 La página no tiene fichas
500 Falló la obtención

Endpoints relacionadosLink to Endpoints relacionados

Centris Inmueble

APIs relacionadas

Amplía tus capacidades de datos con estas herramientas complementarias.

¿Listo para empezar?

Tu API de web scraping está a un clic. Comienza con +500 créditos, sin infraestructura que configurar, sin proxies que gestionar y sin necesidad de tarjeta de crédito.

  • +500 créditos
  • Sin tarjeta de crédito
  • Todos los endpoints incluidos