# VivaReal API (Brazil) — vivareal.com.br property listings for sale and rent: place lookup, search with every site filter (price, condo fee, bedrooms, bathrooms, parking, area, property type, amenities, 'Ótimo preço' stamp, Festival da Mudança campaign, near metro, rent without guarantor, owner-only, keyword, state / city / neighbourhood / map radius) and sort, new developments (lançamentos), counts per amenity, the full listing (price, condo fee, IPTU, rent total, photos, address and coordinates, advertiser with CRECI, phones and WhatsApp), price statistics per neighbourhood, real-estate agencies with all their listings, condominium buildings, and the directory of property developers (incorporadoras) with each developer's developments — no API key, no account

> Look up Brazilian places by name and get the location ids the search actions accept: cities, neighbourhoods, zones (e.g. Zona Sul) and streets, with coordinates and the site's own sale / rent links.
> ReefAPI engine `vivareal` · 12 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/vivareal/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/vivareal/v1/locations — 1 credit
Look up Brazilian places by name and get the location ids the search actions accept: cities, neighbourhoods, zones (e.g. Zona Sul) and streets, with coordinates and the site's own sale / rent links.

**Parameters:**
- `query` (string, required) — Place name (accents optional).
- `type` (array, optional) — Which kinds of place to return (default all four). [one of: city, neighborhood, zone, street]
- `limit` (integer, optional, default 10) — Matches per place kind (the source's own cap per kind).

**Returns:** results[]{type, name, location_id, street, neighborhood, zone, city, state, state_code, latitude, longitude, sale_url, rent_url, score} + count

**Example request body:**
```json
{
  "query": "Pinheiros"
}
```

### POST https://api.reefapi.com/vivareal/v1/search — 2 credits
Search VivaReal listings for sale or rent in a place (or around a point / inside a map box) with every filter and sort the site offers. 30 listings per page, pages 1-50 (the site's own ceiling of 1,500 results; `total` is the full count). Used (resale / rental) listings; new developments are the `developments` action.

**Parameters:**
- `location` (string, optional) — Where to search: a place name ('Pinheiros, São Paulo', 'Copacabana', 'Curitiba'), a state name or code ('Minas Gerais', 'MG', 'estado de São Paulo' — a bare 'São Paulo' is the city), a location id from the `locations` action ('BR>Sao Paulo>NULL>Sao Paulo>Zona Oeste>Pinheiros'), or a pasted vivareal.com.br search link (its path and query filters are applied). Several places: separate them with ' | '. Leave empty (and no coordinates) for all of Brazil.
- `latitude` (number, optional) — Search around a point instead of a place: latitude (with longitude).
- `longitude` (number, optional) — Longitude of the point.
- `radius_km` (number, optional, default 2) — Radius around latitude / longitude in km (the site's map uses 2).
- `north` (number, optional) — Map box: north latitude (with south, east, west).
- `south` (number, optional) — Map box: south latitude.
- `east` (number, optional) — Map box: east longitude.
- `west` (number, optional) — Map box: west longitude.
- `business` (enum, optional, default "sale") — For sale or for rent (rental, aluguel accepted). [one of: sale, rent]
- `sort` (enum, optional, default "relevance") — Order of results. [one of: relevance, newest, price_asc, price_desc, area_desc, area_asc]
- `page` (integer, optional, default 1) — Result page, 30 listings per page (fixed by the site); the site serves pages 1-50 (the first 1,500 results).
- `property_type` (array, optional) — One or more property types (the site's own list). Several = any of them. [one of: apartment, house, condo_house, country_house, penthouse, flat, kitnet, residential_land, two_story_house, clinic, residential_building, farm, warehouse, commercial_house, commercial_land, store, office, commercial_building, studio, loft, village_house, hotel, commercial_floor, parking_space]
- `bedrooms` (array, optional) — Exact bedroom counts, any of them: 0-4, where 4 means 4 or more (the site's buttons).
- `min_bedrooms` (integer, optional) — At least this many bedrooms (4 = 4 or more).
- `bathrooms` (array, optional) — Exact bathroom counts, any of them: 1-4 (4 = 4 or more).
- `min_bathrooms` (integer, optional) — At least this many bathrooms (4 = 4 or more).
- `parking_spaces` (array, optional) — Exact parking-space counts, any of them: 0-4 (4 = 4 or more).
- `min_parking_spaces` (integer, optional) — At least this many parking spaces (4 = 4 or more).
- `price_min` (number, optional) — Lowest price in BRL (sale price, or monthly rent for business=rent).
- `price_max` (number, optional) — Highest price in BRL (sale price, or monthly rent for business=rent).
- `condo_fee_min` (number, optional) — Lowest monthly condominium fee (condomínio) in BRL.
- `condo_fee_max` (number, optional) — Highest monthly condominium fee (condomínio) in BRL.
- `area_min` (number, optional) — Smallest usable area (área útil) in m².
- `area_max` (number, optional) — Largest usable area (área útil) in m².
- `total_area_min` (number, optional) — Smallest total area (área total) in m².
- `total_area_max` (number, optional) — Largest total area (área total) in m².
- `amenities` (array, optional) — Amenity codes, all of them required (e.g. POOL, GYM, ELEVATOR, PETS_ALLOWED, FURNISHED, BALCONY, AIR_CONDITIONING). The site's Portuguese label ('Piscina') is accepted too. [one of: ACLIVE, ADMINISTRATION, ADULT_POOL, AIR_CONDITIONING, ALARM_SYSTEM, ALUMINUM_WINDOW, AMERICAN_KITCHEN, AQUARIUM, ARGILLOSE, ARMORED_SECURITY_CABIN, ARTESIAN_WELL, BACKGROUND_HOUSE, BACKYARD, BALCONY, BAR, BARBECUE_BALCONY, BARBECUE_GRILL, BARN, BATHROOM_CABINETS, BATHTUB, BEAUTY_CENTER, BEAUTY_ROOM, BEDROOM_WARDROBE, BICYCLES_PLACE, BLINDEX_BOX, BUILTIN_WARDROBE, BURNT_CEMENT, CABLE_TV, CARETAKER, CARETAKER_HOUSE, CARPET, CEMENT, CHILDRENS_POOL, CHILDREN_CARE, CINEMA, CLIMBING_WALL, CLOSET, COFFEE_SHOP, COLD_FLOOR, CONCIERGE_24H, COOKER, COPA, CORNER_PROPERTY, CORRAL, COVENTION_HALL, COVERAGE, COVERED_POOL, COWORKING, DECK, DECLIVE, DEPOSIT, DIGITAL_LOCKER, DINNER_ROOM, DISABLED_ACCESS, DIVIDERS, DOG_KENNEL, DRESS_ROOM, DRESS_ROOM2, DRYWALL, EAST_FACING, ECO_CONDOMINIUM, ECO_GARBAGE_COLLECTOR, EDICULE, ELECTRICITY, ELECTRIC_GENERATOR, ELECTRONIC_GATE, ELETRIC_CHARGER, ELEVATOR, EMPLOYEE_DEPENDENCY, ENTRANCE_HALL, FENCE, FIREPLACE, FITNESS_ROOM, FOOTBALL_FIELD, FREEZER, FRUIT_TREES, FULL_FLOOR, FURNISHED, GAMES_ROOM, GARDEN, GAS_SHOWER, GATED_COMMUNITY, GEMINADA, GLASS_WALL, GOLF_FIELD, GOURMET_BALCONY, GOURMET_KITCHEN, GOURMET_SPACE, GRASS, GRAVEL, GREEN_SPACE, GUEST_PARKING, GYM, HALF_FLOOR, HEADQUARTERS, HEATED_POOL, HEATING, HELIPAD, HIGH_CEILING_HEIGHT, HIKING_TRAIL, HOME_OFFICE, HOT_TUB, INDOOR_SOCCER, INTEGRATED_ENVIRONMENTS, INTERCOM, INTERNET_ACCESS, KITCHEN, KITCHEN_CABINETS, LAKE, LAKE_VIEW, LAMINATED_FLOOR, LAND, LARGE_KITCHEN, LARGE_ROOM, LARGE_WINDOW, LAUNDRY, LAVABO, LIBRARY, LUNCH_ROOM, MARINA, MASSAGE, MASSAGE_ROOM, MCMV, MEETING_ROOM, MEZZANINE, MINI_SQUARE, MOUNTAIN_VIEW, NATURAL_VENTILATION, NORTH_FACING, ORCHID_PLACE, PANORAMIC_VIEW, PANTRY, PARKING, PARTY_HALL, PASTURE, PATROL, PAVED_STREET, PAY_PER_USE_SERVICES, PETS_ALLOWED, PET_SPACE, PIZZA_OVEN, PLAN, PLANNED_FURNITURE, PLATED_GAS, PLATIBANDA, PLAYGROUND, PLAYGROUND_2, POMAR, POOL, POOL_BAR, PORCELAIN, PRIVATE_POOL, RAISED_FLOOR, RAMP, RECEPTION, RECREATION_AREA, REDARIO, REFECTORY, REFLECTING_POOL, RESTAURANT, REVERSIBLE_ROOM, RIVER, SAFETY_CIRCUIT, SANCA, SANDY, SAND_PIT, SAUNA, SEA_VIEW, SECURITY_CABIN, SECURITY_CAMERA, SEMI_OLYMPIC_POOL, SERVICE_AREA, SERVICE_BATHROOM, SERVICE_ENTRANCE, SERVICE_ROOM, SEWAGE, SIDE_ENTRANCE, SKATE_LANE, SLAB, SMALL_ROOM, SMART_APARTMENT, SMART_CONDOMINIUM, SOLARIUM, SOLAR_ENERGY, SOUNDPROOFING, SOUTH_FACING, SPA, SPORTS_COURT, SQUARE, SQUASH, STAIR, STORES, TEEN_SPACE, TENNIS_COURT, THERMAL_INSULATION, TOYS_PLACE, TREE_CLIMBING, TRUCK_ENTRANCE, VALET_PARKING, VEGETABLE_GARDEN, VINYL_FLOOR, WALLS_GRIDS, WALL_BALCONY, WATCHMAN, WATER_TANK, WELL, WEST_FACING, WHIRLPOOL, WOOD_FLOOR, ZEN_SPACE]
- `below_market` (boolean, optional) — Only listings stamped below market price by the site (the 'Ótimo preço' badge, DataZAP stamp).
- `seasonal_campaign` (boolean, optional) — Only listings in the site's running seasonal campaign (e.g. 'Festival da Mudança'); the campaign in force is read from the site and echoed in filters_applied.
- `virtual_tour` (boolean, optional) — Only listings with a virtual tour (honoured by the index; not in the site's panel).
- `near_transit` (boolean, optional) — Only listings near a metro / train station (the site's 'Próximo ao metrô/trem').
- `keyword` (string, optional) — Free-text words matched in the listing (e.g. 'piscina', 'vista para o mar'); honoured by the index, not in the site's panel.
- `external_id` (string, optional) — The advertiser's own reference code of a listing.
- `price_includes_fees` (boolean, optional) — Rent only: price_min / price_max apply to rent + condo fee (the site's 'valor total').
- `no_guarantor` (boolean, optional) — Rent only: rentable without a guarantor (the site's 'Aluguel sem fiador').
- `seasonal_rental` (boolean, optional) — Rent only: seasonal / short-stay rentals (daily, weekly or yearly periods).
- `owner_only` (boolean, optional) — Only listings advertised by the owner (no agency); honoured by the index, not in the site's panel.

**Returns:** results[]{id, url, title, headline, business[], listing_type, property_type, prices{sale_price_brl, sale_price_max_brl, rent_price_brl, rent_total_brl, condo_fee_brl, iptu_brl, iptu_period, rental_period, rental_guarantees[]}, price_per_m2_brl, usable_area_m2(+_max), total_area_m2(+_max), bedrooms, bathrooms, suites, parking_spaces (each +_max for developments), floor, building_floors, address{street, number, neighborhood, zone, city, state, state_code, zip_code, location_id, latitude, longitude, address_shown}, nearby_transit, points_of_interest[], amenities[{code,label}], amenities_detected[], description, photos[], videos[], floor_plans[], virtual_tour_url, publication_type, promoted, below_market, stamps[], advertiser_type, external_id, condominium_name, construction_status, construction_timeline[], delivered_at, property_developers[], same_property_listings, olx_listing_ids, created_at, updated_at, advertiser{id, name, profile_url, license_number (CRECI), phones[], whatsapp, website, logo, tier, address}, units[] (development units)} + total + page + page_size + total_pages + has_next + location + filters_applied

**Example request body:**
```json
{
  "location": "Pinheiros, São Paulo"
}
```

### POST https://api.reefapi.com/vivareal/v1/developments — 2 credits
New developments (lançamentos) for sale: projects with their price-from, unit sizes and bedroom ranges, construction stage and developer, in a place or around a point, with the site's filters. 30 per page, pages 1-50.

**Parameters:**
- `location` (string, optional) — Where to search: a place name ('Pinheiros, São Paulo', 'Copacabana', 'Curitiba'), a state name or code ('Minas Gerais', 'MG', 'estado de São Paulo' — a bare 'São Paulo' is the city), a location id from the `locations` action ('BR>Sao Paulo>NULL>Sao Paulo>Zona Oeste>Pinheiros'), or a pasted vivareal.com.br search link (its path and query filters are applied). Several places: separate them with ' | '. Leave empty (and no coordinates) for all of Brazil.
- `latitude` (number, optional) — Search around a point instead of a place: latitude (with longitude).
- `longitude` (number, optional) — Longitude of the point.
- `radius_km` (number, optional, default 2) — Radius around latitude / longitude in km (the site's map uses 2).
- `north` (number, optional) — Map box: north latitude (with south, east, west).
- `south` (number, optional) — Map box: south latitude.
- `east` (number, optional) — Map box: east longitude.
- `west` (number, optional) — Map box: west longitude.
- `sort` (enum, optional, default "relevance") — Order of results. [one of: relevance, newest, price_asc, price_desc, area_desc, area_asc]
- `page` (integer, optional, default 1) — Result page, 30 listings per page (fixed by the site); the site serves pages 1-50 (the first 1,500 results).
- `property_type` (array, optional) — One or more property types (the site's own list). Several = any of them. [one of: apartment, condo_house, commercial_building]
- `bedrooms` (array, optional) — Exact bedroom counts, any of them: 0-4, where 4 means 4 or more (the site's buttons).
- `min_bedrooms` (integer, optional) — At least this many bedrooms (4 = 4 or more).
- `bathrooms` (array, optional) — Exact bathroom counts, any of them: 1-4 (4 = 4 or more).
- `min_bathrooms` (integer, optional) — At least this many bathrooms (4 = 4 or more).
- `parking_spaces` (array, optional) — Exact parking-space counts, any of them: 0-4 (4 = 4 or more).
- `min_parking_spaces` (integer, optional) — At least this many parking spaces (4 = 4 or more).
- `price_min` (number, optional) — Lowest price in BRL (sale price, or monthly rent for business=rent).
- `price_max` (number, optional) — Highest price in BRL (sale price, or monthly rent for business=rent).
- `condo_fee_min` (number, optional) — Lowest monthly condominium fee (condomínio) in BRL.
- `condo_fee_max` (number, optional) — Highest monthly condominium fee (condomínio) in BRL.
- `area_min` (number, optional) — Smallest usable area (área útil) in m².
- `area_max` (number, optional) — Largest usable area (área útil) in m².
- `total_area_min` (number, optional) — Smallest total area (área total) in m².
- `total_area_max` (number, optional) — Largest total area (área total) in m².
- `amenities` (array, optional) — Amenity codes, all of them required (e.g. POOL, GYM, ELEVATOR, PETS_ALLOWED, FURNISHED, BALCONY, AIR_CONDITIONING). The site's Portuguese label ('Piscina') is accepted too. [one of: ACLIVE, ADMINISTRATION, ADULT_POOL, AIR_CONDITIONING, ALARM_SYSTEM, ALUMINUM_WINDOW, AMERICAN_KITCHEN, AQUARIUM, ARGILLOSE, ARMORED_SECURITY_CABIN, ARTESIAN_WELL, BACKGROUND_HOUSE, BACKYARD, BALCONY, BAR, BARBECUE_BALCONY, BARBECUE_GRILL, BARN, BATHROOM_CABINETS, BATHTUB, BEAUTY_CENTER, BEAUTY_ROOM, BEDROOM_WARDROBE, BICYCLES_PLACE, BLINDEX_BOX, BUILTIN_WARDROBE, BURNT_CEMENT, CABLE_TV, CARETAKER, CARETAKER_HOUSE, CARPET, CEMENT, CHILDRENS_POOL, CHILDREN_CARE, CINEMA, CLIMBING_WALL, CLOSET, COFFEE_SHOP, COLD_FLOOR, CONCIERGE_24H, COOKER, COPA, CORNER_PROPERTY, CORRAL, COVENTION_HALL, COVERAGE, COVERED_POOL, COWORKING, DECK, DECLIVE, DEPOSIT, DIGITAL_LOCKER, DINNER_ROOM, DISABLED_ACCESS, DIVIDERS, DOG_KENNEL, DRESS_ROOM, DRESS_ROOM2, DRYWALL, EAST_FACING, ECO_CONDOMINIUM, ECO_GARBAGE_COLLECTOR, EDICULE, ELECTRICITY, ELECTRIC_GENERATOR, ELECTRONIC_GATE, ELETRIC_CHARGER, ELEVATOR, EMPLOYEE_DEPENDENCY, ENTRANCE_HALL, FENCE, FIREPLACE, FITNESS_ROOM, FOOTBALL_FIELD, FREEZER, FRUIT_TREES, FULL_FLOOR, FURNISHED, GAMES_ROOM, GARDEN, GAS_SHOWER, GATED_COMMUNITY, GEMINADA, GLASS_WALL, GOLF_FIELD, GOURMET_BALCONY, GOURMET_KITCHEN, GOURMET_SPACE, GRASS, GRAVEL, GREEN_SPACE, GUEST_PARKING, GYM, HALF_FLOOR, HEADQUARTERS, HEATED_POOL, HEATING, HELIPAD, HIGH_CEILING_HEIGHT, HIKING_TRAIL, HOME_OFFICE, HOT_TUB, INDOOR_SOCCER, INTEGRATED_ENVIRONMENTS, INTERCOM, INTERNET_ACCESS, KITCHEN, KITCHEN_CABINETS, LAKE, LAKE_VIEW, LAMINATED_FLOOR, LAND, LARGE_KITCHEN, LARGE_ROOM, LARGE_WINDOW, LAUNDRY, LAVABO, LIBRARY, LUNCH_ROOM, MARINA, MASSAGE, MASSAGE_ROOM, MCMV, MEETING_ROOM, MEZZANINE, MINI_SQUARE, MOUNTAIN_VIEW, NATURAL_VENTILATION, NORTH_FACING, ORCHID_PLACE, PANORAMIC_VIEW, PANTRY, PARKING, PARTY_HALL, PASTURE, PATROL, PAVED_STREET, PAY_PER_USE_SERVICES, PETS_ALLOWED, PET_SPACE, PIZZA_OVEN, PLAN, PLANNED_FURNITURE, PLATED_GAS, PLATIBANDA, PLAYGROUND, PLAYGROUND_2, POMAR, POOL, POOL_BAR, PORCELAIN, PRIVATE_POOL, RAISED_FLOOR, RAMP, RECEPTION, RECREATION_AREA, REDARIO, REFECTORY, REFLECTING_POOL, RESTAURANT, REVERSIBLE_ROOM, RIVER, SAFETY_CIRCUIT, SANCA, SANDY, SAND_PIT, SAUNA, SEA_VIEW, SECURITY_CABIN, SECURITY_CAMERA, SEMI_OLYMPIC_POOL, SERVICE_AREA, SERVICE_BATHROOM, SERVICE_ENTRANCE, SERVICE_ROOM, SEWAGE, SIDE_ENTRANCE, SKATE_LANE, SLAB, SMALL_ROOM, SMART_APARTMENT, SMART_CONDOMINIUM, SOLARIUM, SOLAR_ENERGY, SOUNDPROOFING, SOUTH_FACING, SPA, SPORTS_COURT, SQUARE, SQUASH, STAIR, STORES, TEEN_SPACE, TENNIS_COURT, THERMAL_INSULATION, TOYS_PLACE, TREE_CLIMBING, TRUCK_ENTRANCE, VALET_PARKING, VEGETABLE_GARDEN, VINYL_FLOOR, WALLS_GRIDS, WALL_BALCONY, WATCHMAN, WATER_TANK, WELL, WEST_FACING, WHIRLPOOL, WOOD_FLOOR, ZEN_SPACE]
- `below_market` (boolean, optional) — Only listings stamped below market price by the site (the 'Ótimo preço' badge, DataZAP stamp).
- `seasonal_campaign` (boolean, optional) — Only listings in the site's running seasonal campaign (e.g. 'Festival da Mudança'); the campaign in force is read from the site and echoed in filters_applied.
- `virtual_tour` (boolean, optional) — Only listings with a virtual tour (honoured by the index; not in the site's panel).
- `near_transit` (boolean, optional) — Only listings near a metro / train station (the site's 'Próximo ao metrô/trem').
- `keyword` (string, optional) — Free-text words matched in the listing (e.g. 'piscina', 'vista para o mar'); honoured by the index, not in the site's panel.
- `external_id` (string, optional) — The advertiser's own reference code of a listing.
- `construction_status` (array, optional) — Construction stage, any of them. [one of: planned, under_construction, ready]

**Returns:** results[]{id, url, title, headline, business[], listing_type, property_type, prices{sale_price_brl, sale_price_max_brl, rent_price_brl, rent_total_brl, condo_fee_brl, iptu_brl, iptu_period, rental_period, rental_guarantees[]}, price_per_m2_brl, usable_area_m2(+_max), total_area_m2(+_max), bedrooms, bathrooms, suites, parking_spaces (each +_max for developments), floor, building_floors, address{street, number, neighborhood, zone, city, state, state_code, zip_code, location_id, latitude, longitude, address_shown}, nearby_transit, points_of_interest[], amenities[{code,label}], amenities_detected[], description, photos[], videos[], floor_plans[], virtual_tour_url, publication_type, promoted, below_market, stamps[], advertiser_type, external_id, condominium_name, construction_status, construction_timeline[], delivered_at, property_developers[], same_property_listings, olx_listing_ids, created_at, updated_at, advertiser{id, name, profile_url, license_number (CRECI), phones[], whatsapp, website, logo, tier, address}, units[] (development units)} + total + page + total_pages + has_next + location + filters_applied

**Example request body:**
```json
{
  "location": "Pinheiros, São Paulo"
}
```

### POST https://api.reefapi.com/vivareal/v1/count — 1 credit
Count the listings that match a place and filters (without fetching them), with the number of matching listings per amenity (pool, gym, elevator, pets allowed…).

**Parameters:**
- `location` (string, optional) — Where to search: a place name ('Pinheiros, São Paulo', 'Copacabana', 'Curitiba'), a state name or code ('Minas Gerais', 'MG', 'estado de São Paulo' — a bare 'São Paulo' is the city), a location id from the `locations` action ('BR>Sao Paulo>NULL>Sao Paulo>Zona Oeste>Pinheiros'), or a pasted vivareal.com.br search link (its path and query filters are applied). Several places: separate them with ' | '. Leave empty (and no coordinates) for all of Brazil.
- `latitude` (number, optional) — Search around a point instead of a place: latitude (with longitude).
- `longitude` (number, optional) — Longitude of the point.
- `radius_km` (number, optional, default 2) — Radius around latitude / longitude in km (the site's map uses 2).
- `north` (number, optional) — Map box: north latitude (with south, east, west).
- `south` (number, optional) — Map box: south latitude.
- `east` (number, optional) — Map box: east longitude.
- `west` (number, optional) — Map box: west longitude.
- `business` (enum, optional, default "sale") — For sale or for rent (rental, aluguel accepted). [one of: sale, rent]
- `listing_type` (enum, optional, default "used") — Count used listings or new developments. [one of: used, new_development]
- `property_type` (array, optional) — One or more property types (the site's own list). Several = any of them. [one of: apartment, house, condo_house, country_house, penthouse, flat, kitnet, residential_land, two_story_house, clinic, residential_building, farm, warehouse, commercial_house, commercial_land, store, office, commercial_building, studio, loft, village_house, hotel, commercial_floor, parking_space]
- `bedrooms` (array, optional) — Exact bedroom counts, any of them: 0-4, where 4 means 4 or more (the site's buttons).
- `min_bedrooms` (integer, optional) — At least this many bedrooms (4 = 4 or more).
- `bathrooms` (array, optional) — Exact bathroom counts, any of them: 1-4 (4 = 4 or more).
- `min_bathrooms` (integer, optional) — At least this many bathrooms (4 = 4 or more).
- `parking_spaces` (array, optional) — Exact parking-space counts, any of them: 0-4 (4 = 4 or more).
- `min_parking_spaces` (integer, optional) — At least this many parking spaces (4 = 4 or more).
- `price_min` (number, optional) — Lowest price in BRL (sale price, or monthly rent for business=rent).
- `price_max` (number, optional) — Highest price in BRL (sale price, or monthly rent for business=rent).
- `condo_fee_min` (number, optional) — Lowest monthly condominium fee (condomínio) in BRL.
- `condo_fee_max` (number, optional) — Highest monthly condominium fee (condomínio) in BRL.
- `area_min` (number, optional) — Smallest usable area (área útil) in m².
- `area_max` (number, optional) — Largest usable area (área útil) in m².
- `total_area_min` (number, optional) — Smallest total area (área total) in m².
- `total_area_max` (number, optional) — Largest total area (área total) in m².
- `amenities` (array, optional) — Amenity codes, all of them required (e.g. POOL, GYM, ELEVATOR, PETS_ALLOWED, FURNISHED, BALCONY, AIR_CONDITIONING). The site's Portuguese label ('Piscina') is accepted too. [one of: ACLIVE, ADMINISTRATION, ADULT_POOL, AIR_CONDITIONING, ALARM_SYSTEM, ALUMINUM_WINDOW, AMERICAN_KITCHEN, AQUARIUM, ARGILLOSE, ARMORED_SECURITY_CABIN, ARTESIAN_WELL, BACKGROUND_HOUSE, BACKYARD, BALCONY, BAR, BARBECUE_BALCONY, BARBECUE_GRILL, BARN, BATHROOM_CABINETS, BATHTUB, BEAUTY_CENTER, BEAUTY_ROOM, BEDROOM_WARDROBE, BICYCLES_PLACE, BLINDEX_BOX, BUILTIN_WARDROBE, BURNT_CEMENT, CABLE_TV, CARETAKER, CARETAKER_HOUSE, CARPET, CEMENT, CHILDRENS_POOL, CHILDREN_CARE, CINEMA, CLIMBING_WALL, CLOSET, COFFEE_SHOP, COLD_FLOOR, CONCIERGE_24H, COOKER, COPA, CORNER_PROPERTY, CORRAL, COVENTION_HALL, COVERAGE, COVERED_POOL, COWORKING, DECK, DECLIVE, DEPOSIT, DIGITAL_LOCKER, DINNER_ROOM, DISABLED_ACCESS, DIVIDERS, DOG_KENNEL, DRESS_ROOM, DRESS_ROOM2, DRYWALL, EAST_FACING, ECO_CONDOMINIUM, ECO_GARBAGE_COLLECTOR, EDICULE, ELECTRICITY, ELECTRIC_GENERATOR, ELECTRONIC_GATE, ELETRIC_CHARGER, ELEVATOR, EMPLOYEE_DEPENDENCY, ENTRANCE_HALL, FENCE, FIREPLACE, FITNESS_ROOM, FOOTBALL_FIELD, FREEZER, FRUIT_TREES, FULL_FLOOR, FURNISHED, GAMES_ROOM, GARDEN, GAS_SHOWER, GATED_COMMUNITY, GEMINADA, GLASS_WALL, GOLF_FIELD, GOURMET_BALCONY, GOURMET_KITCHEN, GOURMET_SPACE, GRASS, GRAVEL, GREEN_SPACE, GUEST_PARKING, GYM, HALF_FLOOR, HEADQUARTERS, HEATED_POOL, HEATING, HELIPAD, HIGH_CEILING_HEIGHT, HIKING_TRAIL, HOME_OFFICE, HOT_TUB, INDOOR_SOCCER, INTEGRATED_ENVIRONMENTS, INTERCOM, INTERNET_ACCESS, KITCHEN, KITCHEN_CABINETS, LAKE, LAKE_VIEW, LAMINATED_FLOOR, LAND, LARGE_KITCHEN, LARGE_ROOM, LARGE_WINDOW, LAUNDRY, LAVABO, LIBRARY, LUNCH_ROOM, MARINA, MASSAGE, MASSAGE_ROOM, MCMV, MEETING_ROOM, MEZZANINE, MINI_SQUARE, MOUNTAIN_VIEW, NATURAL_VENTILATION, NORTH_FACING, ORCHID_PLACE, PANORAMIC_VIEW, PANTRY, PARKING, PARTY_HALL, PASTURE, PATROL, PAVED_STREET, PAY_PER_USE_SERVICES, PETS_ALLOWED, PET_SPACE, PIZZA_OVEN, PLAN, PLANNED_FURNITURE, PLATED_GAS, PLATIBANDA, PLAYGROUND, PLAYGROUND_2, POMAR, POOL, POOL_BAR, PORCELAIN, PRIVATE_POOL, RAISED_FLOOR, RAMP, RECEPTION, RECREATION_AREA, REDARIO, REFECTORY, REFLECTING_POOL, RESTAURANT, REVERSIBLE_ROOM, RIVER, SAFETY_CIRCUIT, SANCA, SANDY, SAND_PIT, SAUNA, SEA_VIEW, SECURITY_CABIN, SECURITY_CAMERA, SEMI_OLYMPIC_POOL, SERVICE_AREA, SERVICE_BATHROOM, SERVICE_ENTRANCE, SERVICE_ROOM, SEWAGE, SIDE_ENTRANCE, SKATE_LANE, SLAB, SMALL_ROOM, SMART_APARTMENT, SMART_CONDOMINIUM, SOLARIUM, SOLAR_ENERGY, SOUNDPROOFING, SOUTH_FACING, SPA, SPORTS_COURT, SQUARE, SQUASH, STAIR, STORES, TEEN_SPACE, TENNIS_COURT, THERMAL_INSULATION, TOYS_PLACE, TREE_CLIMBING, TRUCK_ENTRANCE, VALET_PARKING, VEGETABLE_GARDEN, VINYL_FLOOR, WALLS_GRIDS, WALL_BALCONY, WATCHMAN, WATER_TANK, WELL, WEST_FACING, WHIRLPOOL, WOOD_FLOOR, ZEN_SPACE]
- `below_market` (boolean, optional) — Only listings stamped below market price by the site (the 'Ótimo preço' badge, DataZAP stamp).
- `seasonal_campaign` (boolean, optional) — Only listings in the site's running seasonal campaign (e.g. 'Festival da Mudança'); the campaign in force is read from the site and echoed in filters_applied.
- `virtual_tour` (boolean, optional) — Only listings with a virtual tour (honoured by the index; not in the site's panel).
- `near_transit` (boolean, optional) — Only listings near a metro / train station (the site's 'Próximo ao metrô/trem').
- `keyword` (string, optional) — Free-text words matched in the listing (e.g. 'piscina', 'vista para o mar'); honoured by the index, not in the site's panel.
- `external_id` (string, optional) — The advertiser's own reference code of a listing.
- `price_includes_fees` (boolean, optional) — Rent only: price_min / price_max apply to rent + condo fee (the site's 'valor total').
- `no_guarantor` (boolean, optional) — Rent only: rentable without a guarantor (the site's 'Aluguel sem fiador').
- `seasonal_rental` (boolean, optional) — Rent only: seasonal / short-stay rentals (daily, weekly or yearly periods).
- `owner_only` (boolean, optional) — Only listings advertised by the owner (no agency); honoured by the index, not in the site's panel.
- `construction_status` (array, optional) — New developments only: construction stage. [one of: planned, under_construction, ready]

**Returns:** total + pages_available + amenities[{code, label, count}] + location + filters_applied

**Example request body:**
```json
{
  "location": "São Paulo",
  "property_type": "apartment"
}
```

### POST https://api.reefapi.com/vivareal/v1/listing — 1 credit
Everything VivaReal publishes about one listing: sale price / rent, condo fee, IPTU, rent total, accepted rental guarantees, usable and total area, bedrooms, suites, bathrooms, parking, floor, amenities, the full description, every photo, video and floor plan, the address and coordinates as published, nearby metro / train stations and points of interest, construction stage and timeline, the units of a development, and the advertiser (name, CRECI, phones, WhatsApp, website, profile).

**Parameters:**
- `listing` (string, required) — Listing id (e.g. 2742055158) or a vivareal.com.br /imovel/ or /imoveis-lancamentos/ link.

**Returns:** listing{id, url, title, headline, business[], listing_type, property_type, prices{sale_price_brl, sale_price_max_brl, rent_price_brl, rent_total_brl, condo_fee_brl, iptu_brl, iptu_period, rental_period, rental_guarantees[]}, price_per_m2_brl, usable_area_m2(+_max), total_area_m2(+_max), bedrooms, bathrooms, suites, parking_spaces (each +_max for developments), floor, building_floors, address{street, number, neighborhood, zone, city, state, state_code, zip_code, location_id, latitude, longitude, address_shown}, nearby_transit, points_of_interest[], amenities[{code,label}], amenities_detected[], description, photos[], videos[], floor_plans[], virtual_tour_url, publication_type, promoted, below_market, stamps[], advertiser_type, external_id, condominium_name, construction_status, construction_timeline[], delivered_at, property_developers[], same_property_listings, olx_listing_ids, created_at, updated_at, advertiser{id, name, profile_url, license_number (CRECI), phones[], whatsapp, website, logo, tier, address}, units[] (development units)} + capacity_limit, ceiling_height_m, source_id

**Example request body:**
```json
{
  "listing": "2742055158"
}
```

### POST https://api.reefapi.com/vivareal/v1/price_insights — 2 credits
The site's own price statistics for a city or neighbourhood: number of listings, average price, average area, average price per m², listings per price band, a short description of the area, and nearby neighbourhoods with their averages and % difference.

**Parameters:**
- `location` (string, required) — A city or neighbourhood name ('Pinheiros, São Paulo'), or a location id from `locations`.
- `business` (enum, optional, default "sale") — For sale or for rent (rental, aluguel accepted). [one of: sale, rent]
- `property_type` (enum, optional) — Statistics for one property type (default: all residential). [one of: apartment, house, condo_house, country_house, penthouse, flat, kitnet, residential_land, two_story_house, clinic, residential_building, farm, warehouse, commercial_house, commercial_land, store, office, commercial_building, studio, loft, village_house, hotel, commercial_floor, parking_space]

**Returns:** place, url, stats{listings, average_price_brl, average_area_m2, average_price_per_m2_brl}, price_bands[{label, listings, url}], about{mobility, security, infrastructure, lifestyle}, nearby_places[{name, distance_km, stats, compared_to_place_pct, description}] + location

**Example request body:**
```json
{
  "location": "Pinheiros, São Paulo"
}
```

### POST https://api.reefapi.com/vivareal/v1/agency — 2 credits
A real-estate agency / advertiser profile: name, CRECI licence, phones, address, website, logo, tier, the rating and official-store text its VivaReal page carries, and how many listings it has for sale and for rent.

**Parameters:**
- `agency` (string, required) — The advertiser id from a listing's `advertiser.id` (uuid), the number in a vivareal.com.br/imobiliaria/<number>/ link, or that link.

**Returns:** agency{id, name, page_id, profile_url, license_number, phones[], phone_primary, phone_mobile, website, logo, tier, page_tier, created_at, address{…}, rating{score, ratings, feedbacks, shown_on_site}, official_store{description, logo, cover}, listings_total, listings_for_sale, listings_for_rent, chat_enabled}

**Example request body:**
```json
{
  "agency": "c32f35e1-83a6-d7e8-da74-a045c07fa10b"
}
```

### POST https://api.reefapi.com/vivareal/v1/agency_listings — 2 credits
Every live listing of one agency / advertiser, for sale or for rent, with the same filters and sorts as `search`. 30 per page, pages 1-50.

**Parameters:**
- `agency` (string, required) — Advertiser id (uuid) or /imobiliaria/<number>/ number or link.
- `business` (enum, optional, default "sale") — For sale or for rent (rental, aluguel accepted). [one of: sale, rent]
- `listing_type` (enum, optional, default "all") — Which of the advertiser's listings (developers list mostly new developments). [one of: all, used, new_development]
- `location` (string, optional) — Where to search: a place name ('Pinheiros, São Paulo', 'Copacabana', 'Curitiba'), a state name or code ('Minas Gerais', 'MG', 'estado de São Paulo' — a bare 'São Paulo' is the city), a location id from the `locations` action ('BR>Sao Paulo>NULL>Sao Paulo>Zona Oeste>Pinheiros'), or a pasted vivareal.com.br search link (its path and query filters are applied). Several places: separate them with ' | '. Leave empty (and no coordinates) for all of Brazil.
- `sort` (enum, optional, default "relevance") — Order of results. [one of: relevance, newest, price_asc, price_desc, area_desc, area_asc]
- `page` (integer, optional, default 1) — Result page, 30 listings per page (fixed by the site); the site serves pages 1-50 (the first 1,500 results).
- `property_type` (array, optional) — One or more property types (the site's own list). Several = any of them. [one of: apartment, house, condo_house, country_house, penthouse, flat, kitnet, residential_land, two_story_house, clinic, residential_building, farm, warehouse, commercial_house, commercial_land, store, office, commercial_building, studio, loft, village_house, hotel, commercial_floor, parking_space]
- `bedrooms` (array, optional) — Exact bedroom counts, any of them: 0-4, where 4 means 4 or more (the site's buttons).
- `min_bedrooms` (integer, optional) — At least this many bedrooms (4 = 4 or more).
- `bathrooms` (array, optional) — Exact bathroom counts, any of them: 1-4 (4 = 4 or more).
- `min_bathrooms` (integer, optional) — At least this many bathrooms (4 = 4 or more).
- `parking_spaces` (array, optional) — Exact parking-space counts, any of them: 0-4 (4 = 4 or more).
- `min_parking_spaces` (integer, optional) — At least this many parking spaces (4 = 4 or more).
- `price_min` (number, optional) — Lowest price in BRL (sale price, or monthly rent for business=rent).
- `price_max` (number, optional) — Highest price in BRL (sale price, or monthly rent for business=rent).
- `condo_fee_min` (number, optional) — Lowest monthly condominium fee (condomínio) in BRL.
- `condo_fee_max` (number, optional) — Highest monthly condominium fee (condomínio) in BRL.
- `area_min` (number, optional) — Smallest usable area (área útil) in m².
- `area_max` (number, optional) — Largest usable area (área útil) in m².
- `total_area_min` (number, optional) — Smallest total area (área total) in m².
- `total_area_max` (number, optional) — Largest total area (área total) in m².
- `amenities` (array, optional) — Amenity codes, all of them required (e.g. POOL, GYM, ELEVATOR, PETS_ALLOWED, FURNISHED, BALCONY, AIR_CONDITIONING). The site's Portuguese label ('Piscina') is accepted too. [one of: ACLIVE, ADMINISTRATION, ADULT_POOL, AIR_CONDITIONING, ALARM_SYSTEM, ALUMINUM_WINDOW, AMERICAN_KITCHEN, AQUARIUM, ARGILLOSE, ARMORED_SECURITY_CABIN, ARTESIAN_WELL, BACKGROUND_HOUSE, BACKYARD, BALCONY, BAR, BARBECUE_BALCONY, BARBECUE_GRILL, BARN, BATHROOM_CABINETS, BATHTUB, BEAUTY_CENTER, BEAUTY_ROOM, BEDROOM_WARDROBE, BICYCLES_PLACE, BLINDEX_BOX, BUILTIN_WARDROBE, BURNT_CEMENT, CABLE_TV, CARETAKER, CARETAKER_HOUSE, CARPET, CEMENT, CHILDRENS_POOL, CHILDREN_CARE, CINEMA, CLIMBING_WALL, CLOSET, COFFEE_SHOP, COLD_FLOOR, CONCIERGE_24H, COOKER, COPA, CORNER_PROPERTY, CORRAL, COVENTION_HALL, COVERAGE, COVERED_POOL, COWORKING, DECK, DECLIVE, DEPOSIT, DIGITAL_LOCKER, DINNER_ROOM, DISABLED_ACCESS, DIVIDERS, DOG_KENNEL, DRESS_ROOM, DRESS_ROOM2, DRYWALL, EAST_FACING, ECO_CONDOMINIUM, ECO_GARBAGE_COLLECTOR, EDICULE, ELECTRICITY, ELECTRIC_GENERATOR, ELECTRONIC_GATE, ELETRIC_CHARGER, ELEVATOR, EMPLOYEE_DEPENDENCY, ENTRANCE_HALL, FENCE, FIREPLACE, FITNESS_ROOM, FOOTBALL_FIELD, FREEZER, FRUIT_TREES, FULL_FLOOR, FURNISHED, GAMES_ROOM, GARDEN, GAS_SHOWER, GATED_COMMUNITY, GEMINADA, GLASS_WALL, GOLF_FIELD, GOURMET_BALCONY, GOURMET_KITCHEN, GOURMET_SPACE, GRASS, GRAVEL, GREEN_SPACE, GUEST_PARKING, GYM, HALF_FLOOR, HEADQUARTERS, HEATED_POOL, HEATING, HELIPAD, HIGH_CEILING_HEIGHT, HIKING_TRAIL, HOME_OFFICE, HOT_TUB, INDOOR_SOCCER, INTEGRATED_ENVIRONMENTS, INTERCOM, INTERNET_ACCESS, KITCHEN, KITCHEN_CABINETS, LAKE, LAKE_VIEW, LAMINATED_FLOOR, LAND, LARGE_KITCHEN, LARGE_ROOM, LARGE_WINDOW, LAUNDRY, LAVABO, LIBRARY, LUNCH_ROOM, MARINA, MASSAGE, MASSAGE_ROOM, MCMV, MEETING_ROOM, MEZZANINE, MINI_SQUARE, MOUNTAIN_VIEW, NATURAL_VENTILATION, NORTH_FACING, ORCHID_PLACE, PANORAMIC_VIEW, PANTRY, PARKING, PARTY_HALL, PASTURE, PATROL, PAVED_STREET, PAY_PER_USE_SERVICES, PETS_ALLOWED, PET_SPACE, PIZZA_OVEN, PLAN, PLANNED_FURNITURE, PLATED_GAS, PLATIBANDA, PLAYGROUND, PLAYGROUND_2, POMAR, POOL, POOL_BAR, PORCELAIN, PRIVATE_POOL, RAISED_FLOOR, RAMP, RECEPTION, RECREATION_AREA, REDARIO, REFECTORY, REFLECTING_POOL, RESTAURANT, REVERSIBLE_ROOM, RIVER, SAFETY_CIRCUIT, SANCA, SANDY, SAND_PIT, SAUNA, SEA_VIEW, SECURITY_CABIN, SECURITY_CAMERA, SEMI_OLYMPIC_POOL, SERVICE_AREA, SERVICE_BATHROOM, SERVICE_ENTRANCE, SERVICE_ROOM, SEWAGE, SIDE_ENTRANCE, SKATE_LANE, SLAB, SMALL_ROOM, SMART_APARTMENT, SMART_CONDOMINIUM, SOLARIUM, SOLAR_ENERGY, SOUNDPROOFING, SOUTH_FACING, SPA, SPORTS_COURT, SQUARE, SQUASH, STAIR, STORES, TEEN_SPACE, TENNIS_COURT, THERMAL_INSULATION, TOYS_PLACE, TREE_CLIMBING, TRUCK_ENTRANCE, VALET_PARKING, VEGETABLE_GARDEN, VINYL_FLOOR, WALLS_GRIDS, WALL_BALCONY, WATCHMAN, WATER_TANK, WELL, WEST_FACING, WHIRLPOOL, WOOD_FLOOR, ZEN_SPACE]
- `below_market` (boolean, optional) — Only listings stamped below market price by the site (the 'Ótimo preço' badge, DataZAP stamp).
- `seasonal_campaign` (boolean, optional) — Only listings in the site's running seasonal campaign (e.g. 'Festival da Mudança'); the campaign in force is read from the site and echoed in filters_applied.
- `virtual_tour` (boolean, optional) — Only listings with a virtual tour (honoured by the index; not in the site's panel).
- `near_transit` (boolean, optional) — Only listings near a metro / train station (the site's 'Próximo ao metrô/trem').
- `keyword` (string, optional) — Free-text words matched in the listing (e.g. 'piscina', 'vista para o mar'); honoured by the index, not in the site's panel.
- `external_id` (string, optional) — The advertiser's own reference code of a listing.
- `price_includes_fees` (boolean, optional) — Rent only: price_min / price_max apply to rent + condo fee (the site's 'valor total').
- `no_guarantor` (boolean, optional) — Rent only: rentable without a guarantor (the site's 'Aluguel sem fiador').
- `seasonal_rental` (boolean, optional) — Rent only: seasonal / short-stay rentals (daily, weekly or yearly periods).
- `owner_only` (boolean, optional) — Only listings advertised by the owner (no agency); honoured by the index, not in the site's panel.

**Returns:** results[]{id, url, title, headline, business[], listing_type, property_type, prices{sale_price_brl, sale_price_max_brl, rent_price_brl, rent_total_brl, condo_fee_brl, iptu_brl, iptu_period, rental_period, rental_guarantees[]}, price_per_m2_brl, usable_area_m2(+_max), total_area_m2(+_max), bedrooms, bathrooms, suites, parking_spaces (each +_max for developments), floor, building_floors, address{street, number, neighborhood, zone, city, state, state_code, zip_code, location_id, latitude, longitude, address_shown}, nearby_transit, points_of_interest[], amenities[{code,label}], amenities_detected[], description, photos[], videos[], floor_plans[], virtual_tour_url, publication_type, promoted, below_market, stamps[], advertiser_type, external_id, condominium_name, construction_status, construction_timeline[], delivered_at, property_developers[], same_property_listings, olx_listing_ids, created_at, updated_at, advertiser{id, name, profile_url, license_number (CRECI), phones[], whatsapp, website, logo, tier, address}, units[] (development units)} + total + page + total_pages + has_next + agency{id}

**Example request body:**
```json
{
  "agency": "652711"
}
```

### POST https://api.reefapi.com/vivareal/v1/condominiums — 1 credit
Find condominium buildings (condomínios) by name and get the id the `condominium` action accepts.

**Parameters:**
- `query` (string, required) — Building name.
- `limit` (integer, optional, default 10) — Maximum matches.

**Returns:** results[]{id, short_id, name, street, number, neighborhood, city, state, url} + count

**Example request body:**
```json
{
  "query": "Pinheiros"
}
```

### POST https://api.reefapi.com/vivareal/v1/condominium — 2 credits
One condominium building as its VivaReal page shows it: address and coordinates, building amenities, area range, bedroom / bathroom / parking maxima, sale and rent price-from, and the listings inside it (5 per page, the page's own size) for sale or for rent.

**Parameters:**
- `condominium` (string, required) — Condominium id or short id from `condominiums` (e.g. c1b7ea7b-eef0) or a vivareal.com.br/condominio/ link.
- `business` (enum, optional, default "sale") — For sale or for rent (rental, aluguel accepted). [one of: sale, rent]
- `page` (integer, optional, default 1) — Page of the building's listings (5 per page).

**Returns:** condominium{id, short_id, name, url, description, address{…}, area_min_m2, area_max_m2, max_bedrooms, max_bathrooms, max_parking_spaces, sale_price_from_brl, rent_price_from_brl, amenities[], listings_total, listings[] (same row as search)} + page + total_pages + has_next

**Example request body:**
```json
{
  "condominium": "c1b7ea7b-eef0"
}
```

### POST https://api.reefapi.com/vivareal/v1/developers — 1 credit
VivaReal's directory of property developers (incorporadoras / construtoras) that advertise new developments on the site: name, office address, number of active listings, the year they started advertising, and the id the `developer` action accepts. 16 per page, in the directory's own (alphabetical) order; `total` is the directory's own count.

**Parameters:**
- `page` (integer, optional, default 1) — Directory page (16 developers per page).

**Returns:** results[]{id, name, url, address, active_listings, advertising_since, advertising_since_year} + total + page + page_size + total_pages + has_next

**Example request body:**
```json
{
  "page": 1
}
```

### POST https://api.reefapi.com/vivareal/v1/developer — 2 credits
One property developer (incorporadora) as its VivaReal page shows it: name, office address, phone, logo, website and licence from its advertiser record, and every development the page lists (price-from and price-to, unit sizes, bedrooms, construction stage, address and coordinates, amenities, photos, description) — the page shows them all at once (no paging measured).

**Parameters:**
- `developer` (string, required) — Developer id from `developers` (uuid) or a vivareal.com.br/incorporadora/<id> link.

**Returns:** developer{id, name, url, address, street, city, state, phone, phones[], logo, license_number, website, tier, verified, created_at, page_heading, listings_total, own_account_listings_total, listings[]{id, url, title, business[], listing_type, property_type, prices{sale_price_brl, sale_price_max_brl, condo_fee_brl, iptu_brl, price_is_from}, usable_area_m2(+_max), bedrooms(+_max), bathrooms, suites, parking_spaces, amenities[], address{…, latitude, longitude}, construction_status, condominium_name, property_developer, photos[], description, advertiser}}

**Example request body:**
```json
{
  "developer": "6976f631-1479-8d84-8bfb-6003b721fab9"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=vivareal
- Human docs page: https://reefapi.com/docs/vivareal
- Overview page: https://reefapi.com/vivareal-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
