Idealista Property Listings API for Spain, Portugal & Italy APIs
Resolve Idealista location IDs, then search homes for sale or rent, new builds, commercial premises, offices, land, whole buildings and storage rooms across Spain, Portugal and Italy. Independent, read-only listing data for property research. It is not an official Idealista integration, a listing-publishing service or a transaction record.
Open the standalone Idealista data demoYour first location autocomplete request
Replace <API_KEY> with your authorized platform API key from the dashboard. Query URLs contain your key; keep it out of shared links, screenshots, source control and logs, and make production calls server-side.
The example autocompletes the text madrid for homes for sale on the Spanish site (location=es, operation=sale, prefix=madrid, propertyType=homes). In the recorded check the matches mixed the municipality, the province and individual districts, each with its own locationId and listing total. Choose the entry whose name and subTypeText fit your target and reuse its locationId unchanged in a listing search. The request is read-only, needs no Idealista account credential and does not guarantee the same matches later.
Base URL https://api.opendata-api.com
curl -X GET 'https://api.opendata-api.com/api/project/idealista/get-suggestions?key=<API_KEY>&location=es&operation=sale&prefix=madrid&propertyType=homes'import requests
response = requests.request(
"GET",
"https://api.opendata-api.com/api/project/idealista/get-suggestions",
params={
"key": "<API_KEY>",
"location": "es",
"operation": "sale",
"prefix": "madrid",
"propertyType": "homes",
},
timeout=30,
)
response.raise_for_status()
print(response.json())const url = new URL("https://api.opendata-api.com/api/project/idealista/get-suggestions");
url.search = new URLSearchParams({
"key": "<API_KEY>",
"location": "es",
"operation": "sale",
"prefix": "madrid",
"propertyType": "homes",
}).toString();
const response = await fetch(url, {
method: "GET",
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());Idealista location and listing request basics
- Resolve a place with get-suggestions, choose the entry whose name and subTypeText match your target, and send its locationId exactly as returned, for example 0-EU-ES-28-07-001-079 for the Madrid municipality. The same text can return a municipality, a province and districts with very different totals, so a province ID is not a city ID. Totals depend on the operation and property type used in the lookup; recheck them when either changes.
- Send one value per selector. location is es, pt or it; locale is one of es, it, pt, en, ca, de, fr, nl or nb; operation is sale or rent; order is one of twelve sort keys. For sinceDate, T (last 24 hours) is rent-only and Y (last 48 hours) is sale-only. furnished is also a single-value selector, not a boolean: leave it blank, or send furnished or furnishedKitchen, and only with operation=rent.
- Boolean flags such as petsAllowed or swimmingPool are sent as true to apply them and left out to ignore them; the reference expresses false by omitting the parameter. An explicit false was not observed here, so do not use it to ask for the opposite. Rent-only flags such as petsAllowed need operation=rent. How several flags combine is not documented, so compare totals on your own searches before relying on a combination.
- numPage starts at 1 and totalPages in the response bounds it. maxItems defaults to 30 with a documented maximum of 40; the recorded Madrid sale search used maxItems 5 and reported total 19806 over 3962 pages, so a small page size multiplies the page count. Count-only mode (maxItems 0) is documented but was not exercised. Every page is a separate platform request, so plan the page count before walking a large result set.
Check business status before reading listings
Check HTTP status separately from the gateway's code/message/data business status: code 200 indicates gateway business success, but HTTP 200 alone does not. Then inspect the operation payload before using elementList, locations or property fields. A listing search reports total, totalPages and totalAppliedFilters; a zero total or an empty list is a result to record, not proof that an area has no stock, and a missing field is unknown rather than zero.
Choose your Idealista data workflow
- Turn place names into location IDs
-
Start with get-suggestions: send location (es, pt or it), operation (sale or rent), prefix and propertyType, then copy the chosen entry's locationId. Entries mix municipalities, provinces and districts, each with its own total for the chosen operation and property type. Use get-sublocations only on an entry flagged divisible=true to drill into its districts or municipalities; its bedrooms property type works only with rent. Both operations return places and counts, never property listings.
- Search homes for sale or rent
-
list-home-properties requires locationId, location, locale, operation, order, maxItems and numPage. Optional inputs add price and size bounds, a publication window, an agency filter, a furnished selector for rentals and 49 boolean flags. Only an unfiltered sale search was recorded; it returned elementList with total, totalPages and totalAppliedFilters. Rent searches, filtered searches, the count-only mode and flag combinations are documented but unverified, so inspect your first response before relying on them.
- Find new builds and promotion units
-
list-new-homes searches new-build homes for one location, with optional filters for flats, houses, bedroom counts and price; a Madrid sale search returned the same listing-page envelope as home search. list-promotion-properties lists the units of one promotion and requires parentPromotionId plus propertyType (homes or garages) taken from promotionProperties; it has no paging and no recorded response, so confirm in a live listing where the promotion identifier appears before chaining calls.
- Search commercial premises, offices, land and storage
-
list-commercial-properties, list-offices, list-lands, list-buildings and list-storage-rooms take the same core inputs as home search (locationId, location, locale, operation, order, maxItems, numPage) plus price, size and publication-window filters. Commercial premises add premises-type and business-activity flags; offices add layout and amenity flags. None of these five has a recorded response, so expect a listing-page envelope like home search but check the first response before mapping fields, and use the page sizes each endpoint lists.
- Read one listing in full
-
property-details requires propertyId, location and language (the language of the ad text). A listing card's propertyCode is the numeric ID that appears in its listing url. The recorded Spain sale listing returned price, operation, property type, photos, coordinates, characteristics, contact type and a modification date. The location block includes a hasHiddenAddress flag, so check it before treating coordinates as a street address.
- Look up an agency microsite and its coverage
-
get-microsite-profile takes micrositeShortName, the slug after /pro/ in an agency profile address, plus location; the recorded profile returned the agency name, website, contact details, languages and address. get-microsite-locations requires micrositeShortName, location, locale, locationId and operation and has no recorded response. Neither returns the agency's listings; to limit a listing search to one agency, pass micrositeShortName to a listing endpoint.
Locations
/api/project/idealista/get-sublocations List sublocations inside a divisible Idealista location, with listing totals per area
Full docs βDetails
Returns the child locations of a parent Idealista location, such as the districts or municipalities under a province, so you can drill down from a coarse place to a finer one. Send the country code (location: es, pt or it), the parent locationId (it must be a location flagged divisible=true, for example 0-EU-ES-28), and the operation and propertyType filters that decide which listings are counted in each child's total. The bedrooms property type only works together with the rent operation. In the recorded probe (location=es, locationId=0-EU-ES-28, operation=sale, propertyType=homes) the endpoint answered HTTP 200 with a JSON object holding a locations array and an integer total; each locations entry carried name, locationId, divisible, type, suggestedLocationId, subTypeText and an integer total. The endpoint returns places and counts only, never the property listings themselves.
Test this Idealista endpoint 4 required Β· 0 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
Request cost is temporarily unavailable. No price is assumed.
Agency Microsites
/api/project/idealista/get-microsite-locations List the locations where an Idealista agency microsite has properties
Full docs βDetails
Returns the places where a given agency microsite (professional profile) has properties, so you can see the agency's coverage area. Identify the agency with micrositeShortName (the slug that appears after /pro/ in its profile address, for example sumainmobiliaria), choose the country with location (es, pt or it), the response language with locale (es, it, pt, en, ca, de, fr, nl or nb), and supply a locationId (documented example 0-EU-ES-28) and an operation (documented example sale). All five inputs are required. No successful probe was recorded for this operation, so the exact response fields are not verified here; the endpoint is documented as returning the locations where the microsite has properties, and its structure should be checked on the first call before you build parsers around it.
Test this Idealista endpoint 5 required Β· 0 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query |
Request cost is temporarily unavailable. No price is assumed.
/api/project/idealista/get-microsite-profile Get an Idealista agency microsite profile with name, website, contact info and languages
Full docs βDetails
Returns the profile of one agency microsite, identified by micrositeShortName (the slug after /pro/ in the agency's profile address), within the countries given in location (es, pt, it; the documented default is es,pt,it). In the recorded probe (location=es, micrositeShortName=jaime-valcarce-consulting-inmobiliario) the endpoint answered HTTP 200 with a JSON object containing shortName, activeSinceYear, commercialName, agencyWebUrl, slogan, defaultTypology, defaultOperation, contactInfo (phone, a contactPhone object with formatted and dialing variants, showContactButton, proAgent and an address object with street, locality, postal code and coordinates), multimedias (mainImage and brandingLogo), an integer total, a languages array, commercialDataId, hasChatEnabled, micrositeLeadAllowed and corporatePhrase (text and autoTranslated). The profile does not include the agency's property listings.
Test this Idealista endpoint 2 required Β· 0 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query |
Request cost is temporarily unavailable. No price is assumed.
Location Lookup
/api/project/idealista/get-suggestions Autocomplete place names into Idealista location IDs
Full docs βDetails
Resolves the beginning of a place name to matching Idealista locations in Spain, Portugal or Italy. Send location (es, pt or it), operation (sale or rent), prefix (the text typed so far, for example madrid) and propertyType (homes, newDevelopments, bedrooms, offices, premises, garages, lands, storageRooms or buildings); all four are required. The response is a JSON object with a locations array and an integer total. In a live check with location=es, operation=sale, prefix=madrid and propertyType=homes, every locations entry carried name, locationId, divisible, type, suggestedLocationId, subTypeText and its own total, and the matches mixed municipalities, the Madrid province and individual districts. The per-entry total counts the properties offered for the chosen operation and property type, and the locationId values are the identifiers the listing endpoints take as their locationId input.
Test this Idealista endpoint 4 required Β· 0 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
Request cost is temporarily unavailable. No price is assumed.
Property Search
/api/project/idealista/list-buildings Search whole buildings on Idealista by area, price and size
Full docs βDetails
Returns a paged list of whole-building listings from Idealista for one location. Required inputs are locale, location (country site es, it or pt), locationId (for example 0-EU-ES-28-07-001-079 for the Madrid municipality), operation (sale or rent), order (one of twelve sort orders), maxItems and numPage. Optional inputs narrow the search with minPrice and maxPrice, minSize and maxSize, a sinceDate publication window (T, Y, W or M) and micrositeShortName to keep only one agency's buildings. No live sample or response example has been recorded for this endpoint yet, so its response fields are not listed here; inspect a response from your own request before mapping fields.
Test this Idealista endpoint 7 required Β· 6 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
Optional filters, sorting and publication window (1)
| Parameter | In | Value |
|---|---|---|
| query |
Request cost is temporarily unavailable. No price is assumed.
Commercial Property Search
/api/project/idealista/list-commercial-properties List Commercial Premises for Sale or Rent
Full docs βDetails
Returns one page of Idealista commercial premises listings for a single location. Required inputs: locationId (an Idealista location ID such as 0-EU-ES-28-07-001-079, resolved with the suggestions and sublocations endpoints), location (country site: es, it or pt), locale (language code: es, it, pt, en, ca, de, fr, nl or nb), operation (sale or rent), order (one of twelve sort orders from relevance to lowestfloors), maxItems (listed values 30, 40 and 0) and numPage (page number, 1 in the example). Optional inputs narrow the search by minPrice, maxPrice, minSize and maxSize; by publication window through sinceDate (T last 24h for rent only, Y last 48h for sale only, W last week, M last month); by agency through micrositeShortName; by premises type (premises, industrialBuilding, storehouse and three saleWarehouse flags); by business activity (for example pharmacy, catering, retail, barsAndNightclub, accommodation); and by placement (street, mezzanine, ontopfloor, underground, shoppingcenter, otherLocations). No live response sample or response schema is attached to this endpoint, so the listing fields are not verified here: inspect a live response before mapping fields. How several boolean flags combine is not documented, so test the combinations you rely on.
Test this Idealista endpoint 7 required Β· 32 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
Optional filters, sorting and publication window (25)
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
Request cost is temporarily unavailable. No price is assumed.
Home Listings Search
/api/project/idealista/list-home-properties List Homes for Sale or Rent with 50+ Filters
Full docs βDetails
Returns one page of Idealista home listings (Buy/Rent > Homes) for a single location. Required inputs: locationId (an Idealista location ID such as 0-EU-ES-28-07-001-079, resolved with the suggestions and sublocations endpoints), location (country site: es, pt or it), locale (language of the ads: es, it, pt, en, ca, de, fr, nl or nb), operation (sale or rent), order (one of twelve sort orders from relevance to lowestfloors), maxItems (page size, default 30, documented maximum 40, 0 returns only the count) and numPage (page number, 1 in the example). Optional inputs add minPrice and maxPrice bounds, minSize and maxSize bounds in m2, a publication window through sinceDate (T last 24h for rent only, Y last 48h for sale only, W last week, M last month), an agency filter through micrositeShortName, a furnished option for rentals, and 49 boolean flags covering property type, bedrooms, bathrooms, building features, sale conditions and rental terms. Boolean flags are only ever sent as true; omit a flag to leave it unfiltered. Observed in a live probe (sale search, locale es, location es, maxItems 5, numPage 1, order relevance, no filters): HTTP 200 with a JSON object holding elementList (the listing cards), total, totalPages, actualPage, itemsPerPage, numPaginations, summary, filter, alertName, totalAppliedFilters, searchTitle, geoReach, lowerRangePosition, upperRangePosition and paginable. Each probed listing card carried propertyCode, url, price, priceInfo, priceByArea, propertyType, operation, size, rooms, bathrooms, floor, exterior, address, province, municipality, district, neighborhood, locationId, latitude, longitude, numPhotos, thumbnail, multimedia (images, videos, virtual3DTours), contactInfo (agency name, user type, contact method, micrositeShortName), a features object and price-drop fields such as priceDropValue and priceDropPercentage. Rent searches, filtered searches, the maxItems=0 count mode and flag combinations were not exercised by that probe, so their behavior is taken from the parameter reference and is unverified here; no response schema is attached, so confirm field presence on a live response before mapping.
Test this Idealista endpoint 7 required Β· 56 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
Optional filters, sorting and publication window (47)
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
Request cost is temporarily unavailable. No price is assumed.
Property Listings
/api/project/idealista/list-lands List land plots for sale or rent on Idealista
Full docs βDetails
Returns a paginated list of land plots advertised on Idealista for sale or rent in one location. Required inputs are the country site (location: es, it or pt), the response language (locale), a locationId taken from the suggestions or sublocations endpoints, the operation (sale or rent), a sort order, the page number (numPage) and the page size (maxItems). Optional filters narrow the search by land type (urban, buildingLand for buildable plots, nonBuildingLand for non-buildable plots), minimum and maximum price, minimum and maximum plot size, a publication window (sinceDate: T last 24 hours for rent only, Y last 48 hours for sale only, W last week, M last month) and an agency microsite short name. No live response was captured for this endpoint, so its response fields are unverified; it is expected to follow the paginated listing envelope seen on the new-homes listing (an elementList array of properties plus total, totalPages and actualPage), which you should confirm with a first call.
Test this Idealista endpoint 7 required Β· 9 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
Optional filters, sorting and publication window (4)
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
Request cost is temporarily unavailable. No price is assumed.
/api/project/idealista/list-new-homes List new-build homes for sale or rent on Idealista
Full docs βDetails
Lists new-build home properties (Buy/Rent > New home) on Idealista for one location, with optional filters. Required inputs are the country site (location: es, it or pt), the response language (locale), a locationId from the suggestions or sublocations endpoints, the operation (sale or rent), a sort order, the page number (numPage) and the page size (maxItems, up to 40; 0 returns only the item count). Optional filters cover finished new builds, rent-to-own, state-subsidized housing, bank offers, flats, houses or chalets, bedroom counts (bedrooms0 to bedrooms4, where bedrooms4 means four or more) and minPrice/maxPrice. In an observed sample call (locale=es, location=es, locationId=0-EU-ES-28-07-001-079, operation=sale, order=relevance, maxItems=5) the response was a JSON object with elementList (array of listings), total, totalPages, actualPage, itemsPerPage, numPaginations, summary, filter, alertName, totalAppliedFilters, searchTitle, lowerRangePosition, upperRangePosition and paginable. Each observed listing carried fields such as propertyCode, price, priceInfo, propertyType, operation, address, municipality, district, locationId, latitude, longitude, url, description, numPhotos, multimedia, contactInfo, newDevelopmentFinished, isRentToOwn and promoName.
Test this Idealista endpoint 7 required Β· 13 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
Optional filters, sorting and publication window (7)
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
Request cost is temporarily unavailable. No price is assumed.
/api/project/idealista/list-offices List offices for sale or rent on Idealista
Full docs βDetails
Returns a paginated list of office properties advertised on Idealista under Buy/Rent > Offices for one location. Required inputs are the country site (location: es, it or pt), the response language (locale), a locationId taken from the suggestions or sublocations endpoints, the operation (sale or rent), a sort order, the page number (numPage) and the page size (maxItems, up to 40; 0 returns only the item count). Optional filters cover price and size bounds (minPrice, maxPrice, minSize, maxSize), a publication window (sinceDate: T last 24 hours for rent only, Y last 48 hours for sale only, W last week, M last month), an agency microsite short name, building type (exclusive for offices-only buildings or mixed for mixed use), layout (openPlan or withWalls), a bank-owned flag and boolean amenity flags for accessible, airConditioning, elevator, exterior, garage, hasPlan (floor plan), heating, hotWater and security. No live response was captured for this endpoint, so its response fields are unverified; it is expected to follow the paginated listing envelope seen on the new-homes listing of this API (an elementList array of properties plus total, totalPages and actualPage), which you should confirm with a first call.
Test this Idealista endpoint 7 required Β· 18 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
Optional filters, sorting and publication window (12)
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
Request cost is temporarily unavailable. No price is assumed.
/api/project/idealista/list-storage-rooms List storage rooms for sale or rent on Idealista
Full docs βDetails
Returns a paginated list of storage rooms (trasteros) advertised on Idealista for sale or rent in one location. Required inputs are the country site (location: es, it or pt), the response language (locale), a locationId taken from the suggestions or sublocations endpoints, the operation (sale or rent), a sort order, the page number (numPage) and the page size (maxItems). Optional filters are limited to minimum and maximum price, minimum and maximum size, a publication window (sinceDate: T last 24 hours for rent only, Y last 48 hours for sale only, W last week, M last month) and an agency microsite short name; there are no amenity flags. No live response was captured for this endpoint, so its response fields are unverified; it is expected to follow the paginated listing envelope seen on the new-homes listing of this API (an elementList array of properties plus total, totalPages and actualPage), which you should confirm with a first call.
Test this Idealista endpoint 7 required Β· 6 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query | ||
| query |
Optional filters, sorting and publication window (1)
| Parameter | In | Value |
|---|---|---|
| query |
Request cost is temporarily unavailable. No price is assumed.
New Development Units
/api/project/idealista/list-promotion-properties List the homes or garages of a new-build promotion on Idealista
Full docs βDetails
Lists the individual units of one new-build promotion (development) on Idealista, described by the source as brand new homes or garages. Four inputs are required and there are no pagination or filter parameters: the country site (location: es, pt or it), the response language (locale), parentPromotionId, which the source says to take from promotionProperties -> promotionId, and propertyType (homes or garages), which the source says to take from promotionProperties -> propertyType. The documented sample promotion ID is 104907187. No live response was captured for this endpoint, so its response fields are unverified. The new-homes listing sample of this API exposed a promoName field and a development flag but no dedicated promotion identifier, so confirm on a live response where the promotionProperties values appear before chaining calls.
Test this Idealista endpoint 4 required Β· 0 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query | ||
| query |
Request cost is temporarily unavailable. No price is assumed.
Property Details
/api/project/idealista/property-details Get Idealista property details by listing ID
Full docs βDetails
Returns the full record of a single Idealista property ad, identified by its numeric propertyId. Inputs: propertyId (required, the ad ID, echoed back as adid), location (required, the Idealista market: es for Spain, pt for Portugal, it for Italy) and language (required, the language of the ad text: en, es, it, pt, ca, de, fr, nl or nb). Fields observed in a live probe of one Spain sale listing (propertyId 112272495, language en, location es, HTTP 200): adid, price and priceInfo (amount, currencySuffix), operation, propertyType, extendedPropertyType, homeType, state, country, multimedia (images with url, tag, localizedName, width and height, plus videos, virtual3DTours and hasMultimediasMadeByIdealista), ubication (title, latitude, longitude, hasHiddenAddress, administrativeAreaLevel1 to 4, locationId, locationName), moreCharacteristics (roomNumber, bathNumber, constructedArea, floor, lift, garden, swimmingPool, exterior, energyPerformance and more), energyCertification, priceDropInfo, propertyComment and comments (with language and autoTranslated flags), translatedTexts, suggestedTexts, detailedType, labels, contactInfo (commercialName, userType, micrositeShortName, professional and related advertiser fields), detailWebLink, several allows* feature flags, tracking and modificationDate (an object with value and text). No published response example was supplied for this operation, so every field named here comes from that single probe; other listings, such as rentals, other countries or withdrawn ads, may omit or add fields. modificationDate reflects the last change to the ad, not its first publication date.
Test this Idealista endpoint 3 required Β· 0 optional
| Parameter | In | Value |
|---|---|---|
| query | ||
| query | ||
| query |
Request cost is temporarily unavailable. No price is assumed.
Location, listing and property detail capabilities
Search Idealista, the leading property portal for Spain, Portugal and Italy, through one JSON API. Resolve place names to location IDs, search homes for sale or rent with dozens of optional filters, and pull full listing details without running your own crawler.
- Location lookup: autocomplete place names into location IDs and drill down into districts and neighborhoods with listing totals
- Home search: sale and rent listings filtered by price, size, bedrooms, bathrooms, furnished, pets allowed, pool, terrace, elevator and more
- New builds and promotions: new-development searches plus the individual units of a single promotion
- Commercial and land: shops, offices, buildings, land plots and storage rooms with price and size filters
- Property details: photos, coordinates, price, contact type and modification date for one listing ID
- Agency microsites: an agency profile and the locations where it lists properties, plus agency-scoped listing searches
RESTful JSON API with page-based pagination, built for proptech apps, rental and yield analysis, competitor monitoring, site selection and new-listing alert bots.