imovelweb.com.br
Imovelweb API
Query public Imovelweb data with GeckoAPI and receive structured JSON. Choose an operation to review its inputs, credit cost and response fields.
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.
GeckoAPI is independent of Imovelweb. This integration reads public data; it does not grant access to private accounts or account management operations.
Available operations
Search listings
imovelweb.com.br:plp
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.
1 credit per request
Get listing details
imovelweb.com.br:pdp
Extracts an ad from Imovelweb with complete description, prices, condominium, IPTU, address, coordinates, areas, rooms, amenities, advertiser, public contact, photos and videos. It costs 1 credit per call.
1 credit per request
These are standard credit costs. Account-specific pricing is shown in the dashboard. Each operation has its own supported inputs and regional coverage.
Coverage and 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.
Make your first request
The example uses search listings. Replace YOUR_API_KEY with your server-side API key. Copy supported inputs from the reference for the operation you choose.
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"
}'Example JSON response
Abbreviated example from the same operation. Arrays and nested objects are shortened here; the endpoint reference includes the full documented schema. Source content retains its original language.
{
"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"
}
},
{
"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"
}
}
],
"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"
}
}
}Integrate with REST or MCP
Call POST /v1/extract from your backend, or use the operation-specific tool on POST /v1/mcp. The API reference includes both request formats. Keep credentials in your backend and handle missing fields, pagination and errors according to that operation's rules.
Ready to test the Imovelweb API?
Open the documented example in the sandbox and inspect the response before integrating it into your application.