| data.apiUrl | string | null | URL da API interna quando a busca estruturada usa Glue; pode ser null nos modos de página. | 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) | Timestamp UTC da extração. | 2026-07-12T15:40:00.000Z |
| data.facets | array<object> | Facetas dinâmicas retornadas pela API interna, quando disponíveis. | [{"name":"unitTypes","value":["APARTMENT","PENTHOUSE"]}] |
| data.filters | object | Filtros normalizados da busca estruturada ou fragmentos de URI retornados pelo VivaReal no modo URL. | {"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 | Amenidades aplicadas. | POOL |
| data.filters.areaMax | integer | null | Área útil máxima aplicada. | 180 |
| data.filters.areaMin | integer | null | Área útil mínima aplicada. | 70 |
| data.filters.bathrooms[] | integer | Quantidades de banheiros selecionadas. | 2 |
| data.filters.bedrooms[] | integer | Quantidades de quartos selecionadas. | 2 |
| data.filters.businessType | "sale" | "rent" | Tipo de negócio normalizado. | sale |
| data.filters.city | string | null | Cidade da busca. | São Paulo |
| data.filters.condominium | boolean | Indica inclusão do tipo condomínio. | false |
| data.filters.directOwner | boolean | Indica filtro por anunciante direto. | false |
| data.filters.includeLaunches | boolean | Indica se lançamentos podem aparecer. | false |
| data.filters.latitude | number | null | Latitude usada na busca por ponto. | -23.5892 |
| data.filters.longitude | number | null | Longitude usada na busca por ponto. | -46.6344 |
| data.filters.neighborhood | string | null | Bairro da busca. | Vila Mariana |
| data.filters.page | integer | Página solicitada. | 1 |
| data.filters.parkingSpots[] | integer | Quantidades de vagas selecionadas. | 1 |
| data.filters.priceMax | integer | null | Preço máximo aplicado. | 1200000 |
| data.filters.priceMin | integer | null | Preço mínimo aplicado. | 500000 |
| data.filters.propertyTypes[] | string | Tipos de imóvel normalizados. | apartment |
| data.filters.sort | string | Ordenação normalizada. | biggest_area |
| data.filters.state | string | null | UF da busca. | SP |
| data.filters.stateName | string | null | Nome completo do estado. | São Paulo |
| data.items[].acceptExchange | boolean | null | Indica aceite de permuta. | false |
| data.items[].address | object | null | Endereço e geolocalização normalizados. | {"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 | Indica localização aproximada. | false |
| data.items[].address.city | string | null | Cidade do imóvel. | São Paulo |
| data.items[].address.coordinates.latitude | number | Latitude publicada. | -23.5892 |
| data.items[].address.coordinates.longitude | number | Longitude publicada. | -46.6344 |
| data.items[].address.country | string | null | País do imóvel. | Brasil |
| data.items[].address.displayType | string | null | Política de exibição do endereço. | ALL |
| data.items[].address.fullAddress | string | null | Endereço formatado. | Rua Domingos de Morais, Vila Mariana, São Paulo - SP |
| data.items[].address.locationId | string | null | Identificador geográfico interno. | BR-SAO-PAULO-VILA-MARIANA |
| data.items[].address.nearby | object | null | Pontos e informações de proximidade disponíveis. | {"subway":"Vila Mariana","distanceMeters":450} |
| data.items[].address.neighborhood | string | null | Bairro do imóvel. | Vila Mariana |
| data.items[].address.state | string | null | Estado do imóvel. | São Paulo |
| data.items[].address.stateAcronym | string | null | UF do imóvel. | SP |
| data.items[].address.street | string | null | Logradouro quando o anúncio o divulga. | Rua Domingos de Morais |
| data.items[].address.streetNumber | string | null | Número quando divulgado. | 1200 |
| data.items[].address.zipCode | string | null | CEP do imóvel. | 04010000 |
| data.items[].address.zone | string | null | Zona da cidade. | Zona Sul |
| data.items[].advertiser.addresses | object | null | Endereços comerciais do anunciante. | {"city":"São Paulo","state":"SP"} |
| data.items[].advertiser.createdAt | string | null | Data de cadastro do anunciante. | 2018-03-09T10:00:00.000Z |
| data.items[].advertiser.id | string | null | Identificador do anunciante. | 55123 |
| data.items[].advertiser.imageUrl | string | null | Logo ou imagem do anunciante. | https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/logo.webp |
| data.items[].advertiser.legacyId | string | null | Identificador legado do anunciante. | 179386 |
| data.items[].advertiser.license | string | null | Registro profissional, como CRECI. | CRECI J-12345-SP |
| data.items[].advertiser.listingsCount | integer | null | Quantidade de anúncios do anunciante. | 169 |
| data.items[].advertiser.name | string | null | Nome do anunciante. | Imobiliária Exemplo |
| data.items[].advertiser.phoneNumbers[] | string | Telefones publicados. | 1130001000 |
| data.items[].advertiser.rating | number | null | Nota do anunciante quando exposta. | 4.7 |
| data.items[].advertiser.tier | string | null | Tier comercial do anunciante. | PREMIUM |
| data.items[].advertiser.url | string | null | Página pública do anunciante. | https://www.vivareal.com.br/imobiliaria/imobiliaria-exemplo-55123/ |
| data.items[].advertiser.verified | boolean | null | Indica anunciante verificado. | true |
| data.items[].advertiser.websiteUrl | string | null | Website externo publicado. | https://www.imobiliaria-exemplo.com.br/ |
| data.items[].advertiser.whatsappNumber | string | null | WhatsApp publicado. | 11987654321 |
| data.items[].aiAmenities[] | string | Características inferidas no payload estruturado. | NATURAL_LIGHT |
| data.items[].amenities[] | string | Amenidades declaradas no anúncio. | POOL |
| data.items[].attributes.bathrooms[] | number | Quantidades de banheiros. | 2 |
| data.items[].attributes.bedrooms[] | number | Quantidades de quartos. | 3 |
| data.items[].attributes.capacityLimits[] | number | Limites de ocupação quando informados. | 6 |
| data.items[].attributes.ceilingHeights[] | number | Pés-direitos disponíveis. | 2.7 |
| data.items[].attributes.floors[] | number | Quantidades de pavimentos. | 14 |
| data.items[].attributes.parkingSpaces[] | number | Quantidades de vagas. | 2 |
| data.items[].attributes.suites[] | number | Quantidades de suítes. | 1 |
| data.items[].attributes.totalAreas[] | number | Áreas totais disponíveis em m². | 145 |
| data.items[].attributes.unitFloor | integer | null | Andar da unidade. | 8 |
| data.items[].attributes.unitsOnTheFloor | integer | null | Unidades por andar. | 4 |
| data.items[].attributes.usableAreas[] | number | Áreas úteis disponíveis em m². | 112 |
| data.items[].businessType | string | null | Negócio informado no item, como SALE ou RENTAL. | SALE |
| data.items[].children | array<VivaRealListing> | Unidades ou variações filhas, especialmente em empreendimentos. | [] |
| data.items[].condominiumName | string | null | Nome do condomínio. | Residencial Vila Verde |
| data.items[].constructionStatus | string | null | Estágio da obra para lançamentos. | BUILT |
| data.items[].constructionStatusCalendar | array<object> | Cronograma de estágios da construção. | [] |
| data.items[].contractType | string | null | Tipo de anunciante/contrato, como OWNER, BROKER ou PROPERTY_DEVELOPER. | BROKER |
| data.items[].createdAt | string | null | Data de criação do anúncio. | 2026-05-10T12:30:00.000Z |
| data.items[].decoratedVisitCalendar | array<object> | Agenda de visita ao decorado quando disponível. | [] |
| data.items[].description | string | null | Descrição textual sem HTML. | Apartamento bem iluminado, com lazer completo e duas vagas. |
| data.items[].enhancedDevelopment | boolean | null | Indica empreendimento enriquecido. | false |
| data.items[].externalId | string | null | Identificador definido pelo anunciante ou integração. | CA12345 |
| data.items[].flags | record<string, string> | Flags dinâmicas relevantes do anúncio. | {"FEATURED":"true"} |
| data.items[].floorPlans | array<media> | Plantas do imóvel ou empreendimento. | [] |
| data.items[].id | string | null | Identificador principal do anúncio. | 2787552284 |
| data.items[].legacyId | string | null | Identificador legado quando disponível. | 987654321 |
| data.items[].listingType | string | null | Tipo de listagem, como USED ou DEVELOPMENT. | USED |
| data.items[].media[].alt | string | null | Texto alternativo. | Sala do apartamento |
| data.items[].media[].id | string | null | Identificador da mídia. | image-1 |
| data.items[].media[].seo | boolean | null | Indica mídia marcada para SEO. | true |
| data.items[].media[].type | string | null | Tipo da mídia. | IMAGE |
| data.items[].media[].url | string | null | URL materializada da imagem. | https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/imovel-1.webp |
| data.items[].mergedAmenities[] | string | Amenidades consolidadas pelo VivaReal. | POOL |
| data.items[].nonActivationReason | string | null | Motivo de inativação quando aplicável. | NONE |
| data.items[].noWarrantorRent | boolean | null | Indica aluguel sem fiador. | false |
| data.items[].position | integer | null | Posição absoluta do anúncio nos resultados. | 1 |
| data.items[].prices[].businessType | string | null | Negócio associado ao preço. | SALE |
| data.items[].prices[].condominium | number | null | Taxa de condomínio. | 780 |
| data.items[].prices[].iptu | number | null | Valor de IPTU. | 2650 |
| data.items[].prices[].iptuPeriod | string | null | Periodicidade do IPTU. | YEARLY |
| data.items[].prices[].multiple | boolean | null | Indica se o anúncio representa múltiplas faixas de valor. | false |
| data.items[].prices[].rentalPeriod | string | null | Periodicidade do aluguel. | MONTHLY |
| data.items[].prices[].value | number | null | Valor principal. | 980000 |
| data.items[].propertyDevelopers | array<developer> | Incorporadoras associadas. | [] |
| data.items[].propertyType | string | null | Categoria ampla do imóvel. | UNIT |
| data.items[].publicationType | string | null | Nível de publicação do anúncio. | PREMIUM |
| data.items[].resale | boolean | null | Indica imóvel de revenda. | true |
| data.items[].showPrice | boolean | null | Indica se o preço deve ser exibido. | true |
| data.items[].sourceId | string | null | Identificador da fonte do anúncio. | VR-SP-2787552284 |
| data.items[].stamps[] | string | Selos do anúncio, incluindo Datazap quando presente. | Datazap |
| data.items[].status | string | null | Status atual do anúncio. | ACTIVE |
| data.items[].title | string | null | Título do anúncio. | Apartamento com 3 quartos e varanda na Vila Mariana |
| data.items[].transacted | boolean | null | Indica imóvel já transacionado. | false |
| data.items[].tripleBundle | boolean | null | Flag comercial triple bundle. | false |
| data.items[].uniqueUnit | boolean | null | Indica unidade única. | true |
| data.items[].unitSubTypes[] | string | Subtipos de unidade. | STANDARD |
| data.items[].unitTypes[] | string | Tipos de unidade, como APARTMENT ou HOME. | APARTMENT |
| data.items[].updatedAt | string | null | Data de atualização do anúncio. | 2026-07-11T18:45:00.000Z |
| data.items[].url | string | null | URL pública absoluta do anúncio ou empreendimento. | https://www.vivareal.com.br/imovel/apartamento-3-quartos-vila-mariana-sao-paulo-com-garagem-112m2-venda-RS980000-id-2787552284/ |
| data.items[].usageTypes[] | string | Usos residencial ou comercial. | RESIDENTIAL |
| data.items[].videos | array<media> | Vídeos associados ao anúncio. | [] |
| data.items[].videoTourUrl | string | null | URL de tour em vídeo. | https://tour.example.com/2787552284 |
| data.items[].whatsappNumber | string | null | WhatsApp associado diretamente ao anúncio. | 11987654321 |
| data.meta | object | null | Metadados SEO e heading da página de resultados. | {"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 | Descrição SEO da busca. | Apartamentos à venda em Vila Mariana com fotos, preços e detalhes. |
| data.meta.primaryHeading | string | null | Heading principal da página de resultados. | Apartamentos à venda em Vila Mariana |
| data.meta.robots | string | null | Diretiva robots da página. | index,follow |
| data.meta.title | string | null | Título SEO da busca. | Apartamentos à venda em Vila Mariana, São Paulo |
| data.nextPage | integer | null | Número da próxima página ou null quando terminou. | 2 |
| data.nextPageUrl | string | null | URL pública da próxima página ou null quando terminou. | https://www.vivareal.com.br/venda/sp/sao-paulo/vila-mariana/apartamento_residencial/?pagina=2 |
| data.offset | integer | Offset do primeiro item da página. | 0 |
| data.page | integer | Página atual, 1-based. | 1 |
| data.parser | "glue_api" | "next_flight" | "jsonld" | Fonte estruturada usada: API interna Glue, payload Next Flight ou fallback JSON-LD. | glue_api |
| data.primaryResults | integer | Quantidade de itens primários retornados nesta página. | 30 |
| data.responseUrl | string (URL final após redirects) | URL final respondida pelo upstream, após redirects. | https://glue-api.vivareal.com/v2/listings?business=SALE&addressCity=Sao+Paulo&page=1&size=30 |
| data.resultsPerPage | integer | Tamanho da página. | 30 |
| data.searchId | string | null | Identificador de busca exposto pelo payload da página quando disponível. | vr-search-7b8f2b |
| data.source | "vivareal.com.br" | Fonte normalizada da extração. | vivareal.com.br |
| data.totalResults | integer | Total de resultados informado pelo VivaReal. | 1842 |
| data.type | "plp" | Seam PLP de listagem e busca. | plp |
| data.url | string (URL pública normalizada) | URL pública correspondente à busca executada. | 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) | Identificador da execução assíncrona que produziu o resultado. | 4c22d970-a1d0-4d3f-a688-c128e2f97302 |
| notFound | boolean (optional; true only when upstream reports a missing entity and data is null) | Presente e true quando o upstream informa que a entidade não existe; nesse caso data é null. | N/A |
| requestId | string (uuid) | Identificador único da requisição na GeckoAPI. | 4c22d970-a1d0-4d3f-a688-c128e2f97301 |
