--- title: "VivaReal API: JSON data, 9 endpoints, 1 credit per call" description: "Get VivaReal data as structured JSON with one API key: search, advertiser, advertiser listings and count. Free credits every month." url: https://perceptlayer.com/apis/vivareal --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / VivaReal 1 credit per call 9 endpoints # VivaReal API Get VivaReal data as structured JSON with one API key: search, advertiser, advertiser listings and count. Free credits every month. [Get a free API key](https://perceptlayer.com/signup) Run it below VivaReal GET /v1/vivareal/search?portal=ZAP&business=RENTAL&rows=5&location\_id=BR%3ESao+Paulo%3ENULL%3ESao+Paulo%3EZona+Oeste%3EPinheiros&bedrooms=2&sort=BIGGEST\_PRICE ``` curl "https://api.perceptlayer.com/v1/vivareal/search?portal=ZAP&business=RENTAL&rows=5&location_id=BR%3ESao+Paulo%3ENULL%3ESao+Paulo%3EZona+Oeste%3EPinheiros&bedrooms=2&sort=BIGGEST_PRICE" \ -H "X-API-Key: $API_KEY" ``` cURL 1 credit per successful call Run this call below or from your dashboard to see a live response. Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/vivareal/search?portal=ZAP&business=RENTAL&rows=5&location_id=BR%3ESao+Paulo%3ENULL%3ESao+Paulo%3EZona+Oeste%3EPinheiros&bedrooms=2&sort=BIGGEST_PRICE" \ -H "X-API-Key: $API_KEY" ``` VivaReal ยท 9 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/vivareal/advertiser`](https://perceptlayer.com/apis/vivareal/advertiser) | `advertiser_id` +1 optional | 1 credit | | [GET `/v1/vivareal/advertiser-listings`](https://perceptlayer.com/apis/vivareal/advertiser-listings) | `advertiser_id` +4 optional | 1 credit | | [GET `/v1/vivareal/count`](https://perceptlayer.com/apis/vivareal/count) | none +7 optional | 1 credit | | [GET `/v1/vivareal/listing`](https://perceptlayer.com/apis/vivareal/listing) | `id` +2 optional | 1 credit | | [GET `/v1/vivareal/location-autocomplete`](https://perceptlayer.com/apis/vivareal/location-autocomplete) | `q` +2 optional | 1 credit | | [GET `/v1/vivareal/map-pins`](https://perceptlayer.com/apis/vivareal/map-pins) | none +7 optional | 1 credit | | [GET `/v1/vivareal/parse-filters`](https://perceptlayer.com/apis/vivareal/parse-filters) | `q` +1 optional | 1 credit | | [GET `/v1/vivareal/price-insights`](https://perceptlayer.com/apis/vivareal/price-insights) | `city` `state` `business_type` `unit_type` `latitude` `longitude` `location_id` +2 optional | 1 credit | | [GET `/v1/vivareal/search`](https://perceptlayer.com/apis/vivareal/search) | none +12 optional | 1 credit | Overview ## About the VivaReal API ## What you can get The VivaReal API returns search, advertiser, advertiser listings and count as clean JSON. Each successful call costs one credit, and calls that fail are free. Real estate JSON REST MCP ### More real estate APIs [99acres](https://perceptlayer.com/apis/99acres) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Argenprop](https://perceptlayer.com/apis/argenprop) [Bayut](https://perceptlayer.com/apis/bayut) [Bien'ici](https://perceptlayer.com/apis/bienici) [Boliga](https://perceptlayer.com/apis/boliga) [Booli](https://perceptlayer.com/apis/booli) [Casa.it](https://perceptlayer.com/apis/casa-it) [Centris](https://perceptlayer.com/apis/centris) [Crexi](https://perceptlayer.com/apis/crexi) [Daft.ie](https://perceptlayer.com/apis/daft-ie) [Domain.com.au](https://perceptlayer.com/apis/domain-com-au) Use cases ### Monitor listing prices and new listings `Use the VivaReal API to monitor listing prices and new listings` ### Pull comparables for valuations `Use the VivaReal API to pull comparables for valuations` ### Power alerts and investment analysis `Use the VivaReal API to power alerts and investment analysis` FAQ ## Questions **How much does the VivaReal API cost?** Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale. **What format are responses in?** Every endpoint returns JSON, with no HTML parsing on your side. **Do I need a separate key for VivaReal?** No. One key works for every API in the catalogue. ## Try the VivaReal API with 1,000 free credits No credit card. Failed calls are never billed. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://perceptlayer.com/docs)