Ir para o conteúdo principal
Piloterr
Voltar à biblioteca

API Centris Search

Pesquise anúncios Centris por cidade ou URL de resultados, em inglês ou francês.

Ativo1 crédito = 1 requisiçãoGET/v2/centris/search

Visão Geral do Endpoint

Documentação detalhada, preços e exemplos de uso.

Visão geralLink to Visão geral

Pesquisa anúncios residenciais no Centris.ca. Um local como montreal, ou um URL de resultados em inglês ou francês, devolve { results, pagination } com o preço pedido, a etiqueta impressa, quartos, casas de banho e a rua quando o cartão os mostra.

price é o preço pedido em CAD. price_display é o texto impresso, por exemplo $568,000.

Início rápidoLink to Início 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

A página 1 e a página 2 de Montreal devolvem identificadores diferentes. Envie results[].url para /v2/centris/property.

ParâmetrosLink to Parâmetros

Parâmetro Tipo Obrigatório Placeholder Exemplo
query string sim montreal montreal
page integer não 2 2
language string não en fr

query é um local ou um URL de resultados completo.

montreal com language=en chama https://www.centris.ca/en/properties~for-sale~montreal. montreal com language=fr chama https://www.centris.ca/fr/propriete~a-vendre~montreal. https://www.centris.ca/en/properties~for-sale~montreal mantém o caminho em inglês e os filtros já presentes. https://www.centris.ca/fr/propriete~a-vendre~montreal mantém o caminho em francês. Um URL completo mantém o idioma do caminho.

page começa em 1. 2 pede os 20 anúncios seguintes. Se page ficar em 1, um valor page já presente no URL é mantido.

language é en (predefinição) ou fr. Aplica-se quando query é um local.

Campos da respostaLink to Campos da resposta

Campo Tipo Descrição
results[].id string Identificador Centris
results[].url string URL para /v2/centris/property
results[].address string ou null Rua
results[].price number ou null Preço pedido em CAD
results[].price_display string ou null Etiqueta do preço
results[].bedrooms number ou null Quartos
results[].bathrooms number ou null Casas de banho
pagination.next string ou null URL da página seguinte, ou null na última página

Casos de usoLink to Casos de uso

  • Percorrer a oferta de Montreal ou Laval
  • Alimentar uma ferramenta imobiliária no Quebec
  • Escolher um id antes de Property

Códigos de erroLink to Códigos de erro

Código Significado
400 Consulta vazia, domínio fora de centris.ca, página inválida, ou um idioma diferente de en ou fr
401 Falta a chave API
404 A página não tem cartões
500 A obtenção falhou

Endpoints relacionadosLink to Endpoints relacionados

Centris Imóvel

APIs Relacionadas

Expanda suas capacidades de dados com essas ferramentas complementares.

Pronto para começar?

Sua API de web scraping está a um clique. Comece com +500 créditos, sem infraestrutura para configurar, sem proxies para gerenciar e sem cartão de crédito necessário.

  • +500 créditos
  • Sem cartão de crédito
  • Todos os endpoints incluídos