Idealista: publishing on the largest portal in Spain

Idealista is the largest real estate portal in Spain, with millions of buyers and renters searching there every day. For almost any agency serving the Spanish market, it is the most important channel. Tesoro connects directly to Idealista: as soon as you save a property, it is automatically forwarded.

Who is this for?

• Agencies serving the domestic Spanish market (sales, rentals, new construction)
• Real estate agents in Spain, Portugal, or Italy, the countries where Idealista is strongest
• Anyone who wants maximum reach among Spanish buyers

How do you request access?

An agency cannot register as a professional through the regular website registration. You contact the professional department of Idealista; they set up your professional account.

1. Go to the professional page of Idealista: idealista.com/nuevo-profesional. There you will find information for real estate agencies and the contact form.

2. Contact the professional department through that page. You need a legally registered company with CIF/NIF and tax details, and you sign up for a paid subscription.

3. Request your customer code. Once you are a professional client, Idealista gives you a unique customer code plus a contact ID. With this, your CRM can automatically submit properties.

Costs

Idealista does not publish a fixed price list. It is a paid subscription; the price depends on your package. Ask the professional department of Idealista for details.

How to connect Idealista in Tesoro

Idealista is a direct API connection: not a feed URL that is periodically read, but a direct push with every change.

Admin role required

Portal configuration is under Settings. You need admin access and an active Tesoro subscription.

1. First configure your website domain via Settings → Website. Idealista needs this.

2. Go to Settings → Feed Export and find the Idealista card (recognizable by the API badge).

3. Click the edit icon and enter your Idealista Customer Code. Click Save.

4. Turn on the toggle. If the customer code is missing, Tesoro will display: “Please add idealista customer code.”

From that moment on, every saved change to an assigned property, details, photos, videos, and descriptions, is directly pushed to Idealista.

Error logging

If a push to Idealista fails, Tesoro logs the error on the property record and automatically removes the MLS assignment. This ensures a property never appears published when it is not.

Unlinking a property from Idealista (Revert from Idealista)

Idealista records three details on the first publication: Property Type, Transaction, and Tesoro Reference Number. If you change them later in Tesoro, Idealista ignores the change. That is why Tesoro shows the message “Before you publish to Idealista” before the first publication, listing these three details.

If, after publication, one of these details turns out to be wrong? For example, a penthouse as an apartment, or a rental property as a property for sale? Then you use Revert from Idealista. This takes the property off Idealista, after which you publish it again as a new listing, with the correct details.

Admins only, cannot be undone

Only users with the admin role see this button. You cannot undo a revert.

1. Open the property and go to the Connections & attachments tab.

2. Find the Posted To card. In the Idealista row there is a red icon with a back arrow (tooltip: Revert from Idealista). You only see the icon if the property has an Idealista listing number. The same icon also appears in the property overview on the property’s edit page.

3. Click the icon. Tesoro shows what is going to happen:

   • Deactivates the listing on Idealista: the listing goes offline on Idealista
   • Unlinks Idealista listing #…: the link to the listing number is removed
   • Assigns a new Tesoro reference number: the property gets a new Tesoro reference number
   • You’ll need to publish it again to relist: you must then publish the property again

4. Click Revert. Tesoro runs the operation in the background. The icon spins while it is working.

5. Correct the details (for example the property type) and publish again via Add MLS → Idealista. Idealista then treats the property as a new listing.

Only after confirmation from Idealista

Tesoro only unlinks the property and issues a new reference number after Idealista has confirmed that the listing is offline. If that fails, the property stays as it was and you see the error message on the property. If Idealista is temporarily busy, Tesoro automatically retries later.

Property requirements

• Customer code and contact ID filled in at company level
• A property type with an Idealista equivalent
• Transaction type and price (between 1 and 999,999,999)
• Complete address
• Reference (max 50 characters)
• Description (max 4,000 characters) in a supported language
• At least one photo with a valid URL
• Website domain configured

Next step

Connect and configure all portalsThe complete overview: enabling per portal, login details, and requirements.