// docs

Imovelweb: Search listings

Extracts a results page from Imovelweb with properties, prices, condominium, characteristics, location, advertiser, public contact, photos, filters and pagination. Costs 1 credit per call; each next page is a new call.

imovelweb.com.br:plp · 1 credit per request

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

Try this operation in the sandbox

Source-specific limitations

Unpublished fields return null or empty lists. Examples are abbreviated: only some items and images are shown; counters reflect the original page. Prices and dates can change, and no billing period is assumed for costs.

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": "imovelweb.com.br",
  "type": "plp",
  "url": "https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.html"
}'

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

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

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 HTTPS Imovelweb results ending in .html. Filters from the URL are preserved.	-	https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.html
target Target source for extraction.	enum	Required	Always imovelweb.com.br.	-	imovelweb.com.br
type Extraction type: pdp, idp, plp, ilp, quote, review or places.	enum	Required	Always plp.	-	plp
page Pagination. In PLP, including Trivago, and in Reclame AQUI ILP starts in 1; in review (MercadoLivre, Booking and Hotels) starts in 0. The Reclame AQUI ILP even accepts the page 100.	integer	Optional	Integer from 1 to 500. If omitted, preserves the URL page; when sent, it takes precedence. Does not scroll through multiple pages automatically.	-	2

Request examples

Search for URL

Use the public search URL with the desired filters.

Search for URL

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

page replaces the URL page. Each call returns one page and costs 1 credit. It is also possible to send nextPageUrl without page.

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

Response schema

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

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

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

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

Complete field reference

