GeckoAPI
PT EN
Entrar Testar URL

// docs

Imovelweb PDP — detalhes do imóvel

Extrai um anúncio do Imovelweb com descrição completa, preços, condomínio, IPTU, endereço, coordenadas, áreas, quartos, amenidades, anunciante, contato público, fotos e vídeos. Custa 1 crédito por chamada.

Tempo de resposta: Campos não publicados retornam null ou listas vazias. Exemplos abreviados: apenas alguns itens e imagens são exibidos; contadores refletem a página original. Preços e datas podem mudar, e custos não têm periodicidade presumida.

Nota importante: alguns campos podem retornar null em produção, dependendo da página de origem. Consulte o schema e a descrição de cada campo para tratar valores ausentes; os exemplos mostram uma resposta possível.

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": "imovelweb.com.br",
  "type": "pdp",
  "url": "https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html"
}'

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

imovelweb_com_br_pdp

Auth

Bearer ou X-API-Key

imovelweb_com_br_pdp tools/call 
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "imovelweb_com_br_pdp",
    "arguments": {
      "url": "https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html",
      "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 HTTPS em /propriedades/ terminando em -<ID>.html. - https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html
target
Fonte alvo da extração.
 enum Obrigatório Sempre imovelweb.com.br. - imovelweb.com.br
type
Tipo da extração: pdp, idp, plp, ilp, quote, review ou places.
 enum Obrigatório Sempre pdp. - pdp

Exemplos de request

Detalhes por URL do imóvel

Use a URL retornada em items[].url na PLP.

Detalhes por URL do imóvel 
{
  "target": "imovelweb.com.br",
  "type": "pdp",
  "url": "https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html"
}

Schema de response (leaf paths)

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

responseSchema 
{
  "source": "\"imovelweb.com.br\"",
  "type": "\"pdp\"",
  "parser": "\"1.0.0\"",
  "url": "string (URL)",
  "canonicalUrl": "string (URL)",
  "extractedAt": "string (ISO datetime)",
  "data.id": "string (optional)",
  "data.code": "string | null (optional)",
  "data.url": "string (URL) (optional)",
  "data.title": "string | null (optional)",
  "data.generatedTitle": "string | null (optional)",
  "data.description": "string | null (optional)",
  "data.descriptionHtml": "string | null (optional)",
  "data.price": "object | null (optional)",
  "data.price.amount": "number | null (optional)",
  "data.price.currency": "string | null (optional)",
  "data.price.formatted": "string | null (optional)",
  "data.operations": "array (optional)",
  "data.operations[].name": "string | null (optional)",
  "data.expenses": "object | null (optional)",
  "data.expenses.amount": "number | null (optional)",
  "data.iptu": "object | null (optional)",
  "data.iptu.amount": "number | null (optional)",
  "data.costsText": "string | null (optional)",
  "data.address.street": "string | null (optional)",
  "data.address.visibility": "string | null (optional)",
  "data.address.neighborhood": "string | null (optional)",
  "data.address.city": "string | null (optional)",
  "data.address.state": "string | null (optional)",
  "data.address.stateCode": "string | null (optional)",
  "data.address.country": "string | null (optional)",
  "data.address.latitude": "number | null (optional)",
  "data.address.longitude": "number | null (optional)",
  "data.address.hierarchy": "array (optional)",
  "data.property.type": "string | null (optional)",
  "data.property.typeId": "string | null (optional)",
  "data.property.totalArea": "number | null (optional)",
  "data.property.usableArea": "number | null (optional)",
  "data.property.areaUnit": "string | null (optional)",
  "data.property.bedrooms": "number | null (optional)",
  "data.property.bathrooms": "number | null (optional)",
  "data.property.suites": "number | null (optional)",
  "data.property.parkingSpaces": "number | null (optional)",
  "data.property.ageYears": "number | null (optional)",
  "data.features": "object (optional)",
  "data.amenities": "array (optional)",
  "data.status": "string | null (optional)",
  "data.reserved": "boolean | null (optional)",
  "data.postingType": "string | null (optional)",
  "data.publishedAt": "string | null (optional)",
  "data.modifiedAt": "string | null (optional)",
  "data.publicationLabel": "string | null (optional)",
  "data.recentViews": "number | null (optional)",
  "data.publisher.id": "string | null (optional)",
  "data.publisher.name": "string | null (optional)",
  "data.publisher.url": "string (URL) | null (optional)",
  "data.publisher.logoUrl": "string (URL) | null (optional)",
  "data.publisher.license": "string | null (optional)",
  "data.publisher.typeId": "string | number | null (optional)",
  "data.publisher.premier": "boolean | null (optional)",
  "data.publisher.createdAtEpochMs": "number | null (optional)",
  "data.contact.whatsapp": "string | null (optional)",
  "data.contact.phone": "string | null (optional)",
  "data.contact.partialPhone": "string | null (optional)",
  "data.images": "array (optional)",
  "data.images[].url": "string (URL) (optional)",
  "data.images[].originalWidth": "number | null (optional)",
  "data.images[].originalHeight": "number | null (optional)",
  "data.images[].caption": "string | null (optional)",
  "data.images[].variants": "object (optional)",
  "data.imageCount": "integer (optional)",
  "data.additionalImageCount": "integer | null (optional)",
  "data.videos": "array (optional)",
  "data.hasVideos": "boolean | null (optional)",
  "data.hasTour": "boolean | null (optional)",
  "data.hasPlans": "boolean | null (optional)",
  "data.raw": "object (optional)",
  "pageTitle": "string | null (optional)",
  "metadata": "object (optional)",
  "breadcrumbs": "array | null (optional)",
  "relatedSearchUrl": "string (URL) | null (optional)",
  "structuredData": "array (optional)"
}

Exemplo de response

responseExample 
{
  "source": "imovelweb.com.br",
  "type": "pdp",
  "parser": "1.0.0",
  "url": "https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html",
  "canonicalUrl": "https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html",
  "extractedAt": "2026-09-27T15:52:50.860302+00:00",
  "pageTitle": "Apartamento para aluguel com 2 Quartos, Cidade Industrial, Curitiba - R$ 1.250, 43 m2 - ID: 3046251226 - Imovelweb",
  "metadata": {
    "description": "Pacote de locação; 1° aluguel bruto R$ 1.562,50 Aluguel liquido a partir do 2° mês R$ 1.250,00 Condomínio R$ 338,00 IPTU R$ 24,00 Seguro in...Cidade Industrial",
    "og:title": "Apartamento para aluguel com 2 Quartos, Cidade Industrial, Curitiba - R$ 1.250, 43 m2 - ID: 3046251226 - Imovelweb",
    "og:description": "Pacote de locação; 1° aluguel bruto R$ 1.562,50 Aluguel liquido a partir do 2° mês R$ 1.250,00 Condomínio R$ 338,00 IPTU R$ 24,00 Seguro in...Cidade Industrial",
    "og:url": "https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html",
    "og:image": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971864.jpg?isFirstImage=true",
    "robots": "follow, index, max-image-preview:large"
  },
  "data": {
    "id": "3046251226",
    "code": "AP0009",
    "url": "https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html",
    "title": "Apartamento com 2 dormitórios para alugar, 43 m² por R$ 1.652,00 - Cidade Industrial - Curitiba/PR",
    "generatedTitle": "Apartamento · 43m² · 2 quartos · 1 vaga",
    "price": {
      "amount": 1250,
      "currency": "BRL",
      "formatted": "1.250",
      "symbol": "R$"
    },
    "operations": [
      {
        "id": "2",
        "name": "aluguel",
        "prices": [
          {
            "amount": 1250,
            "currency": "BRL",
            "formatted": "1.250",
            "symbol": "R$"
          }
        ]
      }
    ],
    "expenses": {
      "amount": 338,
      "currency": "BRL",
      "formatted": "338"
    },
    "iptu": {
      "amount": 24,
      "currency": "BRL",
      "formatted": "24"
    },
    "costsText": "Condomínio R$ 338                    \n                \n                \n                  ·\n                \n                \n                    IPTU R$ 24",
    "address": {
      "street": "Rua Durval Leopoldo Landal 875",
      "visibility": "EXACT",
      "neighborhood": "Cidade Industrial",
      "city": "Curitiba",
      "state": "Paraná",
      "stateCode": "PR",
      "country": "Brasil",
      "latitude": -25.4878358,
      "longitude": -49.3506335,
      "hierarchy": [
        {
          "locationId": "V1-D-508647",
          "name": "Cidade Industrial",
          "label": "ZONA",
          "depth": 3
        },
        {
          "locationId": "V1-C-106015",
          "name": "Curitiba",
          "label": "CIUDAD",
          "depth": 2
        }
      ]
    },
    "property": {
      "totalArea": 43,
      "usableArea": 43,
      "bedrooms": 2,
      "bathrooms": 1,
      "parkingSpaces": 1,
      "ageYears": 25,
      "areaUnit": "m²",
      "type": "Apartamento",
      "typeId": "2"
    },
    "features": {
      "CFT100": {
        "featureId": "CFT100",
        "label": "tot.",
        "measure": "m²",
        "value": "43",
        "icon": "stotal"
      },
      "CFT101": {
        "featureId": "CFT101",
        "label": "útil",
        "measure": "m²",
        "value": "43",
        "icon": "scubierta"
      },
      "CFT3": {
        "featureId": "CFT3",
        "label": "banheiro",
        "value": "1",
        "icon": "bano"
      },
      "CFT7": {
        "featureId": "CFT7",
        "label": "vaga",
        "value": "1",
        "icon": "cochera"
      },
      "CFT2": {
        "featureId": "CFT2",
        "label": "quarto",
        "value": "2",
        "icon": "dormitorio"
      },
      "CFT5": {
        "featureId": "CFT5",
        "label": "idade do imóvel",
        "value": "25",
        "icon": "antiguedad"
      }
    },
    "amenities": [
      {
        "group": "Áreas comuns",
        "featureId": "10184",
        "label": "Sistema de alarme"
      },
      {
        "group": "Áreas privativas",
        "featureId": "20217",
        "label": "TV"
      }
    ],
    "status": "ONLINE",
    "reserved": false,
    "postingType": "PROPERTY",
    "publishedAt": "2026-09-17T03:30:50Z",
    "publicationLabel": "Publicado há 6 dias",
    "recentViews": 286,
    "publisher": {
      "id": "30004499",
      "name": "Imobiliária Time",
      "url": "https://www.imovelweb.com.br/imobiliarias/imobiliaria-time_30004499-imoveis.html",
      "logoUrl": "https://imgbr.imovelwebcdn.com/empresas/2/00/30/00/44/99/130x70/logo_imobiliaria-time-ltda-me_1580734692792.jpg",
      "license": "5404-J",
      "typeId": 2,
      "premier": false
    },
    "contact": {
      "whatsapp": "55 41996198388",
      "partialPhone": "(41) 99"
    },
    "images": [
      {
        "url": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/1200x1200/7238971864.jpg?isFirstImage=true",
        "order": 0,
        "caption": "ba380bfd7335ed97098f93390c3bc8da7093b65a",
        "originalWidth": 1080,
        "originalHeight": 719,
        "variants": {
          "resizeUrl1200x1200": "https://imgbr.imovelwebcdn.com/avisos/resize/2/30/46/25/12/26/1200x1200/7238971864.jpg?isFirstImage=true",
          "resizeUrl720x532": "https://imgbr.imovelwebcdn.com/avisos/resize/2/30/46/25/12/26/720x532/7238971864.jpg?isFirstImage=true",
          "url1200x1200": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/1200x1200/7238971864.jpg?isFirstImage=true",
          "url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971864.jpg?isFirstImage=true",
          "url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/360x266/7238971864.jpg?isFirstImage=true",
          "url215x159": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/215x159/7238971864.jpg?isFirstImage=true",
          "url100x75": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/100x75/7238971864.jpg?isFirstImage=true"
        }
      },
      {
        "url": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/1200x1200/7238971922.jpg",
        "order": 1,
        "caption": "b5bb7b3e909bd477f83cf6af25450106d378b239",
        "originalWidth": 1080,
        "originalHeight": 719,
        "variants": {
          "resizeUrl1200x1200": "https://imgbr.imovelwebcdn.com/avisos/resize/2/30/46/25/12/26/1200x1200/7238971922.jpg",
          "resizeUrl720x532": "https://imgbr.imovelwebcdn.com/avisos/resize/2/30/46/25/12/26/720x532/7238971922.jpg",
          "url1200x1200": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/1200x1200/7238971922.jpg",
          "url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971922.jpg",
          "url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/360x266/7238971922.jpg",
          "url215x159": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/215x159/7238971922.jpg",
          "url100x75": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/100x75/7238971922.jpg"
        }
      }
    ],
    "imageCount": 20,
    "videos": [
      {
        "order": 0,
        "reference": "CdRx7HDtwxk"
      }
    ],
    "hasVideos": true,
    "raw": {
      "postingCode": "AP0009"
    }
  },
  "breadcrumbs": [
    {
      "url": "/",
      "nombre": "Imovelweb",
      "isLast": false,
      "index": 1
    },
    {
      "url": "/apartamentos.html",
      "nombre": "Apartamentos",
      "isLast": false,
      "index": 2
    }
  ],
  "relatedSearchUrl": "https://www.imovelweb.com.br/apartamentos-aluguel-cidade-industrial-curitiba-2-quartos.html"
}

Referência completa de campos

Path Tipo Descrição Exemplo
breadcrumbs array | null (optional) Navegação por região e categoria. [{"url":"/","nombre":"Imovelweb","isLast":false,"index":1},{"url":"/apartamentos.html","nombre":"Apartamentos","isLast":false,"index":2}]
canonicalUrl string (URL) URL canônica declarada pela página. https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html
data.additionalImageCount integer | null (optional) Imagens adicionais indicadas na PLP, disponíveis ao consultar o PDP. N/A
data.address.city string | null (optional) Cidade. Curitiba
data.address.country string | null (optional) País. Brasil
data.address.hierarchy array (optional) Hierarquia de localização, com IDs da fonte. [{"locationId":"V1-D-508647","name":"Cidade Industrial","label":"ZONA","depth":3},{"locationId":"V1-C-106015","name":"Curitiba","label":"CIUDAD","depth":2}]
data.address.latitude number | null (optional) Latitude pública da página; respeite a precisão declarada. -25.4878358
data.address.longitude number | null (optional) Longitude pública da página. -49.3506335
data.address.neighborhood string | null (optional) Bairro. Cidade Industrial
data.address.state string | null (optional) Nome do estado. Paraná
data.address.stateCode string | null (optional) Sigla do estado. PR
data.address.street string | null (optional) Logradouro informado pelo anunciante. Rua Durval Leopoldo Landal 875
data.address.visibility string | null (optional) Precisão declarada pela fonte, como EXACT ou APPROXIMATE. EXACT
data.amenities array (optional) Amenidades agrupadas, como piscina, elevador ou mobiliado. [{"group":"Áreas comuns","featureId":"10184","label":"Sistema de alarme"},{"group":"Áreas privativas","featureId":"20217","label":"TV"}]
data.code string | null (optional) Código do imóvel na imobiliária. AP0009
data.contact.partialPhone string | null (optional) Telefone parcial; não é completado por inferência. (41) 99
data.contact.phone string | null (optional) Telefone completo quando explicitamente retornado. N/A
data.contact.whatsapp string | null (optional) WhatsApp já presente no HTML público; não envia mensagem nem cria lead. 55 41996198388
data.costsText string | null (optional) Texto original do bloco de encargos no PDP. Condomínio R$ 338 · IPTU R$ 24
data.description string | null (optional) Descrição completa retornada pela página, em texto. N/A
data.descriptionHtml string | null (optional) Descrição em HTML quando disponível no PDP. N/A
data.expenses object | null (optional) Condomínio publicado, sem inferir periodicidade. {"amount":338,"currency":"BRL","formatted":"338"}
data.expenses.amount number | null (optional) Valor numérico do condomínio. 338
data.features object (optional) Características com IDs, rótulos, medidas e valores originais. {"CFT100":{"featureId":"CFT100","label":"tot.","measure":"m²","value":"43","icon":"stotal"},"CFT101":{"featureId":"CFT101","label":"útil","measure":"m²","value":"43","icon":"scubierta"},"CFT3":{"featureId":"CFT3","label":"banheiro","value":"1","icon":"bano"},"CFT7":{"featureId":"CFT7","label":"vaga","value":"1","icon":"cochera"},"CFT2":{"featureId":"CFT2","label":"quarto","value":"2","icon":"dormitorio"},"CFT5":{"featureId":"CFT5","label":"idade do imóvel","value":"25","icon":"antiguedad"}}
data.generatedTitle string | null (optional) Resumo gerado pela fonte com área e tipologia. Apartamento · 43m² · 2 quartos · 1 vaga
data.hasPlans boolean | null (optional) Indicador da fonte para plantas. N/A
data.hasTour boolean | null (optional) Indicador da fonte para tour virtual. N/A
data.hasVideos boolean | null (optional) Indicador da fonte para vídeo. true
data.id string (optional) Identificador público do anúncio. 3046251226
data.imageCount integer (optional) Quantidade de imagens retornadas nesta chamada. 20
data.images array (optional) Imagens disponíveis nesta página. [{"url":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/1200x1200/7238971864.jpg?isFirstImage=true","order":0,"caption":"ba380bfd7335ed97098f93390c3bc8da7093b65a","originalWidth":1080,"originalHeight":719,"variants":{"resizeUrl1200x1200":"https://imgbr.imovelwebcdn.com/avisos/resize/2/30/46/25/12/26/1200x1200/7238971864.jpg?isFirstImage=true","resizeUrl720x532":"https://imgbr.imovelwebcdn.com/avisos/resize/2/30/46/25/12/26/720x532/7238971864.jpg?isFirstImage=true","url1200x1200":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/1200x1200/7238971864.jpg?isFirstImage=true","url730x532":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971864.jpg?isFirstImage=true","url360x266":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/360x266/7238971864.jpg?isFirstImage=true","url215x159":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/215x159/7238971864.jpg?isFirstImage=true","url100x75":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/100x75/7238971864.jpg?isFirstImage=true"}},{"url":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/1200x1200/7238971922.jpg","order":1,"caption":"b5bb7b3e909bd477f83cf6af25450106d378b239","originalWidth":1080,"originalHeight":719,"variants":{"resizeUrl1200x1200":"https://imgbr.imovelwebcdn.com/avisos/resize/2/30/46/25/12/26/1200x1200/7238971922.jpg","resizeUrl720x532":"https://imgbr.imovelwebcdn.com/avisos/resize/2/30/46/25/12/26/720x532/7238971922.jpg","url1200x1200":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/1200x1200/7238971922.jpg","url730x532":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971922.jpg","url360x266":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/360x266/7238971922.jpg","url215x159":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/215x159/7238971922.jpg","url100x75":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/100x75/7238971922.jpg"}}]
data.images[].caption string | null (optional) Legenda ou nome original da imagem. ba380bfd7335ed97098f93390c3bc8da7093b65a
data.images[].originalHeight number | null (optional) Altura original informada. 719
data.images[].originalWidth number | null (optional) Largura original informada, não necessariamente a resolução da variante. 1080
data.images[].url string (URL) (optional) Maior variante publicada no objeto da imagem. https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/1200x1200/7238971864.jpg?isFirstImage=true
data.images[].variants object (optional) URLs de todas as resoluções publicadas. {"resizeUrl1200x1200":"https://imgbr.imovelwebcdn.com/avisos/resize/2/30/46/25/12/26/1200x1200/7238971864.jpg?isFirstImage=true","resizeUrl720x532":"https://imgbr.imovelwebcdn.com/avisos/resize/2/30/46/25/12/26/720x532/7238971864.jpg?isFirstImage=true","url1200x1200":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/1200x1200/7238971864.jpg?isFirstImage=true","url730x532":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971864.jpg?isFirstImage=true","url360x266":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/360x266/7238971864.jpg?isFirstImage=true","url215x159":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/215x159/7238971864.jpg?isFirstImage=true","url100x75":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/100x75/7238971864.jpg?isFirstImage=true"}
data.iptu object | null (optional) IPTU explicitamente publicado; não é inferido da descrição nem tratado automaticamente como mensal. {"amount":24,"currency":"BRL","formatted":"24"}
data.iptu.amount number | null (optional) Valor do IPTU publicado no bloco de custos. 24
data.modifiedAt string | null (optional) Data de modificação fornecida pela listagem. N/A
data.operations array (optional) Todas as operações e seus preços, sem descartar anúncios com mais de uma operação. [{"id":"2","name":"aluguel","prices":[{"amount":1250,"currency":"BRL","formatted":"1.250","symbol":"R$"}]}]
data.operations[].name string | null (optional) Operação anunciada, como aluguel ou venda. aluguel
data.postingType string | null (optional) Tipo de anúncio, como PROPERTY. PROPERTY
data.price object | null (optional) Primeiro preço anunciado; não soma automaticamente encargos. {"amount":1250,"currency":"BRL","formatted":"1.250","symbol":"R$"}
data.price.amount number | null (optional) Preço nominal em reais, sem conversão de centavos. 1250
data.price.currency string | null (optional) Moeda; BRL para R$. BRL
data.price.formatted string | null (optional) Valor formatado pela fonte. 1.250
data.property.ageYears number | null (optional) Idade do imóvel, diferente da data de publicação. 25
data.property.areaUnit string | null (optional) Unidade de medida, normalmente m². m²
data.property.bathrooms number | null (optional) Banheiros. 1
data.property.bedrooms number | null (optional) Quartos. 2
data.property.parkingSpaces number | null (optional) Vagas de garagem; ausência não significa zero. 1
data.property.suites number | null (optional) Suítes, quando informado. N/A
data.property.totalArea number | null (optional) Área total. 43
data.property.type string | null (optional) Tipo de imóvel. Apartamento
data.property.typeId string | null (optional) Identificador do tipo na fonte. 2
data.property.usableArea number | null (optional) Área útil/privativa. 43
data.publicationLabel string | null (optional) Rótulo relativo de publicação, mantido separado da data absoluta. Publicado há 6 dias
data.publishedAt string | null (optional) Data de publicação fornecida pelo PDP. 2026-09-17T03:30:50Z
data.publisher.createdAtEpochMs number | null (optional) Data de cadastro do anunciante em milissegundos, quando retornada. N/A
data.publisher.id string | null (optional) ID do anunciante. 30004499
data.publisher.license string | null (optional) Registro profissional informado pela fonte. 5404-J
data.publisher.logoUrl string (URL) | null (optional) Logotipo do anunciante. https://imgbr.imovelwebcdn.com/empresas/2/00/30/00/44/99/130x70/logo_imobiliaria-time-ltda-me_1580734692792.jpg
data.publisher.name string | null (optional) Nome publicado da imobiliária ou anunciante. Imobiliária Time
data.publisher.premier boolean | null (optional) Selo comercial publicado. false
data.publisher.typeId string | number | null (optional) Tipo de anunciante na fonte. 2
data.publisher.url string (URL) | null (optional) Página pública do anunciante. https://www.imovelweb.com.br/imobiliarias/imobiliaria-time_30004499-imoveis.html
data.raw object (optional) Objeto completo do anúncio publicado na página, incluindo campos ainda não normalizados e valores nulos. {"postingCode":"AP0009"}
data.recentViews number | null (optional) Contagem publicada de visualizações recentes; não representa necessariamente o total histórico. 286
data.reserved boolean | null (optional) Indicação de reserva, preservando false. false
data.status string | null (optional) Status informado pela fonte. ONLINE
data.title string | null (optional) Título do anúncio. Apartamento com 2 dormitórios para alugar, 43 m² por R$ 1.652,00 - Cidade Industrial - Curitiba/PR
data.url string (URL) (optional) URL pública do imóvel. https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html
data.videos array (optional) Referências de vídeos publicadas, sem carregar o vídeo. [{"order":0,"reference":"CdRx7HDtwxk"}]
extractedAt string (ISO datetime) Instante da extração. 2026-09-27T15:52:50.860302+00:00
metadata object (optional) Metadados públicos de SEO. {"description":"Pacote de locação; 1° aluguel bruto R$ 1.562,50 Aluguel liquido a partir do 2° mês R$ 1.250,00 Condomínio R$ 338,00 IPTU R$ 24,00 Seguro in...Cidade Industrial","og:title":"Apartamento para aluguel com 2 Quartos, Cidade Industrial, Curitiba - R$ 1.250, 43 m2 - ID: 3046251226 - Imovelweb","og:description":"Pacote de locação; 1° aluguel bruto R$ 1.562,50 Aluguel liquido a partir do 2° mês R$ 1.250,00 Condomínio R$ 338,00 IPTU R$ 24,00 Seguro in...Cidade Industrial","og:url":"https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html","og:image":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971864.jpg?isFirstImage=true","robots":"follow, index, max-image-preview:large"}
pageTitle string | null (optional) Título HTML da página. Apartamento para aluguel com 2 Quartos, Cidade Industrial, Curitiba - R$ 1.250, 43 m2 - ID: 3046251226 - Imovelweb
parser "1.0.0" Versão pública do formato de resposta. 1.0.0
relatedSearchUrl string (URL) | null (optional) Busca de imóveis relacionados. https://www.imovelweb.com.br/apartamentos-aluguel-cidade-industrial-curitiba-2-quartos.html
source "imovelweb.com.br" Fonte dos dados. imovelweb.com.br
structuredData array (optional) JSON-LD do imóvel, preservado como complemento. N/A
type "pdp" Tipo de extração. pdp
url string (URL) URL pública consultada, incluindo a página solicitada. https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html

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.