GeckoAPI
PT EN
Entrar Testar URL

// docs

VivaReal PDP

Extrai todos os detalhes relevantes de um imóvel ou empreendimento do VivaReal, incluindo status, preços, atributos, endereço, anunciante, mídia, plantas, unidades e dados de construção.

Nota importante: alguns campos podem retornar null em produção, dependendo da página de origem. Nesta documentação, os exemplos de output são preenchidos intencionalmente com valores não nulos para facilitar integração.

Quando a entidade consultada não existe na origem, o extract e a tool MCP retornam 200 com data: null e notFound: true. Esse caso é tratado como resposta concluída, não como erro de servidor.

Chamada HTTP

cURL 
curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "vivareal.com.br",
  "type": "pdp",
  "url": "https://www.vivareal.com.br/imovel/sobrado-3-quartos-vila-albertina-zona-norte-sao-paulo-com-garagem-94m2-venda-RS450000-id-2787552284/"
}'

Chamada MCP

A mesma seam também aparece no MCP hospedado como uma tool dedicada. Os argumentos reaproveitam os campos do extract, mas target e type já ficam fixos pela tool.

Ver guia completo do MCP

Endpoint

POST /v1/mcp

Tool name

vivareal_com_br_pdp

Auth

Bearer ou X-API-Key

vivareal_com_br_pdp tools/call 
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "vivareal_com_br_pdp",
    "arguments": {
      "url": "https://www.vivareal.com.br/imovel/sobrado-3-quartos-vila-albertina-zona-norte-sao-paulo-com-garagem-94m2-venda-RS450000-id-2787552284/",
      "executionId": "exec_example_123"
    }
  }
}

Possibilidades de input

Campos suportados nesta API do POST /v1/extract, com regras específicas de obrigatoriedade e condicionais.

Campo Tipo Status Regra Default Exemplo
url
URL alvo da extração. Para alguns PLPs pode ser omitida quando a API monta a URL a partir de outros campos.
 string (URL) Obrigatório URL pública de um imóvel ou empreendimento no domínio vivareal.com.br. O path deve conter -id-<listingId>. - https://www.mercadolivre.com.br/p/MLB123456
target
Fonte alvo da extração.
 enum Obrigatório Sempre obrigatório e deve ser vivareal.com.br. - mercadolivre.com.br
type
Tipo da extração: pdp, idp, plp, ilp, quote, review ou places.
 enum Obrigatório Sempre obrigatório e deve ser pdp. - pdp

Exemplos de request

Imóvel para venda

Envie a URL pública de um anúncio de venda no VivaReal.

Imóvel para venda 
{
  "target": "vivareal.com.br",
  "type": "pdp",
  "url": "https://www.vivareal.com.br/imovel/sobrado-3-quartos-vila-albertina-zona-norte-sao-paulo-com-garagem-94m2-venda-RS450000-id-2787552284/"
}

Imóvel para aluguel

O mesmo endpoint cobre imóveis para aluguel e preserva preços e periodicidade da locação.

Imóvel para aluguel 
{
  "target": "vivareal.com.br",
  "type": "pdp",
  "url": "https://www.vivareal.com.br/imovel/casa-3-quartos-rio-cerro-ii-jaragua-do-sul-com-garagem-110m2-aluguel-RS2000-id-2898151977/"
}

Empreendimento ou lançamento

URLs de lançamentos retornam incorporadora, estágio de construção, plantas e unidades filhas quando publicados.

Empreendimento ou lançamento 
{
  "target": "vivareal.com.br",
  "type": "pdp",
  "url": "https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/"
}

Schema de response (leaf paths)

Mapa de paths de saída com tipo esperado para esta API.

responseSchema 
{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "notFound": "boolean (optional; true when the VivaReal listing is unavailable as a missing entity and data is null)",
  "data.source": "\"vivareal.com.br\"",
  "data.type": "\"pdp\"",
  "data.parser": "\"next_flight\" | \"jsonld\"",
  "data.url": "string (requested URL)",
  "data.responseUrl": "string (URL after redirects)",
  "data.canonicalUrl": "string (canonical listing URL)",
  "data.extractedAt": "string (ISO datetime)",
  "data.listing.id": "string | null",
  "data.listing.sourceId": "string | null",
  "data.listing.externalId": "string | null",
  "data.listing.legacyId": "string | null",
  "data.listing.title": "string | null",
  "data.listing.description": "string | null",
  "data.listing.url": "string | null",
  "data.listing.businessType": "string | null",
  "data.listing.listingType": "string | null",
  "data.listing.propertyType": "string | null",
  "data.listing.unitTypes[]": "string",
  "data.listing.unitSubTypes[]": "string",
  "data.listing.usageTypes[]": "string",
  "data.listing.contractType": "string | null",
  "data.listing.publicationType": "string | null",
  "data.listing.status": "string | null",
  "data.listing.nonActivationReason": "string | null",
  "data.listing.constructionStatus": "string | null",
  "data.listing.condominiumName": "string | null",
  "data.listing.createdAt": "string | null",
  "data.listing.updatedAt": "string | null",
  "data.listing.prices[].businessType": "string | null",
  "data.listing.prices[].value": "number | null",
  "data.listing.prices[].condominium": "number | null",
  "data.listing.prices[].iptu": "number | null",
  "data.listing.prices[].iptuPeriod": "string | null",
  "data.listing.prices[].rentalPeriod": "string | null",
  "data.listing.prices[].multiple": "boolean | null",
  "data.listing.attributes.usableAreas[]": "number",
  "data.listing.attributes.totalAreas[]": "number",
  "data.listing.attributes.bedrooms[]": "number",
  "data.listing.attributes.bathrooms[]": "number",
  "data.listing.attributes.suites[]": "number",
  "data.listing.attributes.parkingSpaces[]": "number",
  "data.listing.attributes.floors[]": "number",
  "data.listing.attributes.unitFloor": "integer | null",
  "data.listing.attributes.unitsOnTheFloor": "integer | null",
  "data.listing.attributes.ceilingHeights[]": "number",
  "data.listing.attributes.capacityLimits[]": "number",
  "data.listing.address.country": "string | null",
  "data.listing.address.state": "string | null",
  "data.listing.address.stateAcronym": "string | null",
  "data.listing.address.city": "string | null",
  "data.listing.address.zone": "string | null",
  "data.listing.address.neighborhood": "string | null",
  "data.listing.address.street": "string | null",
  "data.listing.address.streetNumber": "string | null",
  "data.listing.address.zipCode": "string | null",
  "data.listing.address.fullAddress": "string | null",
  "data.listing.address.locationId": "string | null",
  "data.listing.address.displayType": "string | null",
  "data.listing.address.approximate": "boolean | null",
  "data.listing.address.coordinates.latitude": "number",
  "data.listing.address.coordinates.longitude": "number",
  "data.listing.address.nearby": "object | null",
  "data.listing.amenities[]": "string",
  "data.listing.mergedAmenities[]": "string",
  "data.listing.aiAmenities[]": "string",
  "data.listing.stamps[]": "string",
  "data.listing.flags": "record<string, string>",
  "data.listing.advertiser.id": "string | null",
  "data.listing.advertiser.legacyId": "string | null",
  "data.listing.advertiser.name": "string | null",
  "data.listing.advertiser.url": "string | null",
  "data.listing.advertiser.tier": "string | null",
  "data.listing.advertiser.license": "string | null",
  "data.listing.advertiser.createdAt": "string | null",
  "data.listing.advertiser.verified": "boolean | null",
  "data.listing.advertiser.listingsCount": "integer | null",
  "data.listing.advertiser.rating": "number | null",
  "data.listing.advertiser.imageUrl": "string | null",
  "data.listing.advertiser.websiteUrl": "string | null",
  "data.listing.advertiser.phoneNumbers[]": "string",
  "data.listing.advertiser.whatsappNumber": "string | null",
  "data.listing.advertiser.addresses": "object | null",
  "data.listing.media[].id": "string | null",
  "data.listing.media[].type": "string | null",
  "data.listing.media[].url": "string | null",
  "data.listing.media[].alt": "string | null",
  "data.listing.media[].seo": "boolean | null",
  "data.listing.videos[].url": "string | null",
  "data.listing.floorPlans[].url": "string | null",
  "data.listing.propertyDevelopers[].id": "string | null",
  "data.listing.propertyDevelopers[].name": "string | null",
  "data.listing.propertyDevelopers[].logoUrl": "string | null",
  "data.listing.propertyDevelopers[].url": "string | null",
  "data.listing.propertyDevelopers[].details": "object",
  "data.listing.children": "array<VivaRealListing>",
  "data.listing.showPrice": "boolean | null",
  "data.listing.acceptExchange": "boolean | null",
  "data.listing.resale": "boolean | null",
  "data.listing.transacted": "boolean | null",
  "data.listing.uniqueUnit": "boolean | null",
  "data.listing.noWarrantorRent": "boolean | null",
  "data.listing.enhancedDevelopment": "boolean | null",
  "data.listing.tripleBundle": "boolean | null",
  "data.listing.videoTourUrl": "string | null",
  "data.listing.whatsappNumber": "string | null",
  "data.listing.decoratedVisitCalendar": "array<object>",
  "data.listing.constructionStatusCalendar": "array<object>",
  "data.meta.title": "string | null",
  "data.meta.description": "string | null",
  "data.meta.robots": "string | null",
  "data.meta.primaryHeading": "string | null",
  "data.formattedAddress": "string | null",
  "data.status": "string | null",
  "data.nonActivationReason": "string | null",
  "data.createdAt": "string | null",
  "data.updatedAt": "string | null",
  "data.condominiumName": "string | null",
  "data.verifiedAdvertiser": "boolean | null",
  "data.advertiserListingsCount": "integer | null",
  "data.isAbmiPartner": "boolean | null",
  "data.canEstimatePrices": "boolean | null",
  "data.whatsappNumber": "string | null",
  "data.virtualTourUrl": "string | null",
  "data.videos[].id": "string | null",
  "data.videos[].type": "string | null",
  "data.videos[].url": "string | null",
  "data.videos[].alt": "string | null",
  "data.videos[].seo": "boolean | null",
  "data.breadcrumbs[].name": "string | null",
  "data.breadcrumbs[].url": "string | null",
  "data.breadcrumbs[].rel": "string | null",
  "data.relatedLinks[].name": "string | null",
  "data.relatedLinks[].url": "string | null",
  "data.relatedLinks[].rel": "string | null",
  "data.infoTags": "record<string, unknown>",
  "data.neighborhoodGuide": "array<unknown>",
  "data.constructionStatusCalendar": "array<unknown>"
}

