GeckoAPI
PT EN
Entrar Testar URL

// docs

Imovelweb PLP — busca e categorias de imóveis

Extrai uma página de resultados do Imovelweb com imóveis, preços, condomínio, características, localização, anunciante, contato público, fotos, filtros e paginação. Custa 1 crédito por chamada; cada próxima página é uma nova 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": "plp",
  "url": "https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.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_plp

Auth

Bearer ou X-API-Key

imovelweb_com_br_plp tools/call 
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "imovelweb_com_br_plp",
    "arguments": {
      "url": "https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.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 de resultados do Imovelweb terminando em .html. Filtros da URL são preservados. - https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.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 plp. - plp
page
Paginacao. Em PLP, inclusive Trivago, e no Reclame AQUI ILP inicia em 1; em review (MercadoLivre, Booking e Hoteis) inicia em 0. O Reclame AQUI ILP aceita ate a pagina 100.
 integer Opcional Inteiro de 1 a 500. Se omitido, preserva a página da URL; quando enviado, tem precedência. Não percorre várias páginas automaticamente. - 2

Exemplos de request

Busca por URL

Use a URL pública da busca com os filtros desejados.

Busca por URL 
{
  "target": "imovelweb.com.br",
  "type": "plp",
  "url": "https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.html"
}

Página seguinte

page substitui a página da URL. Cada chamada retorna uma página e custa 1 crédito. Também é possível enviar nextPageUrl sem page.

Página seguinte 
{
  "target": "imovelweb.com.br",
  "type": "plp",
  "url": "https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.html",
  "page": 2
}

Schema de response (leaf paths)

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

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

Exemplo de response

responseExample 
{
  "source": "imovelweb.com.br",
  "type": "plp",
  "parser": "1.0.0",
  "url": "https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.html",
  "canonicalUrl": "https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.html",
  "extractedAt": "2026-09-27T15:52:50.496453+00:00",
  "pageTitle": "4.321 Apartamentos para alugar em Curitiba, PR - Imovelweb",
  "metadata": {
    "description": "No Imovelweb você encontra 4.321 Apartamentos para alugar em Curitiba, PR. Explore as melhores ofertas agora de aluguel de apartamentos  em Curitiba, PR.",
    "robots": "index,follow, max-image-preview:large"
  },
  "title": "4.321 Apartamentos para alugar em Curitiba, PR",
  "total": 4321,
  "count": 30,
  "page": 1,
  "pageSize": 30,
  "totalPages": 145,
  "nextPageUrl": "https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr-pagina-2.html",
  "hasNextPage": true,
  "items": [
    {
      "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",
        "symbol": "R$"
      },
      "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": "Apartamentos",
        "typeId": "2"
      },
      "features": {
        "CFT100": {
          "featureId": "CFT100",
          "label": "Área total",
          "measure": "m²",
          "value": "43",
          "featureCategoryId": "CFC2"
        },
        "CFT101": {
          "featureId": "CFT101",
          "label": "Área útil",
          "measure": "m²",
          "value": "43",
          "featureCategoryId": "CFC2"
        },
        "CFT2": {
          "featureId": "CFT2",
          "label": "Quartos",
          "value": "2",
          "featureCategoryId": "CFC1"
        },
        "CFT3": {
          "featureId": "CFT3",
          "label": "Banheiro",
          "value": "1",
          "featureCategoryId": "CFC1"
        },
        "CFT7": {
          "featureId": "CFT7",
          "label": "Vaga",
          "value": "1",
          "featureCategoryId": "CFC1"
        },
        "CFT5": {
          "featureId": "CFT5",
          "label": "Idade do imóvel",
          "value": "25",
          "featureCategoryId": "CFC1"
        }
      },
      "amenities": [],
      "status": "ONLINE",
      "reserved": false,
      "postingType": "PROPERTY",
      "modifiedAt": "2026-09-26T23:13:53-0400",
      "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": true,
        "createdAtEpochMs": 1413864000000
      },
      "contact": {
        "whatsapp": "55 41996198388"
      },
      "images": [
        {
          "url": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971864.jpg?isFirstImage=true",
          "order": 0,
          "caption": "ba380bfd7335ed97098f93390c3bc8da7093b65a · Apartamento com 2 dormitórios para alugar, 43 m² por R$ 1.652,00 - Cidade Industrial - Curitiba/PR",
          "originalWidth": 1080,
          "originalHeight": 719,
          "variants": {
            "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"
          }
        },
        {
          "url": "https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971922.jpg",
          "order": 1,
          "caption": "b5bb7b3e909bd477f83cf6af25450106d378b239",
          "originalWidth": 1080,
          "originalHeight": 719,
          "variants": {
            "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"
          }
        }
      ],
      "imageCount": 8,
      "additionalImageCount": 12,
      "videos": [],
      "hasVideos": true,
      "hasTour": false,
      "hasPlans": false,
      "raw": {
        "postingCode": "AP0009"
      }
    },
    {
      "id": "3045284964",
      "code": "895554105",
      "url": "https://www.imovelweb.com.br/propriedades/apartamento-para-aluguel-mossungue-2-quartos-80-3045284964.html",
      "title": "Apartamento para Aluguel - Mossunguê , 2 Quartos,  80 m2 - Curitiba",
      "generatedTitle": "Apartamento · 80m² · 2 Quartos · 2 Vagas",
      "price": {
        "amount": 8821,
        "currency": "BRL",
        "formatted": "8.821",
        "symbol": "R$"
      },
      "operations": [
        {
          "id": "2",
          "name": "Aluguel",
          "prices": [
            {
              "amount": 8821,
              "currency": "BRL",
              "formatted": "8.821",
              "symbol": "R$"
            }
          ]
        }
      ],
      "expenses": {
        "amount": 548,
        "currency": "BRL",
        "formatted": "548",
        "symbol": "R$"
      },
      "address": {
        "street": "Rua José Izidoro Biazetto",
        "visibility": "EXACT",
        "neighborhood": "Mossunguê",
        "city": "Curitiba",
        "state": "Paraná",
        "stateCode": "PR",
        "country": "Brasil",
        "latitude": -25.4333146,
        "longitude": -49.3387367,
        "hierarchy": [
          {
            "locationId": "V1-D-508663",
            "name": "Mossunguê",
            "label": "ZONA",
            "depth": 3
          },
          {
            "locationId": "V1-C-106015",
            "name": "Curitiba",
            "label": "CIUDAD",
            "depth": 2
          }
        ]
      },
      "property": {
        "totalArea": 80,
        "usableArea": 80,
        "bedrooms": 2,
        "bathrooms": 2,
        "suites": 1,
        "parkingSpaces": 2,
        "areaUnit": "m²",
        "type": "Apartamentos",
        "typeId": "2"
      },
      "features": {
        "CFT100": {
          "featureId": "CFT100",
          "label": "Área total",
          "measure": "m²",
          "value": "80",
          "featureCategoryId": "CFC2"
        },
        "CFT101": {
          "featureId": "CFT101",
          "label": "Área útil",
          "measure": "m²",
          "value": "80",
          "featureCategoryId": "CFC2"
        },
        "CFT2": {
          "featureId": "CFT2",
          "label": "Quartos",
          "value": "2",
          "featureCategoryId": "CFC1"
        },
        "CFT3": {
          "featureId": "CFT3",
          "label": "Banheiros",
          "value": "2",
          "featureCategoryId": "CFC1"
        },
        "CFT7": {
          "featureId": "CFT7",
          "label": "Vagas",
          "value": "2",
          "featureCategoryId": "CFC1"
        },
        "CFT4": {
          "featureId": "CFT4",
          "label": "Suíte",
          "value": "1",
          "featureCategoryId": "CFC1"
        }
      },
      "amenities": [],
      "status": "ONLINE",
      "reserved": false,
      "postingType": "PROPERTY",
      "modifiedAt": "2026-09-26T23:13:54-0400",
      "publisher": {
        "id": "47514139",
        "name": "QuintoAndar (Premier Locação)",
        "url": "https://www.imovelweb.com.br/imobiliarias/quintoandar-premier-locacao_47514139-imoveis.html",
        "logoUrl": "https://imgbr.imovelwebcdn.com/empresas/2/00/47/51/41/39/130x70/logo_quintoandar-premier-locacao_1723736805814.jpg",
        "license": "J24.344",
        "typeId": "4",
        "premier": true,
        "createdAtEpochMs": 1648526400000
      },
      "contact": {
        "whatsapp": "55 1150280245"
      },
      "images": [
        {
          "url": "https://imgbr.imovelwebcdn.com/avisos/2/30/45/28/49/64/720x532/7183161624.jpg?isFirstImage=true",
          "order": 0,
          "caption": "Apartamento · 80m² · 2 Quartos · 2 Vagas · Apartamento para Aluguel - Mossunguê , 2 Quartos,  80 m2 - Curitiba",
          "originalWidth": 840,
          "originalHeight": 560,
          "variants": {
            "url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/45/28/49/64/720x532/7183161624.jpg?isFirstImage=true",
            "url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/45/28/49/64/360x266/7183161624.jpg?isFirstImage=true"
          }
        },
        {
          "url": "https://imgbr.imovelwebcdn.com/avisos/2/30/45/28/49/64/720x532/7183163126.jpg",
          "order": 1,
          "caption": "Apartamento de 2 quartos, Curitiba",
          "originalWidth": 840,
          "originalHeight": 560,
          "variants": {
            "url730x532": "https://imgbr.imovelwebcdn.com/avisos/2/30/45/28/49/64/720x532/7183163126.jpg",
            "url360x266": "https://imgbr.imovelwebcdn.com/avisos/2/30/45/28/49/64/360x266/7183163126.jpg"
          }
        }
      ],
      "imageCount": 8,
      "additionalImageCount": 42,
      "videos": [],
      "hasVideos": false,
      "hasTour": false,
      "hasPlans": false,
      "raw": {
        "postingCode": "895554105"
      }
    }
  ],
  "paging": {
    "total": 4321,
    "offset": 0,
    "limit": 30,
    "totalPages": 145,
    "currentPage": 1,
    "showFrom": 1,
    "showUntil": 5,
    "pages": [
      1,
      2
    ],
    "firstPage": true,
    "lastPage": false,
    "total5A": 318,
    "pagesUrl": {
      "1": "/apartamentos-aluguel-curitiba-pr.html",
      "2": "/apartamentos-aluguel-curitiba-pr-pagina-2.html",
      "3": "/apartamentos-aluguel-curitiba-pr-pagina-3.html",
      "4": "/apartamentos-aluguel-curitiba-pr-pagina-4.html",
      "5": "/apartamentos-aluguel-curitiba-pr-pagina-5.html",
      "nextPage": "/apartamentos-aluguel-curitiba-pr-pagina-2.html"
    }
  },
  "appliedFilters": [
    {
      "type": "location",
      "options": [
        {
          "label": "Curitiba",
          "type": "city",
          "min": "106015"
        }
      ],
      "renderType": 5
    },
    {
      "type": "operationType",
      "options": [
        {
          "label": "Alugar",
          "min": "2"
        }
      ],
      "renderType": 3
    }
  ],
  "sort": {
    "type": "sort",
    "options": [
      {
        "label": "Relevantes",
        "min": "relevance",
        "selected": true
      },
      {
        "label": "Mais baratos",
        "min": "low_price",
        "selected": false
      }
    ]
  },
  "breadcrumbs": [
    {
      "url": "/",
      "nombre": "Imovelweb",
      "isLast": false,
      "index": 1
    },
    {
      "url": "/apartamentos-aluguel.html",
      "nombre": "Apartamentos  para alugar",
      "isLast": false,
      "index": 2
    }
  ]
}

