Ir para o conteúdo principal
Piloterr
Voltar à biblioteca

API Centris Property

Leia um imóvel Centris a partir do URL ou do id. Obtém preço, morada, divisões e agente.

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

Visão Geral do Endpoint

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

Visão geralLink to Visão geral

Obtém um anúncio Centris.ca a partir do URL em inglês ou francês. A resposta é um objeto plano: preço pedido, morada, quartos, casas de banho, características, corretor, impostos e fotos. id coincide com o cartão da pesquisa.

price é o preço pedido em CAD. price_display é a etiqueta impressa.

Início rápidoLink to Início rápido

GET https://api.piloterr.com/v2/centris/property?query=https://www.centris.ca/en/condos~for-sale~montreal-le-sud-ouest/17796540
GET https://api.piloterr.com/v2/centris/property?query=https://www.centris.ca/fr/condo~a-vendre~montreal-villeray-saint-michel-parc-extension/17926206

A primeira chamada é o condomínio 17796540 em 2365, Rue Saint-Patrick, Montréal (Le Sud-Ouest). A segunda é um URL francês de Montreal. O identificador é o número no fim do caminho. Um id isolado devolve 400.

ParâmetrosLink to Parâmetros

Parâmetro Tipo Obrigatório Placeholder Exemplo
query string sim https://www.centris.ca/en/condos~for-sale~montreal-le-sud-ouest/17796540 https://www.centris.ca/fr/condo~a-vendre~montreal-villeray-saint-michel-parc-extension/17926206

query é o URL completo do anúncio.

https://www.centris.ca/en/condos~for-sale~montreal-le-sud-ouest/17796540 é um anúncio em inglês em Montreal. O id é 17796540. https://www.centris.ca/fr/condo~a-vendre~montreal-villeray-saint-michel-parc-extension/17926206 é um anúncio em francês em Montreal. O id é 17926206. Um sufixo /photos volta à ficha. Passe o url de /v2/centris/search.

Campos da respostaLink to Campos da resposta

Campo Tipo Descrição
id string O mesmo id do cartão da pesquisa
address string ou null Morada completa
price number ou null Preço pedido em CAD
bedrooms number ou null Quartos
bathrooms number ou null Casas de banho
characteristics array Linhas da ficha
broker object ou null Nome, agência e telefones
images array Fotos deste anúncio

Casos de usoLink to Casos de uso

  • Abrir a ficha de um cartão de pesquisa
  • Tirar morada e preço para comparáveis
  • Registar o agente do anúncio

Códigos de erroLink to Códigos de erro

Código Significado
400 URL em falta, domínio fora de centris.ca, id isolado, ou um URL de resultados enviado a property
401 Falta a chave API
404 Não foi possível ler o anúncio
500 A obtenção falhou

Endpoints relacionadosLink to Endpoints relacionados

Centris Pesquisa

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