Exemplo de response

responseExample 
{
  "requestId": "7ce87315-3a25-451f-b58c-cd65287a2601",
  "executionId": "7ce87315-3a25-451f-b58c-cd65287a2602",
  "data": {
    "source": "vivareal.com.br",
    "type": "pdp",
    "parser": "next_flight",
    "url": "https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/",
    "responseUrl": "https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/",
    "canonicalUrl": "https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/",
    "extractedAt": "2026-07-12T15:55:00.000Z",
    "listing": {
      "id": "2898122891",
      "sourceId": "VR-DEV-2898122891",
      "externalId": "EVORA-RESIDENCE",
      "legacyId": "77122891",
      "title": "Évora Residence",
      "description": "Empreendimento residencial com apartamentos, lazer completo e plantas variadas.",
      "url": "https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/",
      "businessType": "SALE",
      "listingType": "DEVELOPMENT",
      "propertyType": "DEVELOPMENT",
      "unitTypes": [
        "APARTMENT"
      ],
      "unitSubTypes": [
        "STANDARD"
      ],
      "usageTypes": [
        "RESIDENTIAL"
      ],
      "contractType": "PROPERTY_DEVELOPER",
      "publicationType": "PREMIUM",
      "status": "ACTIVE",
      "nonActivationReason": "NONE",
      "constructionStatus": "UNDER_CONSTRUCTION",
      "condominiumName": "Évora Residence",
      "createdAt": "2026-03-10T10:00:00.000Z",
      "updatedAt": "2026-07-11T18:20:00.000Z",
      "prices": [
        {
          "businessType": "SALE",
          "value": 620000,
          "condominium": 620,
          "iptu": 1800,
          "iptuPeriod": "YEARLY",
          "rentalPeriod": "MONTHLY",
          "multiple": true
        }
      ],
      "attributes": {
        "usableAreas": [
          67,
          84,
          112
        ],
        "totalAreas": [
          92,
          118,
          146
        ],
        "bedrooms": [
          2,
          3
        ],
        "bathrooms": [
          2,
          3
        ],
        "suites": [
          1,
          2
        ],
        "parkingSpaces": [
          1,
          2
        ],
        "floors": [
          18
        ],
        "unitFloor": 7,
        "unitsOnTheFloor": 6,
        "ceilingHeights": [
          2.7
        ],
        "capacityLimits": [
          6
        ]
      },
      "address": {
        "country": "Brasil",
        "state": "São Paulo",
        "stateAcronym": "SP",
        "city": "São Paulo",
        "zone": "Zona Sul",
        "neighborhood": "Vila Mariana",
        "street": "Rua Exemplo",
        "streetNumber": "500",
        "zipCode": "04010000",
        "fullAddress": "Rua Exemplo, 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": 550
        }
      },
      "amenities": [
        "POOL",
        "GYM",
        "PLAYGROUND",
        "BALCONY"
      ],
      "mergedAmenities": [
        "POOL",
        "GYM",
        "PARTY_HALL"
      ],
      "aiAmenities": [
        "OPEN_VIEW",
        "NATURAL_LIGHT"
      ],
      "stamps": [
        "LAUNCH"
      ],
      "flags": {
        "FEATURED": "true"
      },
      "advertiser": {
        "id": "dev-4201",
        "legacyId": "4201",
        "name": "Incorporadora Exemplo",
        "url": "https://www.vivareal.com.br/imobiliaria/incorporadora-exemplo-4201/",
        "tier": "PREMIUM",
        "license": "CRECI J-12345-SP",
        "createdAt": "2017-04-20T10:00:00.000Z",
        "verified": true,
        "listingsCount": 24,
        "rating": 4.8,
        "imageUrl": "https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/incorporadora-logo.webp",
        "websiteUrl": "https://www.incorporadora-exemplo.com.br/",
        "phoneNumbers": [
          "1130002000"
        ],
        "whatsappNumber": "11987650000",
        "addresses": {
          "city": "São Paulo",
          "state": "SP"
        }
      },
      "media": [
        {
          "id": "image-hero",
          "type": "IMAGE",
          "url": "https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/evora-hero.webp",
          "alt": "Fachada do Évora Residence",
          "seo": true
        }
      ],
      "videos": [
        {
          "id": "video-1",
          "type": "VIDEO",
          "url": "https://video.example.com/evora-residence",
          "alt": "Vídeo do empreendimento",
          "seo": false
        }
      ],
      "floorPlans": [
        {
          "id": "floor-plan-84",
          "type": "FLOOR_PLAN",
          "url": "https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/evora-planta-84.webp",
          "alt": "Planta de 84 m²",
          "seo": true
        }
      ],
      "propertyDevelopers": [
        {
          "id": "dev-4201",
          "name": "Incorporadora Exemplo",
          "logoUrl": "https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/incorporadora-logo.webp",
          "url": "https://www.vivareal.com.br/imobiliaria/incorporadora-exemplo-4201/",
          "details": {
            "role": "DEVELOPER",
            "verified": true
          }
        }
      ],
      "children": [
        {
          "id": "unit-84-3",
          "title": "Apartamento de 84 m² com 3 quartos",
          "unitTypes": [
            "APARTMENT"
          ],
          "prices": [
            {
              "businessType": "SALE",
              "value": 790000
            }
          ]
        }
      ],
      "showPrice": true,
      "acceptExchange": false,
      "resale": false,
      "transacted": false,
      "uniqueUnit": false,
      "noWarrantorRent": false,
      "enhancedDevelopment": true,
      "tripleBundle": false,
      "videoTourUrl": "https://tour.example.com/evora-residence",
      "whatsappNumber": "11987650000",
      "decoratedVisitCalendar": [
        {
          "weekday": "SATURDAY",
          "available": true
        }
      ],
      "constructionStatusCalendar": [
        {
          "status": "LAUNCH",
          "date": "2026-03"
        },
        {
          "status": "DELIVERY",
          "date": "2028-06"
        }
      ]
    },
    "meta": {
      "title": "Évora Residence - apartamentos à venda",
      "description": "Conheça plantas, preços e detalhes do Évora Residence.",
      "robots": "index,follow",
      "primaryHeading": "Évora Residence"
    },
    "formattedAddress": "Rua Exemplo, Vila Mariana, São Paulo - SP",
    "status": "ACTIVE",
    "nonActivationReason": "NONE",
    "createdAt": "2026-03-10T10:00:00.000Z",
    "updatedAt": "2026-07-11T18:20:00.000Z",
    "condominiumName": "Évora Residence",
    "verifiedAdvertiser": true,
    "advertiserListingsCount": 24,
    "isAbmiPartner": false,
    "canEstimatePrices": true,
    "whatsappNumber": "11987650000",
    "virtualTourUrl": "https://tour.example.com/evora-residence",
    "videos": [
      {
        "id": "video-1",
        "type": "VIDEO",
        "url": "https://video.example.com/evora-residence",
        "alt": "Vídeo do empreendimento",
        "seo": false
      }
    ],
    "breadcrumbs": [
      {
        "name": "Imóveis",
        "url": "https://www.vivareal.com.br/",
        "rel": "up"
      },
      {
        "name": "Lançamentos em São Paulo",
        "url": "https://www.vivareal.com.br/imoveis-lancamento/sao-paulo/",
        "rel": "up"
      }
    ],
    "relatedLinks": [
      {
        "name": "Apartamentos na Vila Mariana",
        "url": "https://www.vivareal.com.br/venda/sp/sao-paulo/vila-mariana/apartamento_residencial/",
        "rel": "related"
      }
    ],
    "infoTags": {
      "financing": true,
      "decoratedUnit": true
    },
    "neighborhoodGuide": [
      {
        "name": "Vila Mariana",
        "description": "Bairro com acesso a metrô, serviços e parques."
      }
    ],
    "constructionStatusCalendar": [
      {
        "status": "LAUNCH",
        "date": "2026-03"
      },
      {
        "status": "DELIVERY",
        "date": "2028-06"
      }
    ]
  }
}

Referência completa de campos

Path Tipo Descrição Exemplo
data.advertiserListingsCount integer | null Quantidade de anúncios da conta. 24
data.breadcrumbs[].name string | null Rótulo do breadcrumb. Imóveis
data.breadcrumbs[].rel string | null Relação do link. up
data.breadcrumbs[].url string | null URL absoluta do breadcrumb. https://www.vivareal.com.br/
data.canEstimatePrices boolean | null Indica se a página permite estimativas de preço. true
data.canonicalUrl string (canonical listing URL) URL canônica encontrada nos dados do imóvel. https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/
data.condominiumName string | null Nome de condomínio exposto pela página. Évora Residence
data.constructionStatusCalendar array<unknown> Cronograma de construção exposto no nível da página. [{"status":"LAUNCH","date":"2026-03"},{"status":"DELIVERY","date":"2028-06"}]
data.createdAt string | null Data de criação exposta pela página. 2026-03-10T10:00:00.000Z
data.extractedAt string (ISO datetime) Timestamp UTC da extração. 2026-07-12T15:55:00.000Z
data.formattedAddress string | null Endereço formatado exibido na página. Rua Exemplo, Vila Mariana, São Paulo - SP
data.infoTags record<string, unknown> Tags e informações adicionais da página. {"financing":true,"decoratedUnit":true}
data.isAbmiPartner boolean | null Indica parceiro ABMI. false
data.listing.acceptExchange boolean | null Indica aceite de permuta. false
data.listing.address.approximate boolean | null Indica localização aproximada. false
data.listing.address.city string | null Cidade. São Paulo
data.listing.address.coordinates.latitude number Latitude publicada. -23.5892
data.listing.address.coordinates.longitude number Longitude publicada. -46.6344
data.listing.address.country string | null País. Brasil
data.listing.address.displayType string | null Política de exibição do endereço. ALL
data.listing.address.fullAddress string | null Endereço formatado. Rua Exemplo, Vila Mariana, São Paulo - SP
data.listing.address.locationId string | null Identificador geográfico interno. BR-SAO-PAULO-VILA-MARIANA
data.listing.address.nearby object | null Pontos e informações de proximidade. {"subway":"Vila Mariana","distanceMeters":550}
data.listing.address.neighborhood string | null Bairro. Vila Mariana
data.listing.address.state string | null Estado. São Paulo
data.listing.address.stateAcronym string | null UF. SP
data.listing.address.street string | null Logradouro quando divulgado. Rua Exemplo
data.listing.address.streetNumber string | null Número quando divulgado. 500
data.listing.address.zipCode string | null CEP. 04010000
data.listing.address.zone string | null Zona da cidade. Zona Sul
data.listing.advertiser.addresses object | null Endereços comerciais publicados. {"city":"São Paulo","state":"SP"}
data.listing.advertiser.createdAt string | null Data de cadastro. 2017-04-20T10:00:00.000Z
data.listing.advertiser.id string | null Identificador do anunciante. dev-4201
data.listing.advertiser.imageUrl string | null Logo ou imagem. https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/incorporadora-logo.webp
data.listing.advertiser.legacyId string | null Identificador legado do anunciante. 4201
data.listing.advertiser.license string | null Registro profissional, como CRECI. CRECI J-12345-SP
data.listing.advertiser.listingsCount integer | null Quantidade de anúncios publicados. 24
data.listing.advertiser.name string | null Nome comercial. Incorporadora Exemplo
data.listing.advertiser.phoneNumbers[] string Telefones publicados. 1130002000
data.listing.advertiser.rating number | null Nota agregada quando disponível. 4.8
data.listing.advertiser.tier string | null Tier comercial. PREMIUM
data.listing.advertiser.url string | null Página pública do anunciante. https://www.vivareal.com.br/imobiliaria/incorporadora-exemplo-4201/
data.listing.advertiser.verified boolean | null Indica anunciante verificado. true
data.listing.advertiser.websiteUrl string | null Website externo. https://www.incorporadora-exemplo.com.br/
data.listing.advertiser.whatsappNumber string | null WhatsApp publicado. 11987650000
data.listing.aiAmenities[] string Características inferidas no payload estruturado. OPEN_VIEW
data.listing.amenities[] string Amenidades declaradas. POOL
data.listing.attributes.bathrooms[] number Quantidades de banheiros. 2
data.listing.attributes.bedrooms[] number Quantidades de quartos. 2
data.listing.attributes.capacityLimits[] number Limites de ocupação publicados. 6
data.listing.attributes.ceilingHeights[] number Pés-direitos publicados. 2.7
data.listing.attributes.floors[] number Quantidade de pavimentos. 18
data.listing.attributes.parkingSpaces[] number Quantidades de vagas. 1
data.listing.attributes.suites[] number Quantidades de suítes. 1
data.listing.attributes.totalAreas[] number Áreas totais em m². 92
data.listing.attributes.unitFloor integer | null Andar da unidade quando aplicável. 7
data.listing.attributes.unitsOnTheFloor integer | null Unidades por andar. 6
data.listing.attributes.usableAreas[] number Áreas úteis disponíveis em m². 67
data.listing.businessType string | null Negócio, como SALE ou RENTAL. SALE
data.listing.children array<VivaRealListing> Unidades/variações do empreendimento, preservadas no mesmo modelo de listing. [{"id":"unit-84-3","title":"Apartamento de 84 m² com 3 quartos","unitTypes":["APARTMENT"],"prices":[{"businessType":"SALE","value":790000}]}]
data.listing.condominiumName string | null Nome do condomínio ou empreendimento. Évora Residence
data.listing.constructionStatus string | null Estágio atual da construção. UNDER_CONSTRUCTION
data.listing.constructionStatusCalendar array<object> Cronograma de construção associado ao listing. [{"status":"LAUNCH","date":"2026-03"},{"status":"DELIVERY","date":"2028-06"}]
data.listing.contractType string | null Tipo de contrato/anunciante, incluindo OWNER e PROPERTY_DEVELOPER. PROPERTY_DEVELOPER
data.listing.createdAt string | null Data de criação do anúncio. 2026-03-10T10:00:00.000Z
data.listing.decoratedVisitCalendar array<object> Agenda de visita ao decorado. [{"weekday":"SATURDAY","available":true}]
data.listing.description string | null Descrição textual sem HTML. Empreendimento residencial com apartamentos, lazer completo e plantas variadas.
data.listing.enhancedDevelopment boolean | null Indica empreendimento enriquecido. true
data.listing.externalId string | null Identificador externo definido pelo anunciante. EVORA-RESIDENCE
data.listing.flags record<string, string> Flags dinâmicas relevantes. {"FEATURED":"true"}
data.listing.floorPlans[].url string | null URL de planta da unidade ou empreendimento. https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/evora-planta-84.webp
data.listing.id string | null Identificador principal do anúncio ou empreendimento. 2898122891
data.listing.legacyId string | null Identificador legado quando disponível. 77122891
data.listing.listingType string | null Tipo de listagem, como USED ou DEVELOPMENT. DEVELOPMENT
data.listing.media[].alt string | null Texto alternativo. Fachada do Évora Residence
data.listing.media[].id string | null Identificador da mídia. image-hero
data.listing.media[].seo boolean | null Indica mídia priorizada para SEO. true
data.listing.media[].type string | null Tipo da mídia. IMAGE
data.listing.media[].url string | null URL materializada da imagem. https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/evora-hero.webp
data.listing.mergedAmenities[] string Amenidades consolidadas pelo VivaReal. POOL
data.listing.nonActivationReason string | null Motivo de inativação, quando aplicável. NONE
data.listing.noWarrantorRent boolean | null Indica aluguel sem fiador. false
data.listing.prices[].businessType string | null Negócio associado ao preço. SALE
data.listing.prices[].condominium number | null Taxa de condomínio. 620
data.listing.prices[].iptu number | null Valor de IPTU. 1800
data.listing.prices[].iptuPeriod string | null Periodicidade do IPTU. YEARLY
data.listing.prices[].multiple boolean | null Indica múltiplas faixas de preço, comum em empreendimentos. true
data.listing.prices[].rentalPeriod string | null Periodicidade do aluguel. MONTHLY
data.listing.prices[].value number | null Valor principal. 620000
data.listing.propertyDevelopers[].details object Dados adicionais publicados sobre a incorporadora. {"role":"DEVELOPER","verified":true}
data.listing.propertyDevelopers[].id string | null Identificador da incorporadora. dev-4201
data.listing.propertyDevelopers[].logoUrl string | null Logo da incorporadora. https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/incorporadora-logo.webp
data.listing.propertyDevelopers[].name string | null Nome da incorporadora. Incorporadora Exemplo
data.listing.propertyDevelopers[].url string | null Página pública da incorporadora. https://www.vivareal.com.br/imobiliaria/incorporadora-exemplo-4201/
data.listing.propertyType string | null Categoria ampla da propriedade. DEVELOPMENT
data.listing.publicationType string | null Nível de publicação. PREMIUM
data.listing.resale boolean | null Indica imóvel de revenda. false
data.listing.showPrice boolean | null Indica se o preço deve ser exibido. true
data.listing.sourceId string | null Identificador da fonte do anúncio. VR-DEV-2898122891
data.listing.stamps[] string Selos do anúncio. LAUNCH
data.listing.status string | null Status atual do anúncio. ACTIVE
data.listing.title string | null Título publicado. Évora Residence
data.listing.transacted boolean | null Indica imóvel já transacionado. false
data.listing.tripleBundle boolean | null Flag comercial triple bundle. false
data.listing.uniqueUnit boolean | null Indica unidade única. false
data.listing.unitSubTypes[] string Subtipos de unidade. STANDARD
data.listing.unitTypes[] string Tipos de unidade publicados. APARTMENT
data.listing.updatedAt string | null Última atualização. 2026-07-11T18:20:00.000Z
data.listing.url string | null URL absoluta do imóvel. https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/
data.listing.usageTypes[] string Usos residencial ou comercial. RESIDENTIAL
data.listing.videos[].url string | null URL de vídeo do anúncio. https://video.example.com/evora-residence
data.listing.videoTourUrl string | null Tour em vídeo associado ao listing. https://tour.example.com/evora-residence
data.listing.whatsappNumber string | null WhatsApp associado ao listing. 11987650000
data.meta.description string | null Descrição SEO. Conheça plantas, preços e detalhes do Évora Residence.
data.meta.primaryHeading string | null Heading principal. Évora Residence
data.meta.robots string | null Diretiva robots. index,follow
data.meta.title string | null Título SEO. Évora Residence - apartamentos à venda
data.neighborhoodGuide array<unknown> Conteúdo estruturado do guia do bairro quando disponível. [{"name":"Vila Mariana","description":"Bairro com acesso a metrô, serviços e parques."}]
data.nonActivationReason string | null Motivo de inativação no nível da página. NONE
data.parser "next_flight" | "jsonld" Parser estruturado usado: payload Next Flight ou fallback JSON-LD. next_flight
data.relatedLinks[].name string | null Rótulo do link relacionado. Apartamentos na Vila Mariana
data.relatedLinks[].rel string | null Relação do link relacionado. related
data.relatedLinks[].url string | null URL relacionada. https://www.vivareal.com.br/venda/sp/sao-paulo/vila-mariana/apartamento_residencial/
data.responseUrl string (URL after redirects) URL final após redirects. https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/
data.source "vivareal.com.br" Fonte normalizada da extração. vivareal.com.br
data.status string | null Status de página do anúncio. ACTIVE
data.type "pdp" Seam PDP de detalhes do imóvel. pdp
data.updatedAt string | null Data de atualização exposta pela página. 2026-07-11T18:20:00.000Z
data.url string (requested URL) URL originalmente solicitada. https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/
data.verifiedAdvertiser boolean | null Indica se a conta anunciante é verificada. true
data.videos[].alt string | null Texto alternativo do vídeo. Vídeo do empreendimento
data.videos[].id string | null Identificador do vídeo de página. video-1
data.videos[].seo boolean | null Indica priorização de SEO. false
data.videos[].type string | null Tipo de mídia do vídeo. VIDEO
data.videos[].url string | null URL do vídeo. https://video.example.com/evora-residence
data.virtualTourUrl string | null URL de tour virtual. https://tour.example.com/evora-residence
data.whatsappNumber string | null WhatsApp de contato publicado pela página. 11987650000
executionId string (uuid) Identificador da execução que produziu o resultado. 7ce87315-3a25-451f-b58c-cd65287a2602
notFound boolean (optional; true when the VivaReal listing is unavailable as a missing entity and data is null) Presente e true quando o anúncio não existe no upstream; nesse caso data é null. N/A
requestId string (uuid) Identificador único da requisição na GeckoAPI. 7ce87315-3a25-451f-b58c-cd65287a2601

Erros comuns

Respostas com notFound: true não entram nesta tabela, porque retornam sucesso HTTP 200.

Status errorCode Quando acontece
400 INVALID_PAYLOAD JSON inválido ou violação das regras de validação do payload.
401 UNAUTHORIZED Header Authorization ausente ou token/chave inválida.
402 INSUFFICIENT_CREDITS Saldo de créditos insuficiente para a API solicitada.
403 FORBIDDEN Usuário sem acesso ou API temporariamente desabilitada.
409 EXECUTION_CONFLICT executionId conflita com uma execução em estado incompatível.
429 RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS Limite de taxa ou limite de requisições em voo excedido.
5xx UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_INVOCATION_FAILED / WORKER_FUNCTION_ERROR / WORKER_INVALID_RESPONSE / INTERNAL_ERROR Falha de servidor no worker, provider/proxy ou gateway. Nesses casos os créditos são estornados automaticamente.