Path	Type	Description	Example
appliedFilters	array \| object \| null (optional)	Filters effectively applied by the source.	[{"type":"location","options":[{"label":"Curitiba","type":"city","min":"106015"}],"renderType":5},{"type":"operationType","options":[{"label":"Alugar","min":"2"}],"renderType":3}]
breadcrumbs	array \| null (optional)	Navigation by region and category.	[{"url":"/","nombre":"Imovelweb","isLast":false,"index":1},{"url":"/apartamentos-aluguel.html","nombre":"Apartamentos para alugar","isLast":false,"index":2}]
canonicalUrl	string (URL)	URL canonical declared by the page.	https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.html
count	integer (optional)	Number of ads on this page.	30
extractedAt	string (ISO datetime)	Extraction instant.	2026-09-27T15:52:50.496453+00:00
filters	array \| object \| null (optional)	Facets and filters published in the search.	N/A
hasNextPage	boolean (optional)	Indicates existence of next page.	true
items[].additionalImageCount	integer \| null (optional)	Additional images indicated in PLP, available when consulting PDP.	12
items[].address.city	string \| null (optional)	City.	Curitiba
items[].address.country	string \| null (optional)	Country.	Brasil
items[].address.hierarchy	array (optional)	Location hierarchy, with source IDs.	[{"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)	Public page latitude; respect the declared accuracy.	-25.4878358
items[].address.longitude	number \| null (optional)	Public page length.	-49.3506335
items[].address.neighborhood	string \| null (optional)	Neighborhood.	Cidade Industrial
items[].address.state	string \| null (optional)	State name.	Paraná
items[].address.stateCode	string \| null (optional)	State acronym.	PR
items[].address.street	string \| null (optional)	Street provided by the advertiser.	Rua Durval Leopoldo Landal 875
items[].address.visibility	string \| null (optional)	Accuracy declared by the source, such as EXACT or APPROXIMATE.	EXACT
items[].amenities	array (optional)	Grouped amenities, such as swimming pool, elevator or furnished.	[]
items[].code	string \| null (optional)	Property code in the real estate agency.	AP0009
items[].contact.partialPhone	string \| null (optional)	Partial telephone; is not completed by inference.	N/A
items[].contact.phone	string \| null (optional)	Full phone number when explicitly returned.	N/A
items[].contact.whatsapp	string \| null (optional)	WhatsApp already present in public HTML; does not send message or create lead.	55 41996198388
items[].costsText	string \| null (optional)	Original text of the charge block in PDP.	N/A
items[].description	string \| null (optional)	Complete description returned by the page, in text.	N/A
items[].descriptionHtml	string \| null (optional)	Description in HTML when available in PDP.	N/A
items[].expenses	object \| null (optional)	Condominium published, without inferring periodicity.	{"amount":338,"currency":"BRL","formatted":"338","symbol":"R$"}
items[].expenses.amount	number \| null (optional)	Numerical value of the condominium.	338
items[].features	object (optional)	Characteristics with IDs, labels, measurements and original values.	{"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)	Summary generated by the source with area and typology.	Apartamento · 43m² · 2 Quartos · 1 Vaga
items[].hasPlans	boolean \| null (optional)	Source indicator for plants.	false
items[].hasTour	boolean \| null (optional)	Source indicator for virtual tour.	false
items[].hasVideos	boolean \| null (optional)	Source indicator for video.	true
items[].id	string (optional)	Public identifier for the ad.	3046251226
items[].imageCount	integer (optional)	Number of images returned in this call.	8
items[].images	array (optional)	Images available on this page.	[{"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)	Caption or original name of the image.	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)	Original height reported.	719
items[].images[].originalWidth	number \| null (optional)	Original width reported, not necessarily the resolution of the variant.	1080
items[].images[].url	string (URL) (optional)	Largest variant published on image object.	https://imgbr.imovelwebcdn.com/avisos/2/30/46/25/12/26/720x532/7238971864.jpg?isFirstImage=true
items[].images[].variants	object (optional)	URLs of all published resolutions.	{"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 explicitly published; it is not inferred from the description nor automatically treated as monthly.	N/A
items[].iptu.amount	number \| null (optional)	Value of IPTU published in the cost block.	N/A
items[].modifiedAt	string \| null (optional)	Modification date provided by listing.	2026-09-26T23:13:53-0400
items[].operations	array (optional)	All operations and their prices, without discarding ads with more than one operation.	[{"id":"2","name":"Aluguel","prices":[{"amount":1250,"currency":"BRL","formatted":"1.250","symbol":"R$"}]}]
items[].operations[].name	string \| null (optional)	Announced transaction, such as rental or sale.	Aluguel
items[].postingType	string \| null (optional)	Ad type, such as PROPERTY.	PROPERTY
items[].price	object \| null (optional)	First price announced; does not automatically add charges.	{"amount":1250,"currency":"BRL","formatted":"1.250","symbol":"R$"}
items[].price.amount	number \| null (optional)	Nominal price in reais, without cent conversion.	1250
items[].price.currency	string \| null (optional)	Currency; BRL for R$.	BRL
items[].price.formatted	string \| null (optional)	Source-formatted value.	1.250
items[].property.ageYears	number \| null (optional)	Age of the property, different from the publication data.	25
items[].property.areaUnit	string \| null (optional)	Unit of measurement, normally m².	m²
items[].property.bathrooms	number \| null (optional)	Bathrooms.	1
items[].property.bedrooms	number \| null (optional)	Rooms.	2
items[].property.parkingSpaces	number \| null (optional)	Parking spaces; absence does not mean zero.	1
items[].property.suites	number \| null (optional)	Suites, when noted.	N/A
items[].property.totalArea	number \| null (optional)	Total area.	43
items[].property.type	string \| null (optional)	Type of property.	Apartamentos
items[].property.typeId	string \| null (optional)	Type identifier in the font.	2
items[].property.usableArea	number \| null (optional)	Useful/private area.	43
items[].publicationLabel	string \| null (optional)	Relative publication label, kept separate from the absolute data.	N/A
items[].publishedAt	string \| null (optional)	Publication date provided by PDP.	N/A
items[].publisher.createdAtEpochMs	number \| null (optional)	Advertiser registration date in milliseconds when returned.	1413864000000
items[].publisher.id	string \| null (optional)	ID from the advertiser.	30004499
items[].publisher.license	string \| null (optional)	Professional record reported by source.	5404-J
items[].publisher.logoUrl	string (URL) \| null (optional)	Advertiser logo.	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)	Published name of the real estate agency or advertiser.	Imobiliária Time
items[].publisher.premier	boolean \| null (optional)	Commercial seal published.	true
items[].publisher.typeId	string \| number \| null (optional)	Advertiser type in source.	2
items[].publisher.url	string (URL) \| null (optional)	Advertiser's public page.	https://www.imovelweb.com.br/imobiliarias/imobiliaria-time_30004499-imoveis.html
items[].raw	object (optional)	Complete object of the ad published on the page, including fields not yet normalized and null values.	{"postingCode":"AP0009"}
items[].recentViews	number \| null (optional)	Published recent view count; does not necessarily represent the historical total.	N/A
items[].reserved	boolean \| null (optional)	Reserve indication, preserving false.	false
items[].status	string \| null (optional)	Status reported by the source.	ONLINE
items[].title	string \| null (optional)	Ad title.	Apartamento com 2 dormitórios para alugar, 43 m² por R$ 1.652,00 - Cidade Industrial - Curitiba/PR
items[].url	string (URL) (optional)	URL public property.	https://www.imovelweb.com.br/propriedades/apartamento-com-2-dormitorios-para-alugar-43-m-por-3046251226.html
items[].videos	array (optional)	Video references published, without loading the video.	[]
metadata	object (optional)	Public metadata for 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 on the next page, or null at the end.	https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr-pagina-2.html
page	integer \| null (optional)	Effective page returned.	1
pageSize	integer \| null (optional)	Nominal page size reported by source.	30
pageTitle	string \| null (optional)	Title HTML of the page.	4.321 Apartamentos para alugar em Curitiba, PR - Imovelweb
paging	object (optional)	Full pagination provided by the website.	{"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"	Public version of the response format.	1.0.0
seo	object (optional)	Public category context.	N/A
sort	object \| array \| null (optional)	Ordering informed by the source.	{"type":"sort","options":[{"label":"Relevantes","min":"relevance","selected":true},{"label":"Mais baratos","min":"low_price","selected":false}]}
source	"imovelweb.com.br"	Data source.	imovelweb.com.br
title	string \| null (optional)	Search title.	4.321 Apartamentos para alugar em Curitiba, PR
total	integer \| null (optional)	Total reported by source; may vary between calls.	4321
totalPages	integer \| null (optional)	Number of pages entered.	145
type	"plp"	Extraction type.	plp
url	string (URL)	URL consulted, including the requested page.	https://www.imovelweb.com.br/apartamentos-aluguel-curitiba-pr.html

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.

Other Imovelweb operations

Get listing details (PDP)

Imovelweb: Search listings

Source-specific limitations

HTTP request

MCP request

Supported inputs

Request examples

Search for URL

Next page

Response schema

Example response

Complete field reference

Errors and missing data

Other Imovelweb operations