// docs

VivaReal: Get listing details

Extracts all relevant details of a property or project from VivaReal, including status, prices, attributes, address, advertiser, media, plans, units and construction data.

vivareal.com.br:pdp · 1 credit per request

Standard credit cost. Your account pricing is shown in the sandbox.

Try this operation in the sandbox

HTTP request

cURL

curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -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/"
}'

Keep your API key on your server. See the quickstart for authentication and response handling.

MCP request

The hosted MCP tool fixes target and type for this operation. Its remaining arguments use the same input rules as Extract.

POST /v1/mcp · Bearer or X-API-Key authentication

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"
    }
  }
}

Supported inputs

Conditional fields depend on the alternatives and constraints in the rule column. Fields marked unsupported are omitted.

Field	Type	Requirement	Rule	Default	Example
url URL extraction target. For some PLPs it can be omitted when API assembles URL from other fields.	string (URL)	Required	URL public property or project in the domain vivareal.com.br. The path must contain -id-<listingId>.	-	https://www.vivareal.com.br/imovel/sobrado-3-quartos-vila-albertina-zona-norte-sao-paulo-com-garagem-94m2-venda-RS450000-id-2787552284/
target Target source for extraction.	enum	Required	Always required and must be vivareal.com.br.	-	vivareal.com.br
type Extraction type: pdp, idp, plp, ilp, quote, review or places.	enum	Required	Always required and must be pdp.	-	pdp

Request examples

Property for sale

Send the public URL of a sale advertisement to VivaReal.

Property for sale

{
  "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/"
}

Property for rent

The same endpoint covers rental properties and preserves rental prices and frequency.

Property for rent

{
  "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/"
}

Enterprise or launch

Release URLs return developer, construction stage, plans, and child units when published.

Enterprise or launch

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

Response schema

Leaf paths and expected types. Field names and enum values are part of the API contract.

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": "\"1.0.0\"",
  "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>"
}

Example response

Illustrative response. Product names, reviews and other source content retain their original language. Missing and null values do not imply zero stock, free shipping or zero reviews.

responseExample

{
  "requestId": "7ce87315-3a25-451f-b58c-cd65287a2601",
  "executionId": "7ce87315-3a25-451f-b58c-cd65287a2602",
  "data": {
    "source": "vivareal.com.br",
    "type": "pdp",
    "parser": "1.0.0",
    "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"
      }
    ]
  }
}

Complete field reference

Path	Type	Description	Example
data.advertiserListingsCount	integer \| null	Number of ads in the account.	24
data.breadcrumbs[].name	string \| null	Breadcrumb label.	Imóveis
data.breadcrumbs[].rel	string \| null	Link relationship.	up
data.breadcrumbs[].url	string \| null	URL absolute breadcrumb.	https://www.vivareal.com.br/
data.canEstimatePrices	boolean \| null	Indicates whether the page allows price estimates.	true
data.canonicalUrl	string (canonical listing URL)	Canonical URL found in property data.	https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/
data.condominiumName	string \| null	Condominium name displayed on the page.	Évora Residence
data.constructionStatusCalendar	array<unknown>	Construction schedule exposed at page level.	[{"status":"LAUNCH","date":"2026-03"},{"status":"DELIVERY","date":"2028-06"}]
data.createdAt	string \| null	Creation date exposed by the page.	2026-03-10T10:00:00.000Z
data.extractedAt	string (ISO datetime)	Extraction Timestamp UTC.	2026-07-12T15:55:00.000Z
data.formattedAddress	string \| null	Formatted address displayed on the page.	Rua Exemplo, Vila Mariana, São Paulo - SP
data.infoTags	record<string, unknown>	Additional page tags and information.	{"financing":true,"decoratedUnit":true}
data.isAbmiPartner	boolean \| null	Indicates partner ABMI.	false
data.listing.acceptExchange	boolean \| null	Indicates exchange acceptance.	false
data.listing.address.approximate	boolean \| null	Indicates approximate location.	false
data.listing.address.city	string \| null	City.	São Paulo
data.listing.address.coordinates.latitude	number	Latitude published.	-23.5892
data.listing.address.coordinates.longitude	number	Published longitude.	-46.6344
data.listing.address.country	string \| null	Country.	Brasil
data.listing.address.displayType	string \| null	Address display policy.	ALL
data.listing.address.fullAddress	string \| null	Formatted address.	Rua Exemplo, Vila Mariana, São Paulo - SP
data.listing.address.locationId	string \| null	Internal geographic identifier.	BR-SAO-PAULO-VILA-MARIANA
data.listing.address.nearby	object \| null	Points and proximity information.	{"subway":"Vila Mariana","distanceMeters":550}
data.listing.address.neighborhood	string \| null	Neighborhood.	Vila Mariana
data.listing.address.state	string \| null	Status.	São Paulo
data.listing.address.stateAcronym	string \| null	UF.	SP
data.listing.address.street	string \| null	Street when published.	Rua Exemplo
data.listing.address.streetNumber	string \| null	Number when released.	500
data.listing.address.zipCode	string \| null	CEP.	04010000
data.listing.address.zone	string \| null	City area.	Zona Sul
data.listing.advertiser.addresses	object \| null	Published business addresses.	{"city":"São Paulo","state":"SP"}
data.listing.advertiser.createdAt	string \| null	Registration date.	2017-04-20T10:00:00.000Z
data.listing.advertiser.id	string \| null	Advertiser identifier.	dev-4201
data.listing.advertiser.imageUrl	string \| null	Logo or image.	https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/incorporadora-logo.webp
data.listing.advertiser.legacyId	string \| null	Advertiser's legacy identifier.	4201
data.listing.advertiser.license	string \| null	Professional registration, such as CRECI.	CRECI J-12345-SP
data.listing.advertiser.listingsCount	integer \| null	Number of ads published.	24
data.listing.advertiser.name	string \| null	Trade name.	Incorporadora Exemplo
data.listing.advertiser.phoneNumbers[]	string	Published telephone numbers.	1130002000
data.listing.advertiser.rating	number \| null	Aggregated grade when available.	4.8
data.listing.advertiser.tier	string \| null	Commercial tier.	PREMIUM
data.listing.advertiser.url	string \| null	Advertiser's public page.	https://www.vivareal.com.br/imobiliaria/incorporadora-exemplo-4201/
data.listing.advertiser.verified	boolean \| null	Indicates verified advertiser.	true
data.listing.advertiser.websiteUrl	string \| null	External website.	https://www.incorporadora-exemplo.com.br/
data.listing.advertiser.whatsappNumber	string \| null	WhatsApp published.	11987650000
data.listing.aiAmenities[]	string	Characteristics inferred in the structured payload.	OPEN_VIEW
data.listing.amenities[]	string	Stated amenities.	POOL
data.listing.attributes.bathrooms[]	number	Bathroom quantities.	2
data.listing.attributes.bedrooms[]	number	Room quantities.	2
data.listing.attributes.capacityLimits[]	number	Published occupancy limits.	6
data.listing.attributes.ceilingHeights[]	number	Published ceilings.	2.7
data.listing.attributes.floors[]	number	Number of floors.	18
data.listing.attributes.parkingSpaces[]	number	Number of vacancies.	1
data.listing.attributes.suites[]	number	Quantity of suites.	1
data.listing.attributes.totalAreas[]	number	Total areas in m².	92
data.listing.attributes.unitFloor	integer \| null	Unit floor when applicable.	7
data.listing.attributes.unitsOnTheFloor	integer \| null	Units per floor.	6
data.listing.attributes.usableAreas[]	number	Useful areas available in m².	67
data.listing.businessType	string \| null	Business, such as SALE or RENTAL.	SALE
data.listing.children	array<VivaRealListing>	Units/variations of the project, preserved in the same listing model.	[{"id":"unit-84-3","title":"Apartamento de 84 m² com 3 quartos","unitTypes":["APARTMENT"],"prices":[{"businessType":"SALE","value":790000}]}]
data.listing.condominiumName	string \| null	Name of the condominium or development.	Évora Residence
data.listing.constructionStatus	string \| null	Current construction stage.	UNDER_CONSTRUCTION
data.listing.constructionStatusCalendar	array<object>	Construction schedule associated with the listing.	[{"status":"LAUNCH","date":"2026-03"},{"status":"DELIVERY","date":"2028-06"}]
data.listing.contractType	string \| null	Contract/advertiser type, including OWNER and PROPERTY_DEVELOPER.	PROPERTY_DEVELOPER
data.listing.createdAt	string \| null	Ad creation date.	2026-03-10T10:00:00.000Z
data.listing.decoratedVisitCalendar	array<object>	Decorated visit schedule.	[{"weekday":"SATURDAY","available":true}]
data.listing.description	string \| null	Textual description without HTML.	Empreendimento residencial com apartamentos, lazer completo e plantas variadas.
data.listing.enhancedDevelopment	boolean \| null	Indicates enriched enterprise.	true
data.listing.externalId	string \| null	External identifier defined by the advertiser.	EVORA-RESIDENCE
data.listing.flags	record<string, string>	Relevant dynamic flags.	{"FEATURED":"true"}
data.listing.floorPlans[].url	string \| null	URL plant plan of the unit or enterprise.	https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/evora-planta-84.webp
data.listing.id	string \| null	Main identifier of the advertisement or enterprise.	2898122891
data.listing.legacyId	string \| null	Legacy identifier when available.	77122891
data.listing.listingType	string \| null	Listing type, such as USED or DEVELOPMENT.	DEVELOPMENT
data.listing.media[].alt	string \| null	Alternative text.	Fachada do Évora Residence
data.listing.media[].id	string \| null	Media identifier.	image-hero
data.listing.media[].seo	boolean \| null	Indicates media prioritized for SEO.	true
data.listing.media[].type	string \| null	Media type.	IMAGE
data.listing.media[].url	string \| null	URL materialized from the image.	https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/evora-hero.webp
data.listing.mergedAmenities[]	string	Amenities consolidated by VivaReal.	POOL
data.listing.nonActivationReason	string \| null	Reason for inactivation, when applicable.	NONE
data.listing.noWarrantorRent	boolean \| null	Indicates rental without guarantor.	false
data.listing.prices[].businessType	string \| null	Business associated with price.	SALE
data.listing.prices[].condominium	number \| null	Condominium fee.	620
data.listing.prices[].iptu	number \| null	Value of IPTU.	1800
data.listing.prices[].iptuPeriod	string \| null	Periodicity of IPTU.	YEARLY
data.listing.prices[].multiple	boolean \| null	Indicates multiple price ranges, common in developments.	true
data.listing.prices[].rentalPeriod	string \| null	Rental frequency.	MONTHLY
data.listing.prices[].value	number \| null	Main value.	620000
data.listing.propertyDevelopers[].details	object	Additional data published about the developer.	{"role":"DEVELOPER","verified":true}
data.listing.propertyDevelopers[].id	string \| null	Developer identifier.	dev-4201
data.listing.propertyDevelopers[].logoUrl	string \| null	Developer logo.	https://resizedimgs.vivareal.com/fit-in/900x900/vr.images.sp/incorporadora-logo.webp
data.listing.propertyDevelopers[].name	string \| null	Name of the developer.	Incorporadora Exemplo
data.listing.propertyDevelopers[].url	string \| null	Developer's public page.	https://www.vivareal.com.br/imobiliaria/incorporadora-exemplo-4201/
data.listing.propertyType	string \| null	Broad property category.	DEVELOPMENT
data.listing.publicationType	string \| null	Publication level.	PREMIUM
data.listing.resale	boolean \| null	Indicates resale property.	false
data.listing.showPrice	boolean \| null	Indicates whether the price should be displayed.	true
data.listing.sourceId	string \| null	Ad source identifier.	VR-DEV-2898122891
data.listing.stamps[]	string	Ad stamps.	LAUNCH
data.listing.status	string \| null	Current status of the ad.	ACTIVE
data.listing.title	string \| null	Published title.	Évora Residence
data.listing.transacted	boolean \| null	Indicates property already transacted.	false
data.listing.tripleBundle	boolean \| null	Triple bundle commercial flag.	false
data.listing.uniqueUnit	boolean \| null	Indicates single unit.	false
data.listing.unitSubTypes[]	string	Unit subtypes.	STANDARD
data.listing.unitTypes[]	string	Published unit types.	APARTMENT
data.listing.updatedAt	string \| null	Last updated.	2026-07-11T18:20:00.000Z
data.listing.url	string \| null	URL absolute value of the property.	https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/
data.listing.usageTypes[]	string	Residential or commercial uses.	RESIDENTIAL
data.listing.videos[].url	string \| null	URL ad video.	https://video.example.com/evora-residence
data.listing.videoTourUrl	string \| null	Video tour associated with the listing.	https://tour.example.com/evora-residence
data.listing.whatsappNumber	string \| null	WhatsApp associated with the listing.	11987650000
data.meta.description	string \| null	Description SEO.	Conheça plantas, preços e detalhes do Évora Residence.
data.meta.primaryHeading	string \| null	Main header.	Évora Residence
data.meta.robots	string \| null	Robots directive.	index,follow
data.meta.title	string \| null	Title SEO.	Évora Residence - apartamentos à venda
data.neighborhoodGuide	array<unknown>	Structured neighborhood guide content when available.	[{"name":"Vila Mariana","description":"Bairro com acesso a metrô, serviços e parques."}]
data.nonActivationReason	string \| null	Page-level inactivation reason.	NONE
data.parser	"1.0.0"	Stable version of the API response format.	1.0.0
data.relatedLinks[].name	string \| null	Related link label.	Apartamentos na Vila Mariana
data.relatedLinks[].rel	string \| null	Related link list.	related
data.relatedLinks[].url	string \| null	URL related.	https://www.vivareal.com.br/venda/sp/sao-paulo/vila-mariana/apartamento_residencial/
data.responseUrl	string (URL after redirects)	URL end after redirects.	https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/
data.source	"vivareal.com.br"	Normalized extraction source.	vivareal.com.br
data.status	string \| null	Ad page status.	ACTIVE
data.type	"pdp"	Seam PDP of property details.	pdp
data.updatedAt	string \| null	Update date exposed by the page.	2026-07-11T18:20:00.000Z
data.url	string (requested URL)	URL originally requested.	https://www.vivareal.com.br/imoveis-lancamentos/evora-residence-id-2898122891/
data.verifiedAdvertiser	boolean \| null	Indicates whether the advertising account is verified.	true
data.videos[].alt	string \| null	Video alt text.	Vídeo do empreendimento
data.videos[].id	string \| null	Page video identifier.	video-1
data.videos[].seo	boolean \| null	Indicates prioritization of SEO.	false
data.videos[].type	string \| null	Video media type.	VIDEO
data.videos[].url	string \| null	URL from the video.	https://video.example.com/evora-residence
data.virtualTourUrl	string \| null	URL.	https://tour.example.com/evora-residence
data.whatsappNumber	string \| null	WhatsApp contact information published by the page.	11987650000
executionId	string (uuid)	Identifier of the execution that produced the result.	7ce87315-3a25-451f-b58c-cd65287a2602
notFound	boolean (optional; true when the VivaReal listing is unavailable as a missing entity and data is null)	Present and true when the ad does not exist upstream; in this case data is null.	N/A
requestId	string (uuid)	Unique identifier of the request in GeckoAPI.	7ce87315-3a25-451f-b58c-cd65287a2601

Errors and missing data

When supported by this operation, an entity not found upstream can return HTTP 200 with data: null and notFound: true. Check the documented response fields before interpreting an empty result. Source-specific behavior and exceptions are described above.

HTTP status	Error code	Meaning
400	`INVALID_PAYLOAD`	Invalid JSON or a request that violates the documented validation rules.
401	`UNAUTHORIZED`	Missing authorization or an invalid API key or token.
402	`INSUFFICIENT_CREDITS`	The account has insufficient credits for this operation.
403	`FORBIDDEN`	The account does not have access, or the API is temporarily disabled.
409	`EXECUTION_CONFLICT`	The execution identifier conflicts with an incompatible execution state.
429	`RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS`	A rate limit or simultaneous request limit was exceeded.
5xx	`UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_FUNCTION_ERROR`	An upstream, worker or gateway failure. Failed requests follow the platform refund policy.

VivaReal: Get listing details

HTTP request

MCP request

Supported inputs

Request examples

Property for sale

Property for rent

Enterprise or launch

Response schema

Example response

Complete field reference

Errors and missing data

Other VivaReal operations