Hemnet API and MCP server

• POST

  search_listings

  Homes for sale and coming to market (kommande), with price, fee, rooms and area.

  read

  Returns homes for sale in an area that match your filters, and homes coming to market unless include_upcoming is false. Each item has the asking price, monthly fee, rooms and living area. Pages hold up to 50 homes; pass next_cursor back as cursor for the next page. Use listing_id with get_listing or save_home.

  POST /api/v1/hemnet/search_listings

  Input

  Input: search_listings

  Parameter	Type	Description
  location required	string	Area, municipality or street, e.g. "Vasastan, Stockholm".
  housing_types	string[]	Any of apartment, villa, townhouse, holiday_home, plot, farm. Default: all.
  price_min	integer	Minimum asking price in SEK.
  price_max	integer	Maximum asking price in SEK.
  rooms_min	integer	Minimum number of rooms.
  living_area_min	integer	Minimum living area in m².
  include_upcoming	boolean	Include homes coming to market. Default: true.
  cursor	string	Next page cursor from the previous call.

  Example response

  {
    "listings": [
      {
        "listing_id": "l_21730488",
        "address": "Karlbergsvägen 120, Vasastan, Stockholm",
        "type": "apartment",
        "rooms": 3,
        "living_area_m2": 68,
        "asking_price_sek": 5450000,
        "monthly_fee_sek": 4120,
        "status": "for_sale"
      }
    ],
    "next_cursor": null
  }

• POST

  get_listing

  Full listing: price, monthly fee, area, rooms, viewing times, bidding status and broker.

  read

  Returns one listing as the listing page shows it: asking price, monthly fee, rooms, living area, the broker, viewing times and whether bidding has started. Use it after search_listings to read a home in full.

  POST /api/v1/hemnet/get_listing

  Input

  Input: get_listing

  Parameter	Type	Description
  listing_id required	string	Listing ID from search_listings or list_saved_homes.

  Example response

  {
    "listing_id": "l_21730488",
    "address": "Karlbergsvägen 120, Vasastan, Stockholm",
    "type": "apartment",
    "rooms": 3,
    "living_area_m2": 68,
    "asking_price_sek": 5450000,
    "monthly_fee_sek": 4120,
    "bidding_started": false,
    "viewings": [
      "2026-10-17T12:00:00+02:00"
    ],
    "broker": "Exempel Mäkleri, Vasastan",
    "url": "https://www.hemnet.se/bostad/l_21730488"
  }

• POST

  search_sold_prices

  Sold homes (slutpriser) with final price, asking price and sale date.

  read

  Returns homes sold in an area, with final price, asking price, how far the sale landed above or below asking, and the sale date. Narrow it with sold_since, housing type and rooms. Pages hold up to 100 homes.

  POST /api/v1/hemnet/search_sold_prices

  Input

  Input: search_sold_prices

  Parameter	Type	Description
  location required	string	Area, municipality or street, e.g. "Vasastan, Stockholm".
  housing_types	string[]	Any of apartment, villa, townhouse, holiday_home, plot, farm.
  sold_since	date	Only homes sold on or after this date.
  rooms_min	integer	Minimum number of rooms.
  limit	integer	1 to 100. Default: 50.

  Example response

  {
    "sold": [
      {
        "address": "Odengatan 40, Vasastan, Stockholm",
        "rooms": 3,
        "living_area_m2": 71,
        "asking_price_sek": 4250000,
        "final_price_sek": 4500000,
        "over_asking_pct": 5.9,
        "sold_on": "2026-09-12"
      },
      {
        "address": "Sveavägen 98, Vasastan, Stockholm",
        "rooms": 3,
        "living_area_m2": 74,
        "asking_price_sek": 5200000,
        "final_price_sek": 5150000,
        "over_asking_pct": -1,
        "sold_on": "2026-06-03"
      }
    ]
  }

• POST

  list_saved_homes

  Homes you saved, with collection, status (for sale, bidding, sold) and final price when sold.

  read

  Returns the homes in your saved homes, with the collection each is in. Status is for_sale, bidding or sold; a sold home carries its final price. Pass collection_id to see one collection only.

  POST /api/v1/hemnet/list_saved_homes

  Input

  Input: list_saved_homes

  Parameter	Type	Description
  collection_id	string	Only homes in this collection, from list_collections.

  Example response

  {
    "saved_homes": [
      {
        "listing_id": "l_21730488",
        "address": "Karlbergsvägen 120, Vasastan, Stockholm",
        "collection": "Flytt 2027",
        "status": "for_sale",
        "asking_price_sek": 5450000
      },
      {
        "listing_id": "l_21644102",
        "address": "Hornsgatan 55, Södermalm, Stockholm",
        "collection": "Flytt 2027",
        "status": "sold",
        "final_price_sek": 6100000
      }
    ]
  }

• POST

  list_collections

  Your collections (samlingar) of saved homes, with who they are shared with.

  read

  Returns your collections with the number of homes in each and the people each is shared with. Use collection_id with list_saved_homes and save_home.

  POST /api/v1/hemnet/list_collections

  Input

  No parameters.

  Example response

  {
    "collections": [
      {
        "collection_id": "col_flytt27",
        "name": "Flytt 2027",
        "homes": 2,
        "shared_with": [
          "Maria"
        ]
      },
      {
        "collection_id": "col_sommar",
        "name": "Sommarstuga",
        "homes": 0,
        "shared_with": []
      }
    ]
  }

