Sign inGet a free API keyDashboard
Menu

APIs / Real estate / OpenRent

1 credit per call4 endpoints33 datapoints

OpenRent API

OpenRent API for UK homes and rooms to rent, with property details, landlord listings and location autocomplete as JSON. 1 credit per successful call.

Get a free API keyRun it below
OpenRent
GET/v1/openrent/search?location=Leeds&max_price=1500&min_bedrooms=2&sort=price_asc
{
  "success": true,
  "data": {
    "listings": [
      {
        "id": 2925062,
        "url": "https://www.openrent.co.uk/2925062",
        "title": "Room in a Shared House, Primley Park Lane, LS17",
        "description": "Gorgeous, Single Bedroom available in Leeds LS17 7JR. Near shops, restaurants, bars and David Lloyd sports complex. 20 mi",
        "rent_per_month": 368.33,
        "rent_per_week": 85,
        "currency": "GBP",
        "bedrooms": 3,
        "bathrooms": 2,
        "property_type": "room",
        "is_studio": false,
        "is_shared": true,
        "furnished": "furnished",
        "pets_allowed": false,
        "students_allowed": true,
        "families_allowed": true,
        "dss_accepted": false,
        "bills_included": false,
        "has_garden": true,
        "has_parking": true,
        "has_fireplace": true,
        "has_video": false,
        "video_viewings_accepted": true,
        "listed_at": "2026-06-08T07:04:18+00:00",
        "available_from": "2026-10-28",
        "minimum_tenancy_months": 3,
        "latitude": 53.854668,
        "longitude": -1.5326618,
        "distance_miles": 6.14,
        "let_agreed": false,
        "is_new": false,
        "is_featured": false,
        "thumbnail_url": "https://imagescdn.openrent.co.uk/listings/2925062/o_1jqiv67tv18i1151n130pu841pfm1.JPG_homepage.JPG"
      },
      {
        "id": 3108327,
        "url": "https://www.openrent.co.uk/3108327",
        "title": "Room in a Shared House, Kelso Heights, LS3",
        "description": "fantastic opportunity to rent a room in a well-located shared house in the LS3 area of Leeds.The property offers comfortab",
        "rent_per_month": 400,
        "rent_per_week": 92.31,
        "currency": "GBP",
        "bedrooms": 4,
        "bathrooms": 2,
        "property_type": "room",
        "is_studio": false,
        "is_shared": true,
        "furnished": "furnished",
        "pets_allowed": false,
        "students_allowed": true,
        "families_allowed": false,
        "dss_accepted": true,
        "bills_included": true,
        "has_garden": true,
        "has_parking": true,
        "has_fireplace": false,
        "has_video": false,
        "video_viewings_accepted": false,
        "listed_at": "2026-11-11T14:52:03+00:00",
        "available_from": "2026-11-11",
        "minimum_tenancy_months": 6,
        "latitude": 53.8063,
        "longitude": -1.5648124,
        "distance_miles": 1.03,
        "let_agreed": false,
        "is_new": false,
        "is_featured": false,
        "thumbnail_url": "https://imagescdn.openrent.co.uk/listings/3108327/o_1k75hc4gh143u3i014bi1s0p1c0e0.JPG_homepage.JPG"
      },
      {
        "id": 3098314,
        "url": "https://www.openrent.co.uk/3098314",
        "title": "Room in a Shared House, Brudenell Avenue, LS6",
        "description": "Fantastic Shared House in LS6 1HD – Bills Included, Parking & Garden AccessA great opportunity to rent a room in a welc",
        "rent_per_month": 400,
        "rent_per_week": 92.31,
        "currency": "GBP",
        "bedrooms": 4,
        "bathrooms": 2,
        "property_type": "room",
        "is_studio": false,
        "is_shared": true,
        "furnished": "furnished",
        "pets_allowed": false,
        "students_allowed": true,
        "families_allowed": false,
        "dss_accepted": false,
        "bills_included": true,
        "has_garden": true,
        "has_parking": true,
        "has_fireplace": false,
        "has_video": false,
        "video_viewings_accepted": false,
        "listed_at": "2026-11-03T14:28:12+00:00",
        "available_from": "2026-11-03",
        "minimum_tenancy_months": 0,
        "latitude": 53.812164,
        "longitude": -1.5672779,
        "distance_miles": 1.61,
        "let_agreed": false,
        "is_new": false,
        "is_featured": false,
        "thumbnail_url": "https://imagescdn.openrent.co.uk/listings/3098314/o_1k6gss66e1upmvi8ul3b1s1nd90.JPG_homepage.JPG"
      }
    ],
    "search_metadata": {
      "location": "Leeds",
      "slug": "leeds",
      "total_results": 204,
      "page": 1,
      "page_size": 20,
      "has_more": true,
      "sort": "price_asc",
      "applied_filters": {
        "live_only": true,
        "max_price": "1500",
        "min_bedrooms": "2"
      }
    }
  },
  "meta": {
    "endpoint_family": "search",
    "duration_ms": 8054,
    "request_id": "req_c9eb06ac073e4bb08fd51a3462da89b7",
    "credits_charged": 1,
    "credits_remaining": 1833
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idintegerurlurltitlestringdescriptionstringrent_per_monthnumberrent_per_weeknumbercurrencystringbedroomsintegerbathroomsintegerproperty_typestringis_studiobooleanis_sharedbooleanfurnishedstringpets_allowedbooleanstudents_allowedbooleanfamilies_allowedbooleandss_acceptedbooleanbills_includedbooleanhas_gardenbooleanhas_parkingbooleanhas_fireplacebooleanhas_videobooleanvideo_viewings_acceptedbooleanlisted_atstringavailable_fromstringminimum_tenancy_monthsintegerlatitudenumberlongitudenumberdistance_milesnumberlet_agreedbooleanis_newbooleanis_featuredbooleanthumbnail_urlurl
12925062https://www.openrent.co.uk/2925062Room in a Shared House, Primley Park Lane, LS17Gorgeous, Single Bedroom available in Leeds LS17 7JR. Near shops, restaurants, bars and David Lloyd sports complex. 20 mi368.3385GBP32roomfalsetruefurnishedfalsetruetruefalsefalsetruetruetruefalsetrue2026-06-08T07:04:18+00:002026-10-28353.854668-1.53266186.14falsefalsefalsehttps://imagescdn.openrent.co.uk/listings/2925062/o_1jqiv67tv18i1151n130pu841pfm1.JPG_homepage.JPG
23108327https://www.openrent.co.uk/3108327Room in a Shared House, Kelso Heights, LS3fantastic opportunity to rent a room in a well-located shared house in the LS3 area of Leeds.The property offers comfortab40092.31GBP42roomfalsetruefurnishedfalsetruefalsetruetruetruetruefalsefalsefalse2026-11-11T14:52:03+00:002026-11-11653.8063-1.56481241.03falsefalsefalsehttps://imagescdn.openrent.co.uk/listings/3108327/o_1k75hc4gh143u3i014bi1s0p1c0e0.JPG_homepage.JPG
33098314https://www.openrent.co.uk/3098314Room in a Shared House, Brudenell Avenue, LS6Fantastic Shared House in LS6 1HD – Bills Included, Parking & Garden AccessA great opportunity to rent a room in a welc40092.31GBP42roomfalsetruefurnishedfalsetruefalsefalsetruetruetruefalsefalsefalse2026-11-03T14:28:12+00:002026-11-03053.812164-1.56727791.61falsefalsefalsehttps://imagescdn.openrent.co.uk/listings/3098314/o_1k6gss66e1upmvi8ul3b1s1nd90.JPG_homepage.JPG

Recorded from our API · 3 items shown · 33 datapoints per itemGET /v1/openrent/search?location=Leeds&max_price=1500&min_bedrooms=2&sort=price_asc

33 datapoints

Identity

  • idinteger
  • titlestring
  • property_typestring

Contact

  • urlurl
  • thumbnail_urlurl

Location

  • latitudenumber
  • longitudenumber

Price

  • currencystring

Other

  • descriptionstring
  • rent_per_monthnumber
  • rent_per_weeknumber
  • bedroomsinteger
  • bathroomsinteger
  • is_studioboolean
  • is_sharedboolean
  • furnishedstring
  • pets_allowedboolean
  • students_allowedboolean
  • families_allowedboolean
  • dss_acceptedboolean
  • bills_includedboolean
  • has_gardenboolean
  • has_parkingboolean
  • has_fireplaceboolean
  • has_videoboolean
  • video_viewings_acceptedboolean
  • listed_atstring
  • available_fromstring
  • minimum_tenancy_monthsinteger
  • distance_milesnumber
  • let_agreedboolean
  • is_newboolean
  • is_featuredboolean

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/openrent/search?location=Leeds&max_price=1500&min_bedrooms=2&sort=price_asc" \
  -H "X-API-Key: $API_KEY"

OpenRent · 4 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/openrent/autocomplete
query
1 credit
GET/v1/openrent/landlord
id+2 optional
1 credit
GET/v1/openrent/property
id
1 credit
GET/v1/openrent/search
location+22 optional
1 credit

Overview

What you can get

The OpenRent API returns OpenRent rental data as JSON through 4 endpoints.

  • Search: search takes a location, with min_price, max_price, min_bedrooms, max_bedrooms, min_bathrooms, max_bathrooms, property_type (house, flat or room), furnished (furnished, unfurnished or any), available_before, max_min_tenancy, sort (relevance, price_asc, price_desc, newest or distance), page, and the true-or-false filters pets_allowed, students_allowed, families_allowed, dss_accepted, bills_included, has_garden, has_parking, has_fireplace, has_video and live_only.
  • Properties: property takes an id.
  • Landlords: landlord takes an id, with page and live_only.
  • Autocomplete: autocomplete takes a query.

The recorded search for Leeds, up to 1,500 with at least two bedrooms and sorted by price_asc, returns listings with id, url, title, description, rent_per_month, rent_per_week, currency, bedrooms, bathrooms, property_type, is_studio, is_shared, furnished, pets_allowed, students_allowed, families_allowed, dss_accepted, bills_included, listed_at, available_from, minimum_tenancy_months, latitude, longitude, distance_miles, let_agreed and thumbnail_url. It also returns search_metadata with total_results (204), page_size, has_more and applied_filters.

How a call works

Search a town: GET /v1/openrent/search?location=Leeds&max_price=1500&min_bedrooms=2&sort=price_asc with your key in the X-API-Key header. Each listing's id is what property takes. Page with page while has_more is true. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track asking rents per month and per week in a UK town or city

Use the OpenRent API to track asking rents per month and per week in a UK town or city

Find pet-friendly, student or DSS-accepted lets with the true-or-false filters

Use the OpenRent API to find pet-friendly, student or DSS-accepted lets with the true-or-false filters

Compare rooms in shared houses with whole flats using `property_type` and `is_shared`

Use the OpenRent API to compare rooms in shared houses with whole flats using `property_type` and `is_shared`

Watch move-in dates with `available_before` and `available_from`

Use the OpenRent API to watch move-in dates with `available_before` and `available_from`

FAQ

Questions

Do I need an OpenRent account?

No. You call this OpenRent API with your Perceptlayer key in the `X-API-Key` header, with no OpenRent login.

How much does the OpenRent API cost?

Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Does it include let-agreed properties?

Each listing carries `let_agreed`. Pass `live_only` to `search` or `landlord` to control whether only live listings come back.

Should I build an OpenRent scraper instead?

You can, but an OpenRent scraper is code you maintain: page changes break it, requests get blocked, and OpenRent's terms govern how you collect data. The OpenRent API gives you 4 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the OpenRent API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs