Viva Real Ad
Viva Real Ad

Viva Real Ad API

Fetch a Viva Real Brazil listing by URL or ID and get price, area, condo fee, IPTU, images, and geo coordinates as JSON.
Private access
Public access
45
k requests
16
votes
▶ Try for freeGet it customized
50 free credits, no credit card required
Under maintenance
Access to this API endpoint is temporary suspended due to technical maintenance, please come back later.
Browse alternatives
Request accessGet it customized
Access to this API endpoint is limited, submit a request to gain access

Header

x-api-key required

string

This parameter defines the Piloterr private key to use for authentification.

Parameters

query

string

Viva Real listing URL or numeric listing ID.

Sign up now and enjoy 50 free API credits + full access to our premium features and tools.
Request access to this private endpoint and unlock 50 free API requests, along with unrestricted use of our public API endpoints and in-house proxy pool.
This endpoint is under maintenance
Access to this API endpoint is temporary suspended due to technical maintenance, please come back later.
Browse alternatives

Get Real-Time Viva Real Data via API, No Infrastructure Required

Viva Real applies Cloudflare bot protection on every listing page. Piloterr handles the bypass, so one GET request with a listing URL or ID returns the full property sheet: price in BRL, condo fee, IPTU tax, area in m², floor number, year built, amenities, pets and furnishing flags for rental listings, agent contact phone, geo coordinates, and all listing photos. If the listing no longer exists, the endpoint returns no result without charging a credit.

Application Scenarios for the Viva Real Ad API

  1. Proptech detail page: Pull the complete property sheet for a specific Viva Real listing to feed a comparison platform with live price, fee, floor, and amenity data in real time.
  2. Neighborhood liveability index: Extract floor, amenities, and geo coordinates for hundreds of listings to build a structured dataset for neighborhood quality scoring.
  3. Price change monitoring: Track price and condo fee changes on specific listings over time to identify motivated sellers or landlords before they reduce the ask on the portal.
  4. Rental lead qualification: Check the accepts_pets and is_furnished flags for a rental listing before contacting the landlord, reducing friction in the tenant matching process.
  5. Investment pipeline data: Feed a valuation model with full property attributes from Viva Real to automate estimate generation across a Brazilian real estate investment portfolio.

Why Use Piloterr Instead of Building Your Own Scraper

  1. No anti-bot management: Viva Real blocks automated requests with Cloudflare. Piloterr handles the bypass transparently.
  2. Real-time data: Every call returns live data from Viva Real, not a cached snapshot.
  3. Structured JSON: No HTML parsing, no fragile selectors. The response schema is stable and documented.
  4. No infrastructure costs: No proxy pool to buy, no headless browser cluster to maintain. Pay only for successful requests.

One Piloterr subscription gives access to the full public API catalog. See the API documentation for authentication details and parameter reference.

Start Collecting Viva Real Data Today

Sign up for a free trial and get 50 free credits with no credit card required. See pricing to find the plan that fits your volume.

GET
POST
api.piloterr.com
/v2/viva-real/ad
Response
{"id": "2948312784", "transaction_type": "venda", "property_type": "Apartamento", "price": 895000, "condo_fee": 1680, "iptu": 182, "price_per_sqm": 12786, "area_total": 70, "area_useful": 65, "bedrooms": 2, "bathrooms": 2, "parking_spaces": 1, "suites": 1, "amenities": ["Piscina", "Academia", "Salão de festas", "Portaria 24h"], "floor": 6, "total_floors": 12, "year_built": 2008, "accepts_pets": false, "is_furnished": false, "neighborhood": "Moema", "city": "São Paulo", "state": "SP", "lat": -23.6012, "lon": -46.6644, "agency_name": "Imobiliária Lello", "agent_phone": "+55 11 94321-8765", "images": ["https://resizedimgs.vivareal.com/fit-in/1280x720/vr.images.sp/2948312784_01.jpg"]}
Premium
$49/mo
Free trial (50 credits once)
18,000 credits
1 credit = standard API request
2 credits = JS rendering API request
3 credits = WebUnlocker API request
7 requests per second
Clean & parsed data
Email support
Premium+
$99/mo
Free trial (50 credits once)
40,000 credits
1 credit = standard API request
2 credits = JS rendering API request
3 credits = WebUnlocker API request
10 requests per second
Clean & parsed data
Email support
Startup
$249/mo
Free trial (50 credits once)
110,000 credits
1 credit = standard API request
2 credits = JS rendering API request
3 credits = WebUnlocker API request
15 requests per second
Clean & parsed data
Email & chat support
Startup+
$499/mo
Free trial (50 credits once)
230,000 credits
1 credit = standard API request
2 credits = JS rendering API request
3 credits = WebUnlocker API request
20 credits per second
Clean & parsed data
Chat & Email support
Enterprise+
$999/mo
Free trial (50 credits once)
530,000 credits
1 credit = standard API request
2 credits = JS rendering API request
3 credits = WebUnlocker API request
30 credits per second
Clean & parsed data
Account manager
Custom
+$2,000/mo
Tailored for your needs
Custom credits count
Custom requests rate
Clean & parsed data
Account manager
Premium
45€/mo
Free trial (50 credits once)
18,000 credits
1 credit = standard API request
2 credits = JS rendering API request
3 credits = WebUnlocker API request
7 requests per second
Clean & parsed data
Email support
Premium+
89€/mo
Free trial (50 credits once)
40,000 credits
1 credit = standard API request
2 credits = JS rendering API request
3 credits = WebUnlocker API request
10 requests per second
Clean & parsed data
Email support
Startup
229€/mo
Free trial (50 credits once)
110,000 credits
1 credit = standard API request
2 credits = JS rendering API request
3 credits = WebUnlocker API request
15 requests per second
Clean & parsed data
Email & chat support
Startup+
459€/mo
Free trial (50 credits once)
230,000 credits
1 credit = standard API request
2 credits = JS rendering API request
3 credits = WebUnlocker API request
20 requests per second
Clean & parsed data
Chat & Email support
Enterprise+
919€/mo
Free trial (50 credits once)
530,000 credits
1 credit = standard API request
2 credits = JS rendering API request
3 credits = WebUnlocker API request
30 requests per second
Clean & parsed data
Account manager
Custom
$2,000/mo
Tailored for your needs
Unlimited requests
Custom requests rate
Clean & parsed data
Account manager

Get 50 free credits when signing-up

Use Piloterr's private proxy pool

How do credits work? Check our documentation page
Accepted payment methods:
Free plan
$0/mo
1 credit = 1 video
10 credits once
1 request per second
2 users
Priority support
Startup
$299/mo
1 credit = 1 video
2,000 credits per month
3 requests per second
5 users
Priority support
Enterprise
$999/mo
1 credit = 1 video
10,000 credits per month
5 requests per second
5 users
Account manager
Get 10% off when buying annual subscriptions, contact us to get started.
Accepted payment methods:
Starter
$50.00
$1.00 = 1,000 requests
50,000 requests
1 request = 1 search
1 year credits roll-over
Real-time results
Custom query location
Email support
Premium
$1,250.00
$0.50 = 1,000 requests
2,500,000 requests
1 request = 1 search
1 year credits roll-over
Real-time results
Custom query location
Email support
Ultimate
$3,750.00
$0.30 = 1,000 requests
12,500,000 requests
1 request = 1 search
1 year credits roll-over
Real-time results
Custom query location
Email support
Get 10% off when buying annual subscriptions, contact us to get started.
Accepted payment methods:

Get 50 free credits now!

Sign up now and enjoy 50 free API credits + full access to our premium endpoints!

"They know what they're doing and they know how to provide the best tools to helps startups to grow faster. Their solution is a no-brainer for every tech-marketing team. Plus, the best support I have ever seen in the SaaS industry..."

Polar Analytics

Paul-François, Lead Growth

"5* tool, reliable and efficient - works perfectly to collect Google data. Bonus, the support is really responsive."

Corentin Robert

Growth

"Piloterr raises the game of automation in Growth Hacking with innovative integrations such as LinkedIn Profile info and Crunchbase, opening up new perspectives."

Kévin Zimmermann

Growth

Frequently asked questions

Everything you need to know about our products & services.

Are Piloterr solutions secured and GDPR compliant?

We have implemented industry-standard security measures to ensure the safety of your data. Our platform uses SSL encryption to protect your API requests. We're also fully aligned with GDPR and CCPA compliance standards.

How frequently are new APIs added, can I suggest new ones?

We are always adding new APIs to our platform based on customer demand and emerging technologies. If you have a specific API you would like us to add, please contact our support team and let us know.

Can I upgrade, downgrade and cancel anytime?

Active plans can be upgraded, downgraded and cancelled anytime. Changes are immediate. When changing plan, the remaining unused requests of your current plan are added from your next invoice amount.

What is your cancellation policy?

We understand that things change. You can cancel your plan at any time and we’ll refund you the difference that you already paid (annual subscriptions only and under the terms described here).

Do my unused credits rollover to the next month?

Your monthly subscription restarts with your monthly allowance of successful search credits on the first day of your billing cycle's subscription.

Do you offer technical support for users?

Yes! We are always happy to help users to be able to use our API! You can chat us and we'll try and get back to you within a single business day.

How credits API calls are calculated?

Only successful requests are counted towards your monthly searches. Errored and failed searches are not. For the credit system, please consult our documentation.

Can I request custom API endpoints?

Of course! We are always expanding our code and building new APIs for different search engines. You can create a feature request on our Roadmap. We aren't able to build APIs for every websites for a variety of reasons but we do always make additions where they are needed and able to be done.