Skip to content
ListingrailGet an API key

Idealista listings API

Spain, Italy and Portugal, sale and rent. One credit per listing returned, in the same JSON format as the other seven portals.

Idealista, a real row2026-10-15
PortalLocationTypePriceRemarks
IdealistaMadridSale€990,000Reduced 17%

POST this body to /v1/listings/search with your key. idealista takes Place name ('madrid', 'roma, it', 'lisboa, pt') or an Idealista search link (for price filters).

{
  "source": "idealista",
  "location": "madrid",
  "type": "rent",
  "limit": 50
}

Fields Idealista fills

  • id
  • url
  • title
  • address
  • city
  • region
  • country
  • lat
  • lng
  • price
  • currency
  • beds
  • baths
  • area
  • property_type
  • photos
  • agent.name
  • agent.phone
  • agent.company

Not given by Idealista to a visitor, so returned as null: postal_code, price_period, listed_at.

Get 100 free listingsRead the docsOther portals