Immobiliare.it API and MCP server

• POST

  list_listings

  Your Published listings with contract, price, address, visibility and number of views.

  read

  Returns the listings in your Published listings, with the number of views the portal shows for each. Filter by sale or rent. Pass next_cursor back as cursor for the next page. Use listing_id from each item in the other tools.

  POST /api/v1/immobiliare/list_listings

  Input

  Input: list_listings

  Parameter	Type	Description
  contract	enum	sale, rent or all. Default: all.
  limit	integer	1 to 100. Default: 50.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "listings": [
      {
        "listing_id": "118734552",
        "title": "Two-room flat, Bologna",
        "contract": "sale",
        "price": 239000,
        "address": "Via Example 5, Bologna",
        "visibility": "BASE",
        "views": 412,
        "url": "https://www.immobiliare.it/annunci/118734552/"
      },
      {
        "listing_id": "118790021",
        "title": "Studio, Milano",
        "contract": "rent",
        "price": 950,
        "address": "Via Example 10, Milano",
        "visibility": "BASE",
        "views": 96,
        "url": "https://www.immobiliare.it/annunci/118790021/"
      }
    ],
    "next_cursor": null
  }

• POST

  get_listing

  Full listing: category, type, contract, address, characteristics, price, description, photos, floor plans and URL.

  read

  Returns one listing as the portal shows it. Works for your own listings and for any public listing, so your agent can read a flat before it asks for a visit.

  POST /api/v1/immobiliare/get_listing

  Input

  Input: get_listing

  Parameter	Type	Description
  listing_id required	string	Your listing ID from list_listings, or any public listing ID.

  Example response

  {
    "listing_id": "118734552",
    "category": "residential",
    "property_type": "apartment",
    "contract": "sale",
    "price": 239000,
    "address": "Via Example 5, Bologna",
    "characteristics": {
      "surface_m2": 68,
      "rooms": 2,
      "bathrooms": 1,
      "floor": 2
    },
    "description": "Bright two-room flat near the centre.",
    "photo_count": 12,
    "url": "https://www.immobiliare.it/annunci/118734552/"
  }

• POST

  list_conversations

  Conversations in Messages, with the listing, the other person, the last message and any visit request.

  read

  Lists conversations in Messages, most recent first. Filter by listing_id to see only the people who wrote about one listing. Each item flags whether it has a visit request. Pass next_cursor back as cursor for the next page.

  POST /api/v1/immobiliare/list_conversations

  Input

  Input: list_conversations

  Parameter	Type	Description
  listing_id	string	Only conversations about this listing.
  limit	integer	1 to 100. Default: 50.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "conversations": [
      {
        "conversation_id": "c_58210934",
        "listing_id": "118734552",
        "with": "Marco R.",
        "last_message": "Is the flat still available?",
        "last_message_at": "2026-10-10T15:10:00+02:00",
        "has_visit_request": true
      }
    ],
    "next_cursor": null
  }

• POST

  get_conversation

  Every message in a conversation, plus the visit request details: in person or remote, days and time slots.

  read

  Returns all messages of one conversation, oldest first, so your agent reads the thread in order. If the person asked for a visit, the request shows the mode, the days and the time slots they offered.

  POST /api/v1/immobiliare/get_conversation

  Input

  Input: get_conversation

  Parameter	Type	Description
  conversation_id required	string	Conversation ID from list_conversations.

  Example response

  {
    "conversation_id": "c_58210934",
    "listing_id": "118734552",
    "messages": [
      {
        "message_id": "m_903114100",
        "from": "them",
        "body": "Is the flat still available?",
        "sent_at": "2026-10-10T15:10:00+02:00"
      }
    ],
    "visit_request": {
      "mode": "in_person",
      "days": [
        "2026-10-17"
      ],
      "time_slots": [
        "10:00-12:00"
      ]
    }
  }

• POST

  list_saved_listings

  Listings you saved with the heart icon, your notes on them, and whether they were removed.

  read

  Returns your saved listings with the note you wrote on each and a removed flag for listings that left the portal. Use ad_id from each item with get_listing, contact_advertiser and request_visit.

  POST /api/v1/immobiliare/list_saved_listings

  Input

  Input: list_saved_listings

  Parameter	Type	Description
  limit	integer	1 to 100. Default: 50.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "saved": [
      {
        "ad_id": "117220481",
        "title": "Three-room flat, Torino",
        "price": 285000,
        "note": "Check the heating",
        "removed": false
      },
      {
        "ad_id": "116004417",
        "title": "Two-room flat, Torino",
        "price": 199000,
        "note": "",
        "removed": true
      }
    ],
    "next_cursor": null
  }

• POST

  save_search

  Save a search by name to get an email or notification for every new matching listing.

  write

  Saves the filters of an Immobiliare.it results URL under a name, as the save search option does. The portal then alerts you to new matching listings. It reaches no one, and the saved search can be removed in your personal area, so it runs without asking.

  POST /api/v1/immobiliare/save_search

  Input

  Input: save_search

  Parameter	Type	Description
  name required	string	Name of the saved search.
  search_url required	string	Immobiliare.it results URL with your filters set.

  Example response

  {
    "name": "Torino under 300k",
    "status": "saved"
  }

• POST

  create_listing

  Post a new listing with free BASE visibility. It goes live after the editorial review, up to 48 hours.

  asks first write

  Creates a listing from the details you give and returns its ID with status in_review. The portal reviews it before it goes live, which can take up to 48 hours. Photos and floor plans are uploaded from the URLs you pass. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/immobiliare/create_listing

  Input

  Input: create_listing

  Parameter	Type	Description
  category required	string	Property category, e.g. residential or commercial.
  property_type required	string	Type within the category, e.g. apartment, villa, office.
  contract required	enum	sale or rent.
  address required	string	Street address and town of the property.
  characteristics required	object	Surface, rooms, bathrooms, floor and other features.
  price required	integer	Price in EUR; monthly rent for rentals.
  description required	string	Listing text.
  photo_urls	string[]	Photos to upload, by URL.
  floor_plan_urls	string[]	Floor plans to upload, by URL.

  Example response

  {
    "listing_id": "118790021",
    "status": "in_review",
    "visibility": "BASE",
    "url": "https://www.immobiliare.it/annunci/118790021/"
  }

• POST

  update_listing

  Change fields of one of your listings, as with Edit this listing.

  write

  Changes only the fields you pass and returns the updated values. The listing keeps its ID and URL. It reaches no one directly and the old value goes back with one more call, so it runs without asking.

  POST /api/v1/immobiliare/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, characteristics, photo_urls, floor_plan_urls.

  Example response

  {
    "listing_id": "118734552",
    "updated": [
      "price",
      "description"
    ],
    "price": 239000,
    "status": "online"
  }

• POST

  delete_listing

  Remove one of your listings from the portal for good.

  asks first write

  Deletes the listing from the portal. It cannot be undone with another call; you would publish it again. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/immobiliare/delete_listing

  Input

  Input: delete_listing

  Parameter	Type	Description
  listing_id required	string	Listing ID from list_listings.

  Example response

  {
    "listing_id": "118790021",
    "status": "deleted"
  }

• POST

  reply_to_conversation

  Send a reply as you in a Messages conversation.

  asks first write

  Sends a message in an existing conversation under your name and returns its ID and time. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/immobiliare/reply_to_conversation

  Input

  Input: reply_to_conversation

  Parameter	Type	Description
  conversation_id required	string	Conversation ID from list_conversations.
  body required	string	Reply text.

  Example response

  {
    "conversation_id": "c_58210934",
    "listing_id": "118734552",
    "message_id": "m_903114208",
    "sent_at": "2026-10-10T16:42:00+02:00",
    "status": "sent"
  }

• POST

  contact_advertiser

  Send a first message to whoever posted a listing; the conversation then lives in Messages.

  asks first write

  Writes to the advertiser of one public listing, as the contact form does. The conversation then appears in list_conversations. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/immobiliare/contact_advertiser

  Input

  Input: contact_advertiser

  Parameter	Type	Description
  ad_id required	string	ID of any public listing on immobiliare.it, from its URL (/annunci/{id}/).
  body required	string	Message text.
  phone	string	Phone number to be contacted at. Optional.

  Example response

  {
    "conversation_id": "c_58301177",
    "ad_id": "117220481",
    "status": "sent",
    "sent_at": "2026-10-10T17:05:00+02:00"
  }

• POST

  request_visit

  Ask the advertiser for a viewing. Not a booking: they contact you to confirm.

  asks first write

  Sends a visit request with the mode, the days and the time slots you are free. It is a request, not a booking: the advertiser contacts you to confirm. Time slots are those the form offers. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/immobiliare/request_visit

  Input

  Input: request_visit

  Parameter	Type	Description
  ad_id required	string	ID of any public listing on immobiliare.it, from its URL (/annunci/{id}/).
  mode required	enum	in_person or remote (video call with the agent).
  days required	string[]	Days you are available, as YYYY-MM-DD.
  time_slots required	string[]	Time slots you are available, as offered on the form.

  Example response

  {
    "ad_id": "118734552",
    "mode": "remote",
    "days": [
      "2026-10-19",
      "2026-10-20"
    ],
    "time_slots": [
      "18:00-19:00"
    ],
    "status": "requested"
  }

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.