Viva Real Search
Search Viva Real by city and operation, sale or rent. Page with pagina. Development cards and 'from' prices are left out.
Credit cost: 1 credit per call
Authentification
ApiKeyAuth Your API key. Include it in the x-api-key header for every request.
In: header
Paramètres de requête
City, City plus UF, or a Viva Real search URL.
Examples:
São PauloRio de Janeiro, RJhttps://www.vivareal.com.br/venda/sp/sao-paulo/A listing URL returns 400.
Sale or rent when query is a city.
Examples:
salerentAliases: venda, aluguel, buy. Default sale. A search URL keeps its own path.
"sale"Optional type when query is a city.
Examples:
apartmenthouselandEmpty means every type.
Page from 1. Placeholder 2. Viva Real receives this as pagina=2. Page 1 and page 2 return different listings. A few featured ids can repeat. Most ids on page 2 are new.
Corps de la réponse
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/vivareal/search?query=string"{ "results": [ { "id": "2910482320", "url": "https://www.vivareal.com.br/imovel/apartamento-4-quartos-tatuape-zona-leste-sao-paulo-com-garagem-225m2-venda-RS4250000-id-2910482320/", "area": 225, "city": "São Paulo", "iptu": 1293, "price": 4250000, "title": "Apartamento para comprar com 225 m², 4 quartos, 5 banheiros, 4 vagas em Chácara Califórnia, São Paulo", "address": "Rua Antônio de Lucena, Chácara Califórnia, São Paulo - SP", "bedrooms": 4, "currency": "BRL", "bathrooms": 5, "image_url": "https://resizedimgs.vivareal.com/img/vr-listing/f343296aa94fef7c6d452a62715150c6/apartamento-com-4-quartos-a-venda-225m-no-chacara-california-sao-paulo.webp?action=fit-in&dimension=614x297", "operation": "sale", "state_code": "SP", "condominium": 3072, "neighborhood": "Chácara Califórnia", "price_display": "R$ 4.250.000", "property_type": "apartment", "parking_spaces": 4 } ], "pagination": { "next": "https://www.vivareal.com.br/venda/sp/sao-paulo/?onde=%2CS%C3%A3o+Paulo%2CS%C3%A3o+Paulo%2C%2C%2C%2C%2Ccity%2CBR%3ESao+Paulo%3ENULL%3ESao+Paulo%2C-23.555771%2C-46.639557%2C&pagina=2", "page": 1, "per_page": 30, "total_pages": 27853, "total_results": 835576 }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}