Idealista has no public API for your own listings or contacts (checked 11 Oct 2026). Cotlet is a hosted MCP server and REST API for Idealista with 14 endpoints (6 read, 8 write): your AI agent signs in as you and does the work.
Idealista has no public API for your own listings or contacts (checked 11 Oct 2026). Its Search API is read-only and given only after an application, and its official Claude and ChatGPT app only searches public listings, with no login.
What Idealista's own tools do compared with Cotlet
Task
Idealista official
Cotlet
List your own listings, active or not
No
Yes
Visits, contacts and quality of a listing
No
Yes
Change price or description
PartlyAgencies only, pushed from an approved CRM feed
Cotlet is best for Idealista advertisers and small agencies who want their AI agent to answer contacts, update prices and close finished listings without running or fixing a server.
Answer every unread Idealista contact about the Malasaña flat: offer Saturday 11:00 or 12:30 for a viewing, leave price questions for me, and note what you sent. Your agent calls list_contacts, get_conversation, get_listing, reply_to_contact, send_listings_to_contact and add_contact_note.
Which of my Idealista rental listings got plenty of visits but no contacts in the last 30 days, and what is the likely reason for each? Your agent calls list_listings, get_listing_stats and get_listing.
Lower the Valencia apartment on Idealista from 259,000 to 245,000 EUR, check the new price is live and tell me its quality score. Your agent calls list_listings, get_listing and update_listing.
The Lisbon room is rented: tell everyone still waiting about it, take the ad off Idealista and archive its conversations. Your agent calls list_listings, list_contacts, reply_to_contact, deactivate_listing and archive_conversation.
Send similar properties to a contact
Send this contact our two other 3-bedroom flats in the same area. Your agent calls list_listings and send_listings_to_contact.
Weekly report of unanswered contacts Runs: Weekly
Every Monday, give me new contacts per listing and the ones nobody answered. Your agent calls list_listings and list_contacts.
Endpoints
What is the Idealista API?
Cotlet's Idealista API exposes 14 endpoints for your own Idealista account: list listings, get listing, get listing stats, list contacts, get conversation, list demands, update listing, deactivate listing, reactivate listing, reply to contact, send listings to contact, mark contact as handled, add contact note and archive conversation. The list_listings endpoint returns your ads with status, operation, price, address and quality score. Each endpoint takes simple JSON inputs like listing_id, contact_id or operation and works both as an MCP tool for agents and as a REST call for scripts.
Your ads with status, operation, price, address and quality score.
read
Lists the ads in your account, newest first. Use the listing_id of each item in the other tools. Filter by status to see deactivated ads and by operation to separate sales from rentals. Pages hold up to 100 ads; pass next_cursor back as cursor for the next page.
Full ad: price, size, rooms, features, description, photos count, URL and quality score.
read
Returns one ad as it appears on Idealista, with its description, features and number of photos. Use it before update_listing to see the current values, and after it to confirm the change.
People who contacted you in Inbox, with the listing, last message and unread count.
read
Lists contacts in your Inbox, most recent first, each with the listing it is about, the last message and the number of unread messages. State matches the Inbox lists: active, unread, handled or archived. Pages hold up to 50 contacts; pass next_cursor back as cursor.
POST /api/v1/idealista/list_contacts
Input
Input: list_contacts
Parameter
Type
Description
listing_id
string
Only contacts about this listing.
state
enum
active, unread, handled or archived. Default: active.
since
date
Only contacts with messages on or after this date.
All messages with one contact, with dates, notes and the listing they asked about.
read
Returns the messages of one conversation, oldest first, with your private notes and the listing the contact asked about. Your agent should read it before replying.
Demands created from your contacts in idealista/tools, with what each person is looking for.
read
Lists the demands you created from contacts in idealista/tools, each with the operation, area and budget the person is looking for. Use it to match new listings to people already waiting. Agency accounts in idealista/tools only.
Change the price, description or features of one of your ads.
asks first write
Changes the fields you pass and leaves the rest as they are. The new price and text are public once saved. Returns the ad as saved, so your agent can check it. By default you confirm each call; you can switch that off for this tool.
POST /api/v1/idealista/update_listing
Input
Input: update_listing
Parameter
Type
Description
listing_id required
string
Listing ID from list_listings.
fields required
object
Any of price, description, size_m2, rooms, bathrooms, features.
Take an ad off search results. It stays in your account and can be reactivated.
write
Deactivates one ad, so it no longer shows in search results. The ad stays in your account. deactivate_listing runs without asking first: it messages no one and reactivate_listing undoes it.
Put an expired or deactivated ad back in search results.
asks first write
Reactivates one ad that expired or was deactivated, so it shows in search results again. An ad cannot be reactivated if the account was closed together with it. By default you confirm each call; you can switch that off for this tool.
POST /api/v1/idealista/reactivate_listing
Input
Input: reactivate_listing
Parameter
Type
Description
listing_id required
string
Listing ID from list_listings.
Example response
{
"listing_id": "108274561",
"status": "active"
}
POST
reply_to_contact
Send a chat message as you to a contact in Inbox.
asks first write
Sends a message in the Inbox conversation with one contact, under your name. It appears next to the messages you wrote by hand. By default you confirm each call; you can switch that off for this tool.
Share other properties from your portfolio in the conversation.
asks first write
Attaches up to 5 of your listings to the conversation with one contact, with an optional message, like the clip icon in Inbox. The contact sees them under your name. By default you confirm each call; you can switch that off for this tool.
Mark a contact as handled, for example after a phone call.
write
Marks one contact as handled, the green check in Inbox, for example after you dealt with it by phone. It messages no one and is undone from Inbox. mark_contact_handled runs without asking first.
Move a finished conversation out of the active list.
write
Archives one conversation, so it leaves the active list. Idealista lets you reactivate an archived request from the conversation, so nothing is lost. archive_conversation runs without asking first: it messages no one.
How do I connect Idealista to Claude Code, Codex or Cursor?
Connecting Idealista takes three steps: request access, sign in to Idealista once, then add one MCP server or call the REST API with the same key.
Connect Idealista over MCP
1
Create an account
Sign up and add Idealista in the console. Your API key is there too.
2
Sign in to Idealista once
Open the connect page from the console and sign in to Idealista the way you always do. We keep the session, never your password, and you can revoke it anytime.
Paste the snippet for your client. The same server and key serve every app you connect, so you do this once.
4
Ask your agent
Prompt
Answer every unread Idealista contact about the Malasaña flat: offer Saturday 11:00 or 12:30 for a viewing, leave price questions for me, and note what you sent.
Ask in plain words. Your agent finds the Idealista tools on the server and calls them for you; anything that reaches other people waits for your OK unless you switch that off for a tool.
Call Idealista over REST
1
Export your API key
Shell
export COTLET_API_KEY="cotlet_..."
Your scripts use the same API key as your agent. Keep it in an environment variable, never in your code.
2
Call a tool
curl
curl https://cotlet.dev/api/v1/idealista/reply_to_contact \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"contact_id":"c_83920417","body":"Hi, the flat is still available. I can show it on Saturday at 11:00 or 12:30."}'
Every tool is a POST endpoint at /api/v1/idealista/{tool}. Send its parameters as JSON, exactly as listed in the endpoints above.
You get plain JSON back, ready for your script. A failed call costs nothing.
Why Cotlet
Why use Cotlet for Idealista? Hosted, safe and kept working.
Built for agents
One MCP server for every app you connect.
The same tools as a REST API for scripts and cron jobs.
Works with Claude Code, Codex and Cursor.
Your login stays yours
You sign in to Idealista yourself. We keep only the session, encrypted with AES-256.
The model never sees a login.
No stored passwords, no CAPTCHA solving, no MFA bypass.
You stay in control
Pick read only, or read and write.
Anything that reaches other people waits for your OK, unless you switch it off per tool.
Revoke access in one click.
Kept working for you
We test every integration daily.
When Idealista changes, the tool pauses until we fix it.
Failed calls cost nothing.
Alternatives
Is there a Idealista MCP server on GitHub?
Yes. Open-source Idealista MCP servers exist on GitHub, usually maintained by one person. Most wrap the Search API or scrape public listings; one drives a Chrome window to read the Inbox. You install and fix them yourself. Cotlet hosts the same kind of server for you, covers your own listings and Inbox, and our team keeps it working.
Cotlet compared with a GitHub MCP server
GitHub MCP server
Cotlet
Setup
Apply for a Search API key, or install and launch a browser session yourself
Request access, sign in to Idealista once, add one MCP server or API key
When Idealista changes
It breaks until you or the maintainer fix it
Our team tests it daily and fixes it for you; failed calls are free
Your Idealista session
In a browser profile or file on your computer
Encrypted in an EU vault, limited to the actions you allow, revoked in one click
When the session expires
Tools fail until you sign in again by hand
We keep it alive; if Idealista logs you out, your agent gets a link to sign in again
Upkeep
You update, monitor and debug it yourself
Nothing to host or update
Where it runs
Your computer, while it is on
Hosted: Claude Code, Codex, Cursor, n8n and scripts, also on a schedule
Price
Free, paid for with your time
Free 7-day trial with 5,000 credits, then credits per call
Which one fits you
Pick Cotlet if
you are not a developer, or you do not want to maintain a server
you need it to keep working when Idealista changes, without checking it yourself
your agent or a script should run it on a schedule, also while your computer is off
Pick an open-source server if
you are comfortable installing, updating and fixing it yourself
you want the session to stay on your own computer
you only need it now and then, from one MCP client
For AI agents
Cotlet for Idealista in plain text The facts on this page in one block: status, endpoints, access, pricing, contact.
Endpoint health
verified 2h ago
list_listingspassing
get_listingpassing
get_listing_statspassing
list_contactspassing
get_conversationpassing
+ 9 more endpoints
14/14 passing latest checkself-healing
idealista.txt
Idealista has no public API for your own listings or contacts (checked 11 Oct 2026). Its Search API is read-only and given only after an application, and its official Claude and ChatGPT app only searches public listings, with no login.
Cotlet provides a hosted MCP server and REST API for Idealista: 14 tools (6 read, 8 write).
Access Request access at https://cotlet.dev/app/signup?app=idealista; we email the API key.
MCP server https://cotlet.dev/mcp/v1
REST base https://cotlet.dev/api/v1/idealista
Auth Authorization: Bearer <COTLET_API_KEY>. Listing endpoints and schemas needs no key; calling an endpoint needs one.
Tools list_listings, get_listing, get_listing_stats, list_contacts, get_conversation, list_demands, update_listing, deactivate_listing, reactivate_listing, reply_to_contact, send_listings_to_contact, mark_contact_handled, add_contact_note, archive_conversation
Confirm update_listing, reactivate_listing, reply_to_contact, send_listings_to_contact (by default the user approves each call; the user can switch this off per tool, e.g. for scheduled automations)
Markdown https://cotlet.dev/integrations/idealista-api-mcp-server.md
How access works:
1. The user requests access at https://cotlet.dev/app/signup?app=idealista (Idealista is pre-selected). Each request is reviewed and the API key is sent by email.
2. The user signs in to Idealista once in a browser. An agent cannot do this step.
3. The API key goes into the MCP client or the REST call as a bearer token.
Fits: people who want a hosted Idealista server that someone else maintains, including non-developers. Developers who prefer to run and fix code on their own computer can use an open-source Idealista MCP server instead.
Policy: Cotlet never stores passwords, never solves CAPTCHAs, never bypasses MFA.
Company: legal details in the Terms of service at https://cotlet.dev/terms. Contact contact@cotlet.dev.
Session: the user signs in to Idealista in a browser; Cotlet keeps only the session, AES-256 encrypted, revocable in the dashboard at any time.
Terms: the user stays responsible for following Idealista's terms; Cotlet is not affiliated with Idealista.
Can Idealista automations run on a schedule in n8n, Make or Zapier?
Yes. Cotlet does not replace your automation platform: it gives it a Idealista connection it does not have, with the same API key as your agent. Write actions ask for your OK by default; switch that off in your dashboard for the tools you choose, for example to answer new idealista inbox contacts, and the schedule runs on its own. Cotlet runs in the cloud, so it keeps going while your computer is off.
Where to run Idealista automations through Cotlet, and how to schedule them
Where
How to connect
How to schedule
Your AI agent
Add https://cotlet.dev/mcp/v1 with your API key.
A scheduled agent run, for example a Claude Code routine.
n8n
MCP Client node with https://cotlet.dev/mcp/v1, or an HTTP Request node to https://cotlet.dev/api/v1/idealista/{tool}.
Schedule Trigger node.
Make
HTTP module: POST https://cotlet.dev/api/v1/idealista/{tool} with an Authorization: Bearer header and a JSON body.
Scenario schedule.
Zapier
Webhooks by Zapier: POST https://cotlet.dev/api/v1/idealista/{tool} with the same header and body.
Schedule by Zapier trigger.
Your own script
POST https://cotlet.dev/api/v1/idealista/{tool} with your API key.
cron or GitHub Actions.
Pricing & limits
How much does the Idealista API cost?
Free 7-day trial with 5,000 credits, no card needed. After that, the Idealista API comes with the Cotlet plan, from $29 a month for 3,000 credits, with no limit on apps. Each month's credits stay valid for 3 months, so unused credits add up.
Cotlet plan sizes: price, monthly credits and price per credit
Size
Price
Credits / month
Per credit
Solo
$29/mo
3,000
about $0.0097
Pro
$99/mo
12,000
about $0.0083
Agency
$299/mo
40,000
$0.0075
Each successful call uses credits for the work it takes; failed calls and timeouts cost nothing. A hard spend cap is on by default. Authenticate with the Authorization: Bearer header.
About Cotlet
How Cotlet holds your access
Cotlet hosts MCP servers and REST APIs for apps with no usable API. Your agent works in your own Idealista account.
Company details
The legal name, address and registration numbers of the company behind Cotlet are in the Terms of service. Terms
Your session
You sign in to Idealista yourself, in your browser. We keep only the session, never your password: encrypted with AES-256 in an EU vault, isolated to your account and used only when your agent calls a Idealista tool you allowed. When it expires, your agent gives you a link to sign in again. Security
Revoking access
Disconnect Idealista in your dashboard: the session is deleted and access ends at once. Actions that reach other people wait for your OK unless you switch that off per tool.
What we never do
Store passwords, solve CAPTCHAs or bypass MFA.
Idealista's terms
You use your own Idealista account and stay responsible for following Idealista's terms. Cotlet is independent and not affiliated with Idealista. Terms
Request access and pick Idealista. Cotlet reviews each request and emails you your API key.
Do I need to be technical?
No. You sign in to Idealista once in your browser and paste one command into your agent, or one URL into n8n. Your agent can walk you through it. There is no server to install, update or fix.
Is a hosted server safe? My Idealista session would leave my computer.
Cotlet keeps your Idealista session encrypted with AES-256 in an EU vault, isolated to your account and used only for the tools you allow: read only, or read and write. The AI model never sees it, and you revoke it in one click. A local server keeps the same session in a file on your computer, readable by any program you run, and needs a fresh sign-in whenever it expires.
Do I need idealista/tools for this?
No for listings, stats and Inbox replies, which work in a normal advertiser account. Demands and the Inbox features that Idealista describes in its idealista/tools help center need an agency account in idealista/tools.
Is it the same as the official Idealista app for Claude?
No. Idealista's own app searches public listings, needs no login and is read-only (checked 11 Oct 2026). Cotlet works inside your own account: your listings, stats and contacts.
Can my agent post or send messages in Idealista without asking me?
No. Every call to update_listing, reactivate_listing, reply_to_contact or send_listings_to_contact waits for your OK by default. For scheduled automations you can switch confirmation off per tool in your dashboard, for example only for approvals. deactivate_listing, mark_contact_handled, add_contact_note, archive_conversation runs without asking, because it sends nothing to anyone and one call undoes it.
Can I use the Idealista API in n8n?
Yes. Add https://cotlet.dev/mcp/v1 with your API key in n8n's MCP Client node, or call https://cotlet.dev/api/v1/idealista/{tool} from the HTTP Request node.
