| data.apiUrl | string | null | URL from internal API when structured search uses Glue; may be null in page modes. | https://glue-api.vivareal.com/v2/listings?business=SALE&addressCity=Sao+Paulo&addressState=Sao+Paulo&unitTypes=APARTMENT&page=1&size=30 |
| data.extractedAt | string (ISO datetime) | Extraction Timestamp UTC. | 2026-07-12T15:40:00.000Z |
| data.facets | array<object> | Dynamic facets returned by internal API when available. | [{"name":"unitTypes","value":["APARTMENT","PENTHOUSE"]}] |
| data.filters | object | Normalized structured search filters or fragments of URI returned by VivaReal in URL mode. | {"businessType":"sale","state":"SP","stateName":"São Paulo","city":"São Paulo","neighborhood":"Vila Mariana","propertyTypes":["apartment"],"amenities":["POOL","BALCONY"],"bedrooms":[2,3],"bathrooms":[2],"parkingSpots":[1,2],"priceMin":500000,"priceMax":1200000,"areaMin":70,"areaMax":180,"sort":"biggest_area","directOwner":false,"condominium":false,"includeLaunches":false,"latitude":-23.5892,"longitude":-46.6344,"page":1} |
| data.filters.amenities[] | string | Applied amenities. | POOL |
| data.filters.areaMax | integer | null | Maximum usable area applied. | 180 |
| data.filters.areaMin | integer | null | Minimum usable area applied. | 70 |
| data.filters.bathrooms[] | integer | Bathroom quantities selected. | 2 |
| data.filters.bedrooms[] | integer | Room quantities selected. | 2 |
| data.filters.businessType | "sale" | "rent" | Standard business type. | sale |
| data.filters.city | string | null | Search city. | São Paulo |
| data.filters.condominium | boolean | Indicates condominium type inclusion. | false |
| data.filters.directOwner | boolean | Indicates filter by direct advertiser. | false |
| data.filters.includeLaunches | boolean | Indicates whether postings can appear. | false |
| data.filters.latitude | number | null | Latitude used when searching for a point. | -23.5892 |
| data.filters.longitude | number | null | Longitude used in the point search. | -46.6344 |
| data.filters.neighborhood | string | null | Search neighborhood. | Vila Mariana |
| data.filters.page | integer | Page requested. | 1 |
| data.filters.parkingSpots[] | integer | Number of vacancies selected. | 1 |
| data.filters.priceMax | integer | null | Maximum price applied. | 1200000 |
| data.filters.priceMin | integer | null | Minimum price applied. | 500000 |
| data.filters.propertyTypes[] | string | Standard property types. | apartment |
| data.filters.sort | string | Standard ordering. | biggest_area |
| data.filters.state | string | null | UF. | SP |
| data.filters.stateName | string | null | Full state name. | São Paulo |
| data.items[].acceptExchange | boolean | null | Indicates exchange acceptance. | false |
| data.items[].address | object | null | Standardized address and geolocation. | {"country":"Brasil","state":"São Paulo","stateAcronym":"SP","city":"São Paulo","zone":"Zona Sul","neighborhood":"Vila Mariana","street":"Rua Domingos de Morais","streetNumber":"1200","zipCode":"04010000","fullAddress":"Rua Domingos de Morais, Vila Mariana, São Paulo - SP","locationId":"BR-SAO-PAULO-VILA-MARIANA","displayType":"ALL","approximate":false,"coordinates":{"latitude":-23.5892,"longitude":-46.6344},"nearby":{"subway":"Vila Mariana","distanceMeters":450}} |
| data.items[].address.approximate | boolean | null | Indicates approximate location. | false |
| data.items[].address.city | string | null | City of property. | São Paulo |
| data.items[].address.coordinates.latitude | number | Latitude published. | -23.5892 |
| data.items[].address.coordinates.longitude | number | Published longitude. | -46.6344 |
| data.items[].address.country | string | null | Country of property. | Brasil |
| data.items[].address.displayType | string | null | Address display policy. | ALL |
| data.items[].address.fullAddress | string | null | Formatted address. | Rua Domingos de Morais, Vila Mariana, São Paulo - SP |
| data.items[].address.locationId | string | null | Internal geographic identifier. | BR-SAO-PAULO-VILA-MARIANA |
| data.items[].address.nearby | object | null | Points and proximity information available. | {"subway":"Vila Mariana","distanceMeters":450} |
| data.items[].address.neighborhood | string | null | Neighborhood of the property. | Vila Mariana |
| data.items[].address.state | string | null | Property status. | São Paulo |
| data.items[].address.stateAcronym | string | null | UF of the property. | SP |
| data.items[].address.street | string | null | Street when the advertisement discloses it. | Rua Domingos de Morais |
| data.items[].address.streetNumber | string | null | Number when released. | 1200 |
| data.items[].address.zipCode | string | null | CEP of the property. | 04010000 |
| data.items[].address.zone | string | null | City area. | Zona Sul |
| data.items[].advertiser.addresses | object | null | Advertiser's business addresses. | {"city":"São Paulo","state":"SP"} |
| data.items[].advertiser.createdAt | string | null | Advertiser registration date. | 2018-03-09T10:00:00.000Z |
| data.items[].advertiser.id | string | null | Advertiser identifier. | 55123 |
| data.items[].advertiser.imageUrl | string | null | Advertiser logo or image. | https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/logo.webp |
| data.items[].advertiser.legacyId | string | null | Advertiser's legacy identifier. | 179386 |
| data.items[].advertiser.license | string | null | Professional registration, such as CRECI. | CRECI J-12345-SP |
| data.items[].advertiser.listingsCount | integer | null | Quantity of advertiser ads. | 169 |
| data.items[].advertiser.name | string | null | Advertiser name. | Imobiliária Exemplo |
| data.items[].advertiser.phoneNumbers[] | string | Published telephone numbers. | 1130001000 |
| data.items[].advertiser.rating | number | null | Advertiser's note when displayed. | 4.7 |
| data.items[].advertiser.tier | string | null | Advertiser's commercial tier. | PREMIUM |
| data.items[].advertiser.url | string | null | Advertiser's public page. | https://www.vivareal.com.br/imobiliaria/imobiliaria-exemplo-55123/ |
| data.items[].advertiser.verified | boolean | null | Indicates verified advertiser. | true |
| data.items[].advertiser.websiteUrl | string | null | External website published. | https://www.imobiliaria-exemplo.com.br/ |
| data.items[].advertiser.whatsappNumber | string | null | WhatsApp published. | 11987654321 |
| data.items[].aiAmenities[] | string | Characteristics inferred in the structured payload. | NATURAL_LIGHT |
| data.items[].amenities[] | string | Amenities stated in listing. | POOL |
| data.items[].attributes.bathrooms[] | number | Bathroom quantities. | 2 |
| data.items[].attributes.bedrooms[] | number | Room quantities. | 3 |
| data.items[].attributes.capacityLimits[] | number | Occupancy limits when entered. | 6 |
| data.items[].attributes.ceilingHeights[] | number | Ceiling heights available. | 2.7 |
| data.items[].attributes.floors[] | number | Quantities of flooring. | 14 |
| data.items[].attributes.parkingSpaces[] | number | Number of vacancies. | 2 |
| data.items[].attributes.suites[] | number | Quantity of suites. | 1 |
| data.items[].attributes.totalAreas[] | number | Total available areas in m². | 145 |
| data.items[].attributes.unitFloor | integer | null | Unit floor. | 8 |
| data.items[].attributes.unitsOnTheFloor | integer | null | Units per floor. | 4 |
| data.items[].attributes.usableAreas[] | number | Useful areas available in m². | 112 |
| data.items[].businessType | string | null | Business entered in the item, such as SALE or RENTAL. | SALE |
| data.items[].children | array<VivaRealListing> | Child units or variations, especially in enterprises. | [] |
| data.items[].condominiumName | string | null | Name of the condominium. | Residencial Vila Verde |
| data.items[].constructionStatus | string | null | Construction stage for launches. | BUILT |
| data.items[].constructionStatusCalendar | array<object> | Construction stage schedule. | [] |
| data.items[].contractType | string | null | Advertiser/contract type, such as OWNER, BROKER, or PROPERTY_DEVELOPER. | BROKER |
| data.items[].createdAt | string | null | Ad creation date. | 2026-05-10T12:30:00.000Z |
| data.items[].decoratedVisitCalendar | array<object> | Decorated visit schedule when available. | [] |
| data.items[].description | string | null | Textual description without HTML. | Apartamento bem iluminado, com lazer completo e duas vagas. |
| data.items[].enhancedDevelopment | boolean | null | Indicates enriched enterprise. | false |
| data.items[].externalId | string | null | Identifier defined by the advertiser or integration. | CA12345 |
| data.items[].flags | record<string, string> | Relevant dynamic ad flags. | {"FEATURED":"true"} |
| data.items[].floorPlans | array<media> | Blueprints of the property or project. | [] |
| data.items[].id | string | null | Ad primary identifier. | 2787552284 |
| data.items[].legacyId | string | null | Legacy identifier when available. | 987654321 |
| data.items[].listingType | string | null | Listing type, such as USED or DEVELOPMENT. | USED |
| data.items[].media[].alt | string | null | Alternative text. | Sala do apartamento |
| data.items[].media[].id | string | null | Media identifier. | image-1 |
| data.items[].media[].seo | boolean | null | Indicates media marked for SEO. | true |
| data.items[].media[].type | string | null | Media type. | IMAGE |
| data.items[].media[].url | string | null | URL materialized from the image. | https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/imovel-1.webp |
| data.items[].mergedAmenities[] | string | Amenities consolidated by VivaReal. | POOL |
| data.items[].nonActivationReason | string | null | Reason for inactivation when applicable. | NONE |
| data.items[].noWarrantorRent | boolean | null | Indicates rental without guarantor. | false |
| data.items[].position | integer | null | Absolute position of the ad in the results. | 1 |
| data.items[].prices[].businessType | string | null | Business associated with price. | SALE |
| data.items[].prices[].condominium | number | null | Condominium fee. | 780 |
| data.items[].prices[].iptu | number | null | Value of IPTU. | 2650 |
| data.items[].prices[].iptuPeriod | string | null | Periodicity of IPTU. | YEARLY |
| data.items[].prices[].multiple | boolean | null | Indicates whether the ad represents multiple value ranges. | false |
| data.items[].prices[].rentalPeriod | string | null | Rental frequency. | MONTHLY |
| data.items[].prices[].value | number | null | Main value. | 980000 |
| data.items[].propertyDevelopers | array<developer> | Associated developers. | [] |
| data.items[].propertyType | string | null | Broad property category. | UNIT |
| data.items[].publicationType | string | null | Ad publishing level. | PREMIUM |
| data.items[].resale | boolean | null | Indicates resale property. | true |
| data.items[].showPrice | boolean | null | Indicates whether the price should be displayed. | true |
| data.items[].sourceId | string | null | Ad source identifier. | VR-SP-2787552284 |
| data.items[].stamps[] | string | Ad stamps, including Datazap when present. | Datazap |
| data.items[].status | string | null | Current status of the ad. | ACTIVE |
| data.items[].title | string | null | Ad title. | Apartamento com 3 quartos e varanda na Vila Mariana |
| data.items[].transacted | boolean | null | Indicates property already transacted. | false |
| data.items[].tripleBundle | boolean | null | Triple bundle commercial flag. | false |
| data.items[].uniqueUnit | boolean | null | Indicates single unit. | true |
| data.items[].unitSubTypes[] | string | Unit subtypes. | STANDARD |
| data.items[].unitTypes[] | string | Unit types, such as APARTMENT or HOME. | APARTMENT |
| data.items[].updatedAt | string | null | Ad update date. | 2026-07-11T18:45:00.000Z |
| data.items[].url | string | null | URL absolute publicity of the advertisement or enterprise. | https://www.vivareal.com.br/imovel/apartamento-3-quartos-vila-mariana-sao-paulo-com-garagem-112m2-venda-RS980000-id-2787552284/ |
| data.items[].usageTypes[] | string | Residential or commercial uses. | RESIDENTIAL |
| data.items[].videos | array<media> | Videos associated with the ad. | [] |
| data.items[].videoTourUrl | string | null | Video tour URL. | https://tour.example.com/2787552284 |
| data.items[].whatsappNumber | string | null | WhatsApp associated directly with the ad. | 11987654321 |
| data.meta | object | null | SEO metadata and results page heading. | {"title":"Apartamentos à venda em Vila Mariana, São Paulo","description":"Apartamentos à venda em Vila Mariana com fotos, preços e detalhes.","robots":"index,follow","primaryHeading":"Apartamentos à venda em Vila Mariana"} |
| data.meta.description | string | null | Search description SEO. | Apartamentos à venda em Vila Mariana com fotos, preços e detalhes. |
| data.meta.primaryHeading | string | null | Main heading of the results page. | Apartamentos à venda em Vila Mariana |
| data.meta.robots | string | null | Page robots directive. | index,follow |
| data.meta.title | string | null | Search title SEO. | Apartamentos à venda em Vila Mariana, São Paulo |
| data.nextPage | integer | null | Next page number or null when finished. | 2 |
| data.nextPageUrl | string | null | public URL of the next page or null when finished. | https://www.vivareal.com.br/venda/sp/sao-paulo/vila-mariana/apartamento_residencial/?pagina=2 |
| data.offset | integer | Offset of the first item on the page. | 0 |
| data.page | integer | Current page, 1-based. | 1 |
| data.parser | "1.0.0" | Stable version of the API response format. | 1.0.0 |
| data.primaryResults | integer | Quantity of primary items returned on this page. | 30 |
| data.responseUrl | string (final URL after redirects) | URL final answered by upstream, after redirects. | https://glue-api.vivareal.com/v2/listings?business=SALE&addressCity=Sao+Paulo&page=1&size=30 |
| data.resultsPerPage | integer | Page size. | 30 |
| data.searchId | string | null | Search identifier exposed by page payload when available. | vr-search-7b8f2b |
| data.source | "vivareal.com.br" | Normalized extraction source. | vivareal.com.br |
| data.totalResults | integer | Total results reported by VivaReal. | 1842 |
| data.type | "plp" | Seam PLP listing and searching. | plp |
| data.url | string (standardized public URL) | public URL corresponding to the search performed. | https://www.vivareal.com.br/venda/sp/sao-paulo/vila-mariana/apartamento_residencial/?quartos=2%2C3&precoMinimo=500000&precoMaximo=1200000&areaMinima=70&areaMaxima=180&ordem=BIGGEST_AREA |
| executionId | string (uuid) | Identifier of the asynchronous execution that produced the result. | 4c22d970-a1d0-4d3f-a688-c128e2f97302 |
| notFound | boolean (optional; true only when upstream reports a missing entity and data is null) | Present and true when the upstream reports that the entity does not exist; in this case data is null. | N/A |
| requestId | string (uuid) | Unique identifier of the request in GeckoAPI. | 4c22d970-a1d0-4d3f-a688-c128e2f97301 |