• POST

  list_upcoming_viewings

  Viewing times of your saved homes, soonest first, with address and broker.

  read

  Returns the viewings of your saved homes that have not happened yet, soonest first, with address and broker. It looks 14 days ahead unless you set until.

  POST /api/v1/hemnet/list_upcoming_viewings

  Input

  Input: list_upcoming_viewings

  Parameter	Type	Description
  until	date	Only viewings up to this date. Default: 14 days ahead.

  Example response

  {
    "viewings": [
      {
        "listing_id": "l_21730488",
        "address": "Karlbergsvägen 120, Vasastan, Stockholm",
        "starts_at": "2026-10-17T12:00:00+02:00",
        "broker": "Exempel Mäkleri, Vasastan",
        "bidding_started": false
      }
    ]
  }

• POST

  list_saved_searches

  Your saved searches with filters and notification settings.

  read

  Returns your saved searches with their filters, how you are notified (email or push) and how often. Use saved_search_id with delete_saved_search.

  POST /api/v1/hemnet/list_saved_searches

  Input

  No parameters.

  Example response

  {
    "saved_searches": [
      {
        "saved_search_id": "ss_48213",
        "location": "Täby kommun",
        "filters": {
          "housing_types": [
            "villa"
          ],
          "price_max": 9000000,
          "rooms_min": 5
        },
        "notify_by": "push",
        "frequency": "live"
      }
    ]
  }

• POST

  list_followed_homes

  Your own home and other homes you follow, with the value Hemnet shows over time.

  read

  Returns the homes whose value you follow, your own and others, each with the value Hemnet shows and how it changed over time. The value is Hemnet's estimate. Homes that are not for sale can be followed too.

  POST /api/v1/hemnet/list_followed_homes

  Input

  No parameters.

  Example response

  {
    "followed_homes": [
      {
        "address": "Storgatan 1, Uppsala",
        "estimated_value_sek": 3980000,
        "change_since_start_pct": 2.4,
        "history": [
          {
            "date": "2026-04-01",
            "value_sek": 3890000
          },
          {
            "date": "2026-10-01",
            "value_sek": 3980000
          }
        ]
      }
    ]
  }

• POST

  save_home

  Save a listing to your saved homes, optionally into one of your collections.

  asks first write

  Saves a listing to your saved homes, and into a collection when collection_id is set. People a collection is shared with see the new home, which is why this asks first. By default you confirm each call; you can switch that off for this tool.

  POST /api/v1/hemnet/save_home

  Input

  Input: save_home

  Parameter	Type	Description
  listing_id required	string	Listing ID from search_listings or list_saved_homes.
  collection_id	string	Collection from list_collections.

  Example response

  {
    "listing_id": "l_21730488",
    "saved": true,
    "collection_id": "col_flytt27"
  }

• POST

  remove_saved_home

  Remove a listing from your saved homes.

  write

  Removes a listing from your saved homes and from its collection. It runs without asking: nobody is notified and save_home undoes it in one call.

  POST /api/v1/hemnet/remove_saved_home

  Input

  Input: remove_saved_home

  Parameter	Type	Description
  listing_id required	string	Listing ID from search_listings or list_saved_homes.

  Example response

  {
    "listing_id": "l_21644102",
    "saved": false
  }

• POST

  create_saved_search

  Save a search and get notified about new homes that match it.

  write

  Creates a saved search and returns how many homes match it now. Notifications go to you by email or push, live or as a summary. It runs without asking: it reaches no one else and delete_saved_search undoes it in one call.

  POST /api/v1/hemnet/create_saved_search

  Input

  Input: create_saved_search

  Parameter	Type	Description
  location required	string	Area, municipality or street, e.g. "Vasastan, Stockholm".
  filters	object	Any of housing_types, price_min, price_max, rooms_min, living_area_min.
  notify_by	enum	email or push. Default: email.
  frequency	enum	live or summary. Default: summary.

  Example response

  {
    "saved_search_id": "ss_48213",
    "location": "Täby kommun",
    "filters": {
      "housing_types": [
        "villa"
      ],
      "price_max": 9000000,
      "rooms_min": 5
    },
    "notify_by": "push",
    "frequency": "live",
    "matching_now": 37
  }

• POST

  delete_saved_search

  Delete one of your saved searches and its notifications.

  write

  Deletes one saved search and stops its notifications. It runs without asking: it reaches no one else, and create_saved_search with the same filters brings it back.

  POST /api/v1/hemnet/delete_saved_search

  Input

  Input: delete_saved_search

  Parameter	Type	Description
  saved_search_id required	string	Saved search ID from list_saved_searches.

  Example response

  {
    "saved_search_id": "ss_48213",
    "deleted": true
  }

• POST

  follow_home

  Follow the value of any home by address, on the market or not.

  write

  Adds a home to the homes whose value you follow, for sale or not. It changes only your own list, so it runs without asking. Unfollowing is done in the Hemnet app.

  POST /api/v1/hemnet/follow_home

  Input

  Input: follow_home

  Parameter	Type	Description
  address required	string	Street address with town, e.g. "Storgatan 1, Uppsala".

  Example response

  {
    "address": "Storgatan 1, Uppsala",
    "following": true,
    "estimated_value_sek": 3980000
  }

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.