{
"data": {
"count": 37,
"listings": [
{
"agency": {
"name": "Tetus - Soluções Imobiliárias",
"type": "AGENCY"
},
"areaSquareMeters": 62,
"bedrooms": 1,
"id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
"isPrivateOwner": false,
"location": {
"council": "Lisboa",
"district": "Lisboa",
"fullName": "Entrecampos, Avenidas Novas, Lisboa, Lisboa",
"neighborhood": "Entrecampos",
"parish": "Avenidas Novas"
},
"postedAt": "2026-10-09T14:46:28Z",
"price": {
"amount": 480000,
"currency": "EUR"
},
"pricePerSquareMeter": {
"amount": 7741.94,
"currency": "EUR"
},
"propertyType": "apartment",
"source": "imovirtual",
"title": "Apartamento T1, com varanda e parqueamento - Avenidas Novas",
"transaction": "sale",
"url": "https://www.imovirtual.com/pt/anuncio/apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm"
}
],
"query": {
"bedrooms": null,
"country": "pt",
"location": "lisboa",
"maxPrice": null,
"minPrice": null,
"page": 1,
"propertyType": "apartment",
"type": "sale"
},
"sources": [
{
"count": 37,
"error": null,
"source": "imovirtual"
}
]
},
"error": null,
"message": "Found 37 listing(s) across 2/3 source(s)."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38306/search+listings?location=lisboa&type=sale&propertyType=apartment&country=pt&page=1' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"avgPrice": 1016371.64,
"avgPricePerSquareMeter": 7226.98,
"count": 67,
"maxPrice": 2600000,
"medianPricePerSquareMeter": 6612.9,
"minPrice": 315000,
"pricedListings": 67,
"query": {
"bedrooms": null,
"country": "pt",
"location": "lisboa",
"maxPrice": null,
"minPrice": null,
"page": 1,
"propertyType": "apartment",
"type": "sale"
},
"sampleSize": 67,
"scope": "current-search-page",
"sources": [
{
"count": 37,
"error": null,
"source": "imovirtual"
}
]
},
"error": null,
"message": "Summary of the current search page."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38307/search+summary?location=lisboa&type=sale&propertyType=apartment&country=pt&page=1' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"count": 67,
"facets": {
"bedrooms": [
{
"count": 11,
"value": 1
}
],
"propertyType": [
{
"count": 67,
"value": "apartment"
}
],
"source": [
{
"count": 37,
"value": "imovirtual"
}
],
"transaction": [
{
"count": 67,
"value": "sale"
}
]
},
"query": {
"bedrooms": null,
"country": "pt",
"location": "lisboa",
"maxPrice": null,
"minPrice": null,
"page": 1,
"propertyType": "apartment",
"type": "sale"
},
"scope": "current-search-page",
"sources": [
{
"count": 37,
"error": null,
"source": "imovirtual"
}
]
},
"error": null,
"message": "Observed values in the current search page."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38308/search+facets?location=lisboa&type=sale&propertyType=apartment&country=pt&page=1' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"countries": {
"es": [
"fotocasa",
"idealista"
]
},
"maxBatchSize": 20,
"sections": [
"media",
"features",
"location",
"advertiser",
"pricing"
]
},
"error": null,
"message": "Listing source capabilities."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38309/listing+sources?country=es' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"address": {
"country": null,
"postalCode": null,
"street": "Rua Soeiro Pereira Gomes"
},
"advertiser": {
"name": "Tetus - Soluções Imobiliárias",
"url": "https://www.imovirtual.com/pt/empresas/agencias-imobiliarias/tetus-solucoes-imobiliarias-ID1087"
},
"agency": {
"name": "Tetus - Soluções Imobiliárias",
"type": "agency"
},
"amenities": [
"lift"
],
"areaSquareMeters": 62,
"bathrooms": 1,
"bedrooms": 1,
"characteristics": {
"building_type": "block",
"construction_status": "ready_to_use",
"energy_certificate": "c",
"heating": "other",
"m": "62",
"market": "secondary",
"price": "480000",
"price_per_m": "7741.94",
"rooms_num": "2"
},
"condition": "ready_to_use",
"constructionYear": null,
"coordinates": {
"isExact": null,
"latitude": 38.74468,
"longitude": -9.15954
},
"description": "Apartamento T1, no piso 6 de um prédio composto por apartamentos com varandas e parqueamentos, com boas áreas de acesso comum.",
"energy": {
"certificateUrl": null,
"consumption": null,
"emissions": null,
"emissionsRating": null,
"rating": "C"
},
"featureLabels": {
"m": "62 m²",
"price": "480 000 €",
"price_per_m": "7741,94 €/m²",
"rooms_num": "2"
},
"floor": null,
"hasElevator": true,
"hasVirtualTour": null,
"id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
"images": [
"https://ireland.apollo.olxcdn.com/v1/files/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmbiI6Im41a2pwbjM2OWE4ZS1FQ09TWVNURU0iLCJ3IjpbeyJmbiI6IjY5bmxwYTdlY3FtNzEtQVBUIiwicyI6IjE2IiwiYSI6IjAiLCJwIjoiMTAsLTEwIn1dfQ.w11RnrgZ1J..."
],
"isFurnished": null,
"isNewConstruction": null,
"isPrivateOwner": false,
"isTemporaryRental": null,
"location": {
"council": "Lisboa",
"district": "Lisboa",
"fullName": "Entrecampos, Avenidas Novas, Lisboa, Lisboa",
"neighborhood": "Entrecampos",
"parish": "Avenidas Novas"
},
"orientation": null,
"plotAreaSquareMeters": null,
"postedAt": "2026-10-09T14:46:28Z",
"price": {
"amount": 480000,
"currency": "EUR"
},
"pricePerSquareMeter": {
"amount": 7741.94,
"currency": "EUR"
},
"priceReduction": null,
"propertyAge": null,
"propertySubtype": null,
"propertyType": "apartment",
"reference": "18590",
"source": "imovirtual",
"title": "Apartamento T1, com varanda e parqueamento - Avenidas Novas",
"totalFloors": null,
"transaction": "sale",
"updatedAt": "2026-11-09T11:53:37.000Z",
"url": "https://www.imovirtual.com/pt/anuncio/apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
"usableAreaSquareMeters": null
},
"error": null,
"message": "Listing found."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38310/listing+detail&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"hasVirtualTour": null,
"id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
"images": [
"https://ireland.apollo.olxcdn.com/v1/files/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmbiI6Im41a2pwbjM2OWE4ZS1FQ09TWVNURU0iLCJ3IjpbeyJmbiI6IjY5bmxwYTdlY3FtNzEtQVBUIiwicyI6IjE2IiwiYSI6IjAiLCJwIjoiMTAsLTEwIn1dfQ.w11RnrgZ1J..."
],
"media": [
{
"type": "image",
"url": "https://ireland.apollo.olxcdn.com/v1/files/eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmbiI6Im41a2pwbjM2OWE4ZS1FQ09TWVNURU0iLCJ3IjpbeyJmbiI6IjY5bmxwYTdlY3FtNzEtQVBUIiwicyI6IjE2IiwiYSI6IjAiLCJwIjoiMTAsLTEwIn1dfQ.w11RnrgZ1J..."
}
],
"source": "imovirtual"
},
"error": null,
"message": "Listing media."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38311/listing+media&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"amenities": [
"lift"
],
"areaSquareMeters": 62,
"bathrooms": 1,
"bedrooms": 1,
"characteristics": {
"building_type": "block",
"construction_status": "ready_to_use",
"energy_certificate": "c",
"heating": "other",
"m": "62",
"market": "secondary",
"price": "480000",
"price_per_m": "7741.94",
"rooms_num": "2"
},
"condition": "ready_to_use",
"constructionYear": null,
"energy": {
"certificateUrl": null,
"consumption": null,
"emissions": null,
"emissionsRating": null,
"rating": "C"
},
"featureLabels": {
"m": "62 m²",
"price": "480 000 €",
"price_per_m": "7741,94 €/m²",
"rooms_num": "2"
},
"floor": null,
"hasElevator": true,
"id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
"isFurnished": null,
"isNewConstruction": null,
"isTemporaryRental": null,
"orientation": null,
"plotAreaSquareMeters": null,
"propertyAge": null,
"propertySubtype": null,
"propertyType": "apartment",
"source": "imovirtual",
"totalFloors": null,
"usableAreaSquareMeters": null
},
"error": null,
"message": "Listing features."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38312/listing+features&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"address": {
"country": null,
"postalCode": null,
"street": "Rua Soeiro Pereira Gomes"
},
"coordinates": {
"isExact": null,
"latitude": 38.74468,
"longitude": -9.15954
},
"id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
"location": {
"council": "Lisboa",
"district": "Lisboa",
"fullName": "Entrecampos, Avenidas Novas, Lisboa, Lisboa",
"neighborhood": "Entrecampos",
"parish": "Avenidas Novas"
},
"source": "imovirtual"
},
"error": null,
"message": "Listing location."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38313/listing+location&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"advertiser": {
"name": "Tetus - Soluções Imobiliárias",
"url": "https://www.imovirtual.com/pt/empresas/agencias-imobiliarias/tetus-solucoes-imobiliarias-ID1087"
},
"agency": {
"name": "Tetus - Soluções Imobiliárias",
"type": "agency"
},
"id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
"isPrivateOwner": false,
"reference": "18590",
"source": "imovirtual"
},
"error": null,
"message": "Listing advertiser."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38314/listing+advertiser&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"id": "imovirtual:apartamento-t1-com-varanda-e-parqueamento-avenidas-novas-ID1iZKm",
"postedAt": "2026-10-09T14:46:28Z",
"price": {
"amount": 480000,
"currency": "EUR"
},
"pricePerSquareMeter": {
"amount": 7741.94,
"currency": "EUR"
},
"priceReduction": null,
"source": "imovirtual",
"transaction": "sale",
"updatedAt": "2026-11-09T11:53:37.000Z"
},
"error": null,
"message": "Listing pricing."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38315/listing+pricing&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"area": "lisboa",
"country": "pt",
"grossRentalYieldPercent": 4.23,
"propertyType": "apartment",
"rent": {
"avgPrice": 4014.96,
"avgPricePerSquareMeter": 57.79,
"maxPrice": 420000,
"medianPricePerSquareMeter": 23.33,
"minPrice": 630,
"sampleSize": 199
},
"resolvedLocation": "lisboa/lisboa",
"sale": {
"avgPrice": 1074529.65,
"avgPricePerSquareMeter": 7441.27,
"maxPrice": 10000000,
"medianPricePerSquareMeter": 6621.62,
"minPrice": 270000,
"sampleSize": 199
},
"sources": [
{
"error": null,
"source": "imovirtual"
}
]
},
"error": null,
"message": "Area stats for \"lisboa\"."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38316/area+market+stats?propertyType=apartment&country=pt&area=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"area": "lisboa",
"areaMarket": {
"rent": {
"avgPrice": 4018.63,
"avgPricePerSquareMeter": 57.84,
"maxPrice": 420000,
"medianPricePerSquareMeter": 23.33,
"minPrice": 630,
"sampleSize": 199
},
"sale": {
"avgPrice": 1074529.65,
"avgPricePerSquareMeter": 7441.27,
"maxPrice": 10000000,
"medianPricePerSquareMeter": 6621.62,
"minPrice": 270000,
"sampleSize": 199
}
},
"country": "pt",
"disclaimer": "Derived from currently listed asking prices for comparable units in the area; not an automated valuation model (AVM) and not a substitute for a professional appraisal.",
"estimate": {
"comparableCriteria": {
"bedrooms": 2,
"bedroomsMatched": true,
"sizeWindowPercent": 30
},
"confidence": "high",
"price": 520100,
"pricePerSquareMeter": 6501.25,
"priceRange": {
"high": 620502,
"low": 471689.2
},
"sampleSize": 34
},
"input": {
"areaSquareMeters": 80,
"bedrooms": 2
},
"method": "comparables-median-price-per-sqm",
"propertyType": "apartment",
"resolvedLocation": "lisboa/lisboa",
"sources": [
{
"error": null,
"source": "imovirtual"
}
],
"transaction": "sale"
},
"error": null,
"message": "Estimated sale price: 520100 EUR (high confidence, 34 comparable(s))."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38317/property+valuation?area=lisboa&areaSquareMeters=80&bedrooms=2&propertyType=apartment&transaction=sale&country=pt' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"area": "lisboa",
"benchmark": {
"avgPrice": 1074529.65,
"avgPricePerSquareMeter": 7441.27,
"maxPrice": 10000000,
"medianPricePerSquareMeter": 6621.62,
"minPrice": 270000,
"sampleSize": 199
},
"count": 3,
"country": "pt",
"deals": [
{
"agency": {
"name": "Century21 Dreamline",
"type": "AGENCY"
},
"areaSquareMeters": 2160,
"bedrooms": 0,
"benchmarkPricePerSquareMeter": 6621.62,
"dealScorePercent": 69.94,
"id": "imovirtual:oportunidade-para-investidores-no-coracao-de-lisboa-ID1hxZd",
"isPrivateOwner": false,
"location": {
"council": "Lisboa",
"district": "Lisboa",
"fullName": "Alto de São João - Alto do Varejão, Penha de França, Lisboa, Lisboa",
"neighborhood": "Alto de São João - Alto do Varejão",
"parish": "Penha de França"
},
"postedAt": "2025-11-18T10:39:28Z",
"price": {
"amount": 4300000,
"currency": "EUR"
},
"pricePerSquareMeter": {
"amount": 1990.74,
"currency": "EUR"
},
"propertyType": "apartment",
"source": "imovirtual",
"title": "OPORTUNIDADE PARA INVESTIDORES NO CORAÇÃO DE LISBOA",
"transaction": "sale",
"url": "https://www.imovirtual.com/pt/anuncio/oportunidade-para-investidores-no-coracao-de-lisboa-ID1hxZd"
}
],
"disclaimer": "A heuristic ranking against currently listed asking prices in the area, not a predictor of achieved sale price or an indicator that a listing is a scam, overpriced for a hidden reason, etc.",
"method": "percent-below-area-median-price-per-sqm",
"propertyType": "apartment",
"resolvedLocation": "lisboa/lisboa",
"scoredListings": 199,
"sources": [
{
"error": null,
"source": "imovirtual"
}
],
"transaction": "sale",
"unscored": 0
},
"error": null,
"message": "Found 3 potential deal(s) in \"lisboa\" out of 199 scored listing(s)."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38318/deal+finder?propertyType=apartment&transaction=sale&country=pt&limit=3&area=Required' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"listings": [
{
"agency": {
"name": "Tânia Cruz - RE/MAX",
"type": "agency"
},
"areaSquareMeters": 82,
"bedrooms": 2,
"id": "idealista:pt:35410511",
"isPrivateOwner": false,
"location": {
"address": "Apartamento T2 na Rua Germão Galharde, 16, São Victor",
"council": null,
"district": null,
"latitude": null,
"longitude": null,
"neighborhood": null,
"parish": null
},
"postedAt": null,
"price": {
"amount": 270000,
"currency": "EUR"
},
"pricePerSquareMeter": {
"amount": 3292.68,
"currency": "EUR"
},
"propertyType": "apartment",
"source": "idealista",
"title": "Apartamento T2 na Rua Germão Galharde, 16, São Victor",
"transaction": "sale",
"url": "https://www.idealista.pt/imovel/35410511/"
}
],
"pagination": {
"currentPage": 1,
"itemsPerPage": 30,
"totalItems": 1249,
"totalPages": 42
}
},
"error": null,
"message": "Idealista data retrieved."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38319/idealista+search?country=pt&location=braga&type=sale&propertyType=apartment&page=1' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"searchTotalResults": 1249,
"searchTotalResultsNoTypologyPhrase": "Ver 1.249 resultados",
"searchTotalResultsPhrase": "Ver 1.249 anúncios",
"searchTotalResultsWithTypologyPhrase": "Ver 1.249 casas"
},
"error": null,
"message": "Idealista data retrieved."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38320/idealista+result+totals?country=pt&location=braga&type=sale&propertyType=apartment' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": [
{
"category": "Zona",
"categoryAlias": null,
"categoryId": null,
"count": "993",
"hasChildZones": true,
"locationId": "0-EU-PT-03-03-001",
"parentLocationId": "0-EU-PT-03-03",
"seekablePostalCode": null,
"suggestedLocationId": 38575,
"text": "<b>Braga</b>, <b>Braga</b>",
"totalResults": 3681,
"url": "/comprar-casas/braga/braga/braga/",
"vacational": false,
"zoneOfInterest": false,
"zoneOfInterestAlias": null
}
],
"error": null,
"message": "Idealista data retrieved."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38321/idealista+location+suggestions?searchField=braga&country=pt' --header 'Authorization: Bearer YOUR_API_KEY'
{
"data": {
"address": null,
"advertiser": {
"name": "Tânia Cruz - RE/MAX",
"url": null
},
"agency": {
"name": "Tânia Cruz - RE/MAX",
"type": "agency"
},
"amenities": [
"Varanda"
],
"areaSquareMeters": 82,
"bathrooms": 1,
"bedrooms": 2,
"condition": "Segunda mão/bom estado",
"constructionYear": 1996,
"coordinates": null,
"description": "Apartamento T2 com garagem e elevador, localizado na Rua Germão Galharde, em Braga.",
"energy": {
"consumption": null,
"emissions": null,
"emissionsRating": null,
"rating": "C"
},
"featureLabels": [],
"floor": "5º andar",
"hasElevator": true,
"hasVirtualTour": null,
"id": "idealista:pt:35410511",
"images": [
"https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/3f/19/e4/331837072.jpg"
],
"isFurnished": null,
"isNewConstruction": null,
"isPrivateOwner": false,
"isTemporaryRental": null,
"location": {
"address": "São Victor, Braga",
"council": null,
"district": null,
"latitude": null,
"longitude": null,
"neighborhood": null,
"parish": null
},
"media": [
{
"type": "image",
"url": "https://img4.idealista.pt/blur/WEB_DETAIL-M-L/0/id.pro.pt.image.master/3f/19/e4/331837072.jpg"
}
],
"orientation": null,
"plotAreaSquareMeters": null,
"postedAt": null,
"price": {
"amount": 270000,
"currency": "EUR"
},
"pricePerSquareMeter": {
"amount": 3292.68,
"currency": "EUR"
},
"priceReduction": null,
"propertyAge": null,
"propertySubtype": null,
"propertyType": "apartment",
"reference": null,
"source": "idealista",
"title": "Apartamento T2 à venda na Rua Germão Galharde, 16",
"totalFloors": null,
"transaction": "sale",
"updatedAt": null,
"url": "https://www.idealista.pt/imovel/35410511/",
"usableAreaSquareMeters": null
},
"error": null,
"message": "Listing found."
}
curl --location --request GET 'https://zylalabs.com/api/14784/iberian+real+estate+api/38322/idealista+listing+detail&country=Required&/=Required&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Inmobiliaria Ibérica API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento.
Listados de propiedades en vivo para Portugal, España, Italia y Francia de Idealista, Imovirtual, Fotocasa y Casa Sapo en una API JSON, con detalles de las listados, estadísticas de precio por m2, rendimiento de alquiler, valoración y un buscador de ofertas
Portugal (Imovirtual Casa Sapo Idealista) España (Fotocasa Idealista) Italia (Idealista) y Francia (Idealista)
Cada respuesta tiene error datos y mensaje Verifica el error primero los datos son nulos en cualquier error
La solicitud aún tiene éxito con los otros portales Siempre verifica el arreglo de fuentes en la respuesta para un error no nulo en cualquier fuente
Utiliza el id exactamente como lo devuelva la búsqueda, por ejemplo imovirtual:some-slug. Nunca construyas un id a partir de una URL de portal o número de anuncio
Evalúa su propiedad al precio medio por m2 de anuncios comparables actualmente en el mercado Verifique la confianza y el tamaño de la muestra No se trata de una tasación profesional
No Todas las cifras provienen de los precios actuales solicitados en listados en vivo no de precios de venta o alquiler logrados
Contacta al soporte en Telegram @pintoflow para preguntas nuevos campos o límites más altos