Referência completa de campos

Path Tipo Descrição Exemplo
appliedFilters array | object | null (optional) Filtros efetivamente aplicados pela fonte. [{"type":"location","options":[{"label":"Curitiba","type":"city","min":"106015"}],"renderType":5},{"type":"operationType","options":[{"label":"Alugar","min":"2"}],"renderType":3}]
breadcrumbs array | null (optional) Navegação por região e categoria. [{"url":"/","nombre":"Imovelweb","isLast":false,"index":1},{"url":"/apartamentos-aluguel.html","nombre":"Apartamentos para alugar","isLast":false,"index":2}]
canonicalUrl string (URL) URL canônica declarada pela página. https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.html
count integer (optional) Quantidade de anúncios nesta página. 30
extractedAt string (ISO datetime) Instante da extração. 2026-09-27T15:52:50.496453+00:00
filters array | object | null (optional) Facetas e filtros publicados na busca. N/A
hasNextPage boolean (optional) Indica existência de próxima página. true
items[].additionalImageCount integer | null (optional) Imagens adicionais indicadas na PLP, disponíveis ao consultar o PDP. 12
items[].address.city string | null (optional) Cidade. Curitiba
items[].address.country string | null (optional) País. Brasil
items[].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}]
items[].address.latitude number | null (optional) Latitude pública da página; respeite a precisão declarada. -25.4878358
items[].address.longitude number | null (optional) Longitude pública da página. -49.3506335
items[].address.neighborhood string | null (optional) Bairro. Cidade Industrial
items[].address.state string | null (optional) Nome do estado. Paraná
items[].address.stateCode string | null (optional) Sigla do estado. PR
items[].address.street string | null (optional) Logradouro informado pelo anunciante. Rua Durval Leopoldo Landal 875
items[].address.visibility string | null (optional) Precisão declarada pela fonte, como EXACT ou APPROXIMATE. EXACT
items[].amenities array (optional) Amenidades agrupadas, como piscina, elevador ou mobiliado. []
items[].code string | null (optional) Código do imóvel na imobiliária. AP0009
items[].contact.partialPhone string | null (optional) Telefone parcial; não é completado por inferência. N/A
items[].contact.phone string | null (optional) Telefone completo quando explicitamente retornado. N/A
items[].contact.whatsapp string | null (optional) WhatsApp já presente no HTML público; não envia mensagem nem cria lead. 55 41996198388
items[].costsText string | null (optional) Texto original do bloco de encargos no PDP. N/A
items[].description string | null (optional) Descrição completa retornada pela página, em texto. N/A
items[].descriptionHtml string | null (optional) Descrição em HTML quando disponível no PDP. N/A
items[].expenses object | null (optional) Condomínio publicado, sem inferir periodicidade. {"amount":338,"currency":"BRL","formatted":"338","symbol":"R$"}
items[].expenses.amount number | null (optional) Valor numérico do condomínio. 338
items[].features object (optional) Características com IDs, rótulos, medidas e valores originais. {"CFT100":{"featureId":"CFT100","label":"Área total","measure":"m²","value":"43","featureCategoryId":"CFC2"},"CFT101":{"featureId":"CFT101","label":"Área útil","measure":"m²","value":"43","featureCategoryId":"CFC2"},"CFT2":{"featureId":"CFT2","label":"Quartos","value":"2","featureCategoryId":"CFC1"},"CFT3":{"featureId":"CFT3","label":"Banheiro","value":"1","featureCategoryId":"CFC1"},"CFT7":{"featureId":"CFT7","label":"Vaga","value":"1","featureCategoryId":"CFC1"},"CFT5":{"featureId":"CFT5","label":"Idade do imóvel","value":"25","featureCategoryId":"CFC1"}}
items[].generatedTitle string | null (optional) Resumo gerado pela fonte com área e tipologia. Apartamento · 43m² · 2 Quartos · 1 Vaga
items[].hasPlans boolean | null (optional) Indicador da fonte para plantas. false
items[].hasTour boolean | null (optional) Indicador da fonte para tour virtual. false
items[].hasVideos boolean | null (optional) Indicador da fonte para vídeo. true
items[].id string (optional) Identificador público do anúncio. 3046251226
items[].imageCount integer (optional) Quantidade de imagens retornadas nesta chamada. 8
items[].images array (optional) Imagens disponíveis nesta página. [{"url":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971864.jpg?isFirstImage=true","order":0,"caption":"ba380bfd7335ed97098f93390c3bc8da7093b65a · Apartamento com 2 dormitórios para alugar, 43 m² por R$ 1.652,00 - Cidade Industrial - Curitiba/PR","originalWidth":1080,"originalHeight":719,"variants":{"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"}},{"url":"https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971922.jpg","order":1,"caption":"b5bb7b3e909bd477f83cf6af25450106d378b239","originalWidth":1080,"originalHeight":719,"variants":{"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"}}]
items[].images[].caption string | null (optional) Legenda ou nome original da imagem. ba380bfd7335ed97098f93390c3bc8da7093b65a · Apartamento com 2 dormitórios para alugar, 43 m² por R$ 1.652,00 - Cidade Industrial - Curitiba/PR
items[].images[].originalHeight number | null (optional) Altura original informada. 719
items[].images[].originalWidth number | null (optional) Largura original informada, não necessariamente a resolução da variante. 1080
items[].images[].url string (URL) (optional) Maior variante publicada no objeto da imagem. https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971864.jpg?isFirstImage=true
items[].images[].variants object (optional) URLs de todas as resoluções publicadas. {"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"}
items[].iptu object | null (optional) IPTU explicitamente publicado; não é inferido da descrição nem tratado automaticamente como mensal. N/A
items[].iptu.amount number | null (optional) Valor do IPTU publicado no bloco de custos. N/A
items[].modifiedAt string | null (optional) Data de modificação fornecida pela listagem. 2026-09-26T23:13:53-0400
items[].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$"}]}]
items[].operations[].name string | null (optional) Operação anunciada, como aluguel ou venda. Aluguel
items[].postingType string | null (optional) Tipo de anúncio, como PROPERTY. PROPERTY
items[].price object | null (optional) Primeiro preço anunciado; não soma automaticamente encargos. {"amount":1250,"currency":"BRL","formatted":"1.250","symbol":"R$"}
items[].price.amount number | null (optional) Preço nominal em reais, sem conversão de centavos. 1250
items[].price.currency string | null (optional) Moeda; BRL para R$. BRL
items[].price.formatted string | null (optional) Valor formatado pela fonte. 1.250
items[].property.ageYears number | null (optional) Idade do imóvel, diferente da data de publicação. 25
items[].property.areaUnit string | null (optional) Unidade de medida, normalmente m². m²
items[].property.bathrooms number | null (optional) Banheiros. 1
items[].property.bedrooms number | null (optional) Quartos. 2
items[].property.parkingSpaces number | null (optional) Vagas de garagem; ausência não significa zero. 1
items[].property.suites number | null (optional) Suítes, quando informado. N/A
items[].property.totalArea number | null (optional) Área total. 43
items[].property.type string | null (optional) Tipo de imóvel. Apartamentos
items[].property.typeId string | null (optional) Identificador do tipo na fonte. 2
items[].property.usableArea number | null (optional) Área útil/privativa. 43
items[].publicationLabel string | null (optional) Rótulo relativo de publicação, mantido separado da data absoluta. N/A
items[].publishedAt string | null (optional) Data de publicação fornecida pelo PDP. N/A
items[].publisher.createdAtEpochMs number | null (optional) Data de cadastro do anunciante em milissegundos, quando retornada. 1413864000000
items[].publisher.id string | null (optional) ID do anunciante. 30004499
items[].publisher.license string | null (optional) Registro profissional informado pela fonte. 5404-J
items[].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
items[].publisher.name string | null (optional) Nome publicado da imobiliária ou anunciante. Imobiliária Time
items[].publisher.premier boolean | null (optional) Selo comercial publicado. true
items[].publisher.typeId string | number | null (optional) Tipo de anunciante na fonte. 2
items[].publisher.url string (URL) | null (optional) Página pública do anunciante. https://www.imovelweb.com.br/imobiliarias/imobiliaria-time_30004499-imoveis.html
items[].raw object (optional) Objeto completo do anúncio publicado na página, incluindo campos ainda não normalizados e valores nulos. {"postingCode":"AP0009"}
items[].recentViews number | null (optional) Contagem publicada de visualizações recentes; não representa necessariamente o total histórico. N/A
items[].reserved boolean | null (optional) Indicação de reserva, preservando false. false
items[].status string | null (optional) Status informado pela fonte. ONLINE
items[].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
items[].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
items[].videos array (optional) Referências de vídeos publicadas, sem carregar o vídeo. []
metadata object (optional) Metadados públicos de SEO. {"description":"No Imovelweb você encontra 4.321 Apartamentos para alugar em Curitiba, PR. Explore as melhores ofertas agora de aluguel de apartamentos em Curitiba, PR.","robots":"index,follow, max-image-preview:large"}
nextPageUrl string (URL) | null (optional) URL da próxima página, ou null no fim. https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr-pagina-2.html
page integer | null (optional) Página efetiva retornada. 1
pageSize integer | null (optional) Tamanho nominal de página informado pela fonte. 30
pageTitle string | null (optional) Título HTML da página. 4.321 Apartamentos para alugar em Curitiba, PR - Imovelweb
paging object (optional) Paginação completa fornecida pelo site. {"total":4321,"offset":0,"limit":30,"totalPages":145,"currentPage":1,"showFrom":1,"showUntil":5,"pages":[1,2],"firstPage":true,"lastPage":false,"total5A":318,"pagesUrl":{"1":"/apartamentos-aluguel-curitiba-pr.html","2":"/apartamentos-aluguel-curitiba-pr-pagina-2.html","3":"/apartamentos-aluguel-curitiba-pr-pagina-3.html","4":"/apartamentos-aluguel-curitiba-pr-pagina-4.html","5":"/apartamentos-aluguel-curitiba-pr-pagina-5.html","nextPage":"/apartamentos-aluguel-curitiba-pr-pagina-2.html"}}
parser "1.0.0" Versão pública do formato de resposta. 1.0.0
seo object (optional) Contexto público da categoria. N/A
sort object | array | null (optional) Ordenação informada pela fonte. {"type":"sort","options":[{"label":"Relevantes","min":"relevance","selected":true},{"label":"Mais baratos","min":"low_price","selected":false}]}
source "imovelweb.com.br" Fonte dos dados. imovelweb.com.br
title string | null (optional) Título da busca. 4.321 Apartamentos para alugar em Curitiba, PR
total integer | null (optional) Total informado pela fonte; pode variar entre chamadas. 4321
totalPages integer | null (optional) Número de páginas informado. 145
type "plp" Tipo de extração. plp
url string (URL) URL pública consultada, incluindo a página solicitada. https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.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.