--- title: "OpenRent API: JSON data, 4 endpoints, 1 credit per call" description: "OpenRent API for UK homes and rooms to rent, with property details, landlord listings and location autocomplete as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/openrent --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / OpenRent 1 credit per call 4 endpoints 33 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id integer | url url | title string | description string | rent\_per\_month number | rent\_per\_week number | currency string | bedrooms integer | bathrooms integer | property\_type string | is\_studio boolean | is\_shared boolean | furnished string | pets\_allowed boolean | students\_allowed boolean | families\_allowed boolean | dss\_accepted boolean | bills\_included boolean | has\_garden boolean | has\_parking boolean | has\_fireplace boolean | has\_video boolean | video\_viewings\_accepted boolean | listed\_at string | available\_from string | minimum\_tenancy\_months integer | latitude number | longitude number | distance\_miles number | let\_agreed boolean | is\_new boolean | is\_featured boolean | thumbnail\_url url | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 2925062 | https://www.openrent.co.uk/2925062 | Room in a Shared House, Primley Park Lane, LS17 | Gorgeous, Single Bedroom available in Leeds LS17 7JR. Near shops, restaurants, bars and David Lloyd sports complex. 20 mi | 368.33 | 85 | GBP | 3 | 2 | room | false | true | furnished | false | true | true | false | false | true | true | true | false | true | 2026-06-08T07:04:18+00:00 | 2026-10-28 | 3 | 53.854668 | \-1.5326618 | 6.14 | false | false | false | https://imagescdn.openrent.co.uk/listings/2925062/o\_1jqiv67tv18i1151n130pu841pfm1.JPG\_homepage.JPG | | 2 | 3108327 | https://www.openrent.co.uk/3108327 | Room in a Shared House, Kelso Heights, LS3 | fantastic opportunity to rent a room in a well-located shared house in the LS3 area of Leeds.The property offers comfortab | 400 | 92.31 | GBP | 4 | 2 | room | false | true | furnished | false | true | false | true | true | true | true | false | false | false | 2026-11-11T14:52:03+00:00 | 2026-11-11 | 6 | 53.8063 | \-1.5648124 | 1.03 | false | false | false | https://imagescdn.openrent.co.uk/listings/3108327/o\_1k75hc4gh143u3i014bi1s0p1c0e0.JPG\_homepage.JPG | | 3 | 3098314 | https://www.openrent.co.uk/3098314 | Room in a Shared House, Brudenell Avenue, LS6 | Fantastic Shared House in LS6 1HD – Bills Included, Parking & Garden AccessA great opportunity to rent a room in a welc | 400 | 92.31 | GBP | 4 | 2 | room | false | true | furnished | false | true | false | false | true | true | true | false | false | false | 2026-11-03T14:28:12+00:00 | 2026-11-03 | 0 | 53.812164 | \-1.5672779 | 1.61 | false | false | false | https://imagescdn.openrent.co.uk/listings/3098314/o\_1k6gss66e1upmvi8ul3b1s1nd90.JPG\_homepage.JPG | Recorded from our API · 3 items shown · 33 datapoints per item GET /v1/openrent/search?location=Leeds&max\_price=1500&min\_bedrooms=2&sort=price\_asc 33 datapoints ### Identity - id integer - title string - property\_type string ### Contact - url url - thumbnail\_url url ### Location - latitude number - longitude number ### Price - currency string ### Other - description string - rent\_per\_month number - rent\_per\_week number - bedrooms integer - bathrooms integer - is\_studio boolean - is\_shared boolean - furnished string - pets\_allowed boolean - students\_allowed boolean - families\_allowed boolean - dss\_accepted boolean - bills\_included boolean - has\_garden boolean - has\_parking boolean - has\_fireplace boolean - has\_video boolean - video\_viewings\_accepted boolean - listed\_at string - available\_from string - minimum\_tenancy\_months integer - distance\_miles number - let\_agreed boolean - is\_new boolean - is\_featured boolean Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/openrent/autocomplete`](https://perceptlayer.com/apis/openrent/autocomplete) | `query` | 1 credit | | [GET `/v1/openrent/landlord`](https://perceptlayer.com/apis/openrent/landlord) | `id` +2 optional | 1 credit | | [GET `/v1/openrent/property`](https://perceptlayer.com/apis/openrent/property) | `id` | 1 credit | | [GET `/v1/openrent/search`](https://perceptlayer.com/apis/openrent/search) | `location` +22 optional | 1 credit | Overview ## About the OpenRent API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)