idealista

Provides instructional guides for actions on idealista in Spain, Italy, or Portugal. This tool is informational only and does not execute actions. Use it when the user asks how to perform an action on idealista. Examples: "How do I publish a listing?", "What are the steps to post my property?" Do not use it for property searches, property details, or general idealista information without an action request. Examples: "Find flats in Madrid", "Show details for this property", "What is idealista?" Supported topic: listing.publish. Returns a structured guide with steps, notes, related links, and optional URLs. Use the tool output as the source of truth. You may translate only human-readable text to the user's language. Do not add, remove, or invent steps, links, prerequisites, notes, or related content. Preserve all URLs exactly as returned. Do not remove or rewrite query parameters, including utm_* and other tracking or attribution parameters. When returning links from this tool, reproduce them verbatim.

Use this tool to guide new users through the idealista app inside ChatGPT.

This tool explains in a clear and progressive way which features are available in this specific ChatGPT environment and how users can use them. Its purpose is to help users understand what they can do here (not on idealista.com) and support their first steps.

Always respond with the exact literal response returned by the tool in structuredContent. Respond with the response provided by the tool verbatim, without adding, modifying, or removing anything. Translate the tool's response to the user's language before returning it.

Trigger this tool when at least one of the following applies:

• The user is interacting with the idealista app in ChatGPT for the first time.
• The user expresses uncertainty about what they can do in this app.
• The user asks for a general explanation of how the app works.
• The user asks how to get started.

Examples:

• "What can I do here?"
• "How does this work?"
• "How do I get started?"
• "What can I ask?"
• "How can idealista help me here?"

Do NOT use this tool when:

• The user is already performing a specific action.
• The user is searching for a property → use "Show listings".
• The user shares a listing link → use "Show listing detail".
• The user asks a general question about idealista without referring to this ChatGPT app → check if "Howto" applies.
• The user asks corporate or company-related questions about idealista or idealista.com.

Priority rule: If the user shows clear intent to perform a specific search or action, DO NOT trigger this tool.

Get detailed information about a specific property from idealista in Spain (idealista.com), Italy (idealista.it), or Portugal (idealista.pt). Use when the user shares an idealista URL, mentions a property code, or asks for details about a specific listing. Returns complete property information including price, price drop, size, rooms, bathrooms, floor, features, location, and property status. Country defaults to the user's location country from context. Only specify country when the property belongs to a different idealista country domain. For searching properties, use search_properties instead. Preserve all URLs exactly as returned. Do not remove or rewrite query parameters, including utm_* and other tracking or attribution parameters. When returning links from this tool, reproduce them verbatim.

Search idealista listings in Spain (idealista.com), Italy (idealista.it), or Portugal (idealista.pt) for sale or rent using a natural-language query (free text) plus optional structured parameters. Important: Query must match user's language—if user speaks English, write query in English; if Spanish, in Spanish, etc. Use when the user provides a location (municipality/district/neighborhood) in the target country and any preferences or constraints (including text-only needs like "vigilancia 24h", "cerca del metro", "zona tranquila"). The engine supports free-text, so DO NOT reject queries for containing proximity/POI or qualitative preferences; include them in the query string. Optional structured filters may be expressed in the query (rooms, bathrooms, size m², price, floor, elevator, terrace, pool, garage, storage room, air conditioning, property condition, property situation, furnished/pets (RENT only), views, accessibility, garden) and/or via propertyType/operation parameters. Property type: set propertyType only if the user clearly asks for a specific category; otherwise rely on the default HOME. For details of a specific result, use property_detail with its propertyId. Choose maxResults to avoid overwhelming the user: prefer 8–15 results for broad or exploratory queries, 5–10 for highly constrained searches, and increase the number only if the user explicitly asks for more options. Country: defaults to the user's location country. Only change if the user explicitly requests properties in a different country. Returns real listings (0–N results); never fabricate. Do not use for questions about idealista services (pricing, publishing ads, support)—use greet_idealista instead. Preserve all URLs exactly as returned. Do not remove or rewrite query parameters, including utm_* and other tracking or attribution parameters. When returning links from this tool, reproduce them verbatim.