idealista

Provides step-by-step instructions on how to perform specific actions on idealista in Spain (idealista.com), Italy (idealista.it), or Portugal (idealista.pt). WHEN TO USE: User asks questions like "how do I...?", "how can I...?", "what steps to...?", "how to publish/edit/delete a listing?", or any question about performing an action on idealista. This tool does NOT execute actions - it only provides instructional guides. SUPPORTED TOPICS: listing.publish (how to publish a property listing on idealista). TOPIC FORMAT: domain.action (e.g., listing.publish, listing.edit). NOT SUPPORTED (do NOT use this tool): Actual execution of actions (this is information-only); questions about property details or searches (use other tools); general idealista information without action context (use greet_idealista instead). RETURNS: Structured guide with title, description, ordered steps, prerequisites, notes, and related links. Each step includes order, title, description, and optional URL for reference.

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. Input: Property code (numeric ID from URL, e.g., https://www.idealista.com/inmueble/110293306/ → 110293306, https://www.idealista.it/immobile/123456/ → 123456). Output: Complete property information including price, price drop, size, rooms, bathrooms, floor, features (air conditioning, terrace, pool, parking, etc.), location, and property status. COUNTRY: defaults to user's location. Only specify if the property is from a different country domain. For searching properties, use property_search instead.

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.