Documentation
idealista for ChatGPT
1. About
idealista provides an official app for ChatGPT that lets you search real estate listings and get information from idealista directly inside your conversation. It is only available through the official idealista app, and it does not support manual configuration from other MCP clients.
2. Availability and languages
- Countries: Spain, Italy, Portugal, and France (beta).
- Languages: Spanish, English, Italian, Portuguese, and French.
The language of your conversation can be different from the country where you are searching for properties.
3. How to use idealista in ChatGPT
- Open the Plugins Directory, find idealista, and select Connect.
- Write your request using natural language.
Once connected, invoke idealista with @idealista or select it from the
tools menu. ChatGPT will choose the appropriate idealista tool for your
request — you don’t need to know its tool names or provide any technical
parameters.
For general instructions on connecting plugins in ChatGPT, see Plugins in ChatGPT and Codex.
4. What you can do
The idealista app helps you find a property on idealista, such as a home, an office or a garage, as part of your own property search.
- Search for properties on idealista, starting from a specific location (a city, district or neighborhood) and your preferences. You can refine your search, start a new one with different preferences, or compare a few areas of your choice. Results are shown as a browsable carousel, which you can expand into a map view to see listings by location.
- The results carousel and map view work on mobile and desktop, and support both light and dark mode.
- Ask idealista to sort results — for example, “the cheapest first” or “the most recent first” — using the same sorting options already available on idealista’s website. If you don’t ask for a specific order, results are sorted by relevance. You can also ask to sort or tabulate the listings already shown, for example in a table.
- Search results and listing details always reflect the information currently published on idealista.
- Get information about a specific listing directly, by giving its idealista URL or listing ID — no search needed. You can also ask about one of the properties from your search results or from the map view, or compare a few listings.
- Get help with tasks on idealista’s website, based on its help content — currently, how to publish a listing. The app can explain how to publish a listing, but it cannot publish one on your behalf.
- Learn about the app’s capabilities and how to get started.
Not what this app is for
The app is designed for your own property search, not for reports, exports, automations, statistics, market analysis or collecting listings in bulk. Requests like these may not be answered, or may return incomplete or unreliable results. To explore beyond your own search, continue on idealista (for searches, from the link included in the results).
5. Available tools
| Tool | Purpose |
|---|---|
search_properties |
Searches for properties on idealista. |
property_detail |
Retrieves information about a specific idealista listing. |
get_howto |
Explains how to complete tasks on idealista’s website, based on its help content (currently: how to publish a listing). |
guide_idealista_chatgpt |
Explains what the idealista app can do in ChatGPT and how to get started. |
6. How search results are displayed
You can search in any of the available languages, regardless of the country: the country is determined by the location you mention, not by the language of your prompt. Results always follow the same flow — inline carousel, map view, listing detail — illustrated below with prompts in different languages.
Inline carousel. Search results first appear as a carousel with price, size, rooms, and features for each result, plus a link to see the full search on idealista. For example, in Spanish:
“@idealista busca viviendas en alquiler en Malasaña-Universidad, Madrid.”

Map and list view. Selecting “view on map” expands the carousel into a split view, with the list on one side and the locations on a map on the other. For example, in Portuguese:
“@idealista procura garagens para arrendar em Lisboa.”

Listing detail. Selecting a listing — or asking about one of the results — opens its detail with price, size, rooms, features, images, location, and status, without starting a new search. For example, in Italian:
“@idealista mostrami i dettagli della camera in viale Giovanni Milton tra i risultati.”

7. Example prompts
Example 1 - Search and refine results
User prompt:
“@idealista I’m looking for a 2-bedroom apartment to rent in Rome for less than 2,000 euros a month.”
How ChatGPT responds:
- ChatGPT searches idealista for matching rental apartments in Rome.
- Returns an inline carousel with price, size, rooms, and features for each result, which you can expand into a map view.
- Includes a link to see the full search on idealista.
You can ask follow-up questions such as:
“Show me the cheapest ones first.” “Show only the ones with a garden.” “Tell me more about the second one.”
If you ask for a specific order — for example, “the cheapest first” or “the most recent first” — idealista sorts results using the same options already available on its website. Without a sorting request, results are sorted by relevance.
Expected behavior
You receive matching rental listings that you can browse as a carousel or on a map, and refine further — including by sorting — with follow-up questions.
Example 2 - Get details about a specific listing
User prompt:
“@idealista summarize the strengths and weaknesses of this listing: https://www.idealista.com/inmueble/12345678/”
How ChatGPT responds:
- ChatGPT retrieves the current details of that listing from idealista — price, size, rooms, features, images, location, and status.
- Summarizes its strengths and weaknesses based on that information, without starting a new search.
Expected behavior
You receive a summary based on the listing’s real, current information.
Example 3 - Get help with a task on idealista’s website
User prompt:
“@idealista how do I publish a listing?”
How ChatGPT responds:
- ChatGPT returns a step-by-step guide based on idealista’s help content, including prerequisites and related links.
Expected behavior
You get an explanation of how to publish a listing; idealista does not publish anything on your behalf.
Example 4 - Learn what idealista can do
User prompt:
“@idealista what can you help me with?”
How ChatGPT responds:
- ChatGPT explains the idealista app’s capabilities and how to get started.
Expected behavior
You receive an overview of what you can do, without idealista taking any action.
Example 5 - Location is missing or too vague
User prompt:
“@idealista je cherche un logement à 5 minutes de chez moi.”
How ChatGPT responds:
- idealista asks you to specify a concrete location — a city, neighborhood, or address — since it can’t search based on your current location.
Expected behavior
ChatGPT asks a clarifying question instead of returning results.
8. Permissions and limitations
- All tools are read-only.
- No login or idealista account linking is required.
- The app does not publish, edit, or delete listings.
- The app does not manage favorites, alerts, or messages.
- The app does not perform any transactions.