OpenRent: Search
Search from OpenRent as JSON. 1 credit per successful call.
GET /v1/openrent/search
Parameters
Send parameters in the query string.
| Parameter | Type | Required | Allowed values |
|---|---|---|---|
location | string | Required | Up to 80 characters |
min_price | integer | Optional | Any |
max_price | integer | Optional | Any |
min_bedrooms | integer | Optional | Any |
max_bedrooms | integer | Optional | Any |
min_bathrooms | integer | Optional | Any |
max_bathrooms | integer | Optional | Any |
property_type | string | Optional | house, flat, room |
furnished | string | Optional | furnished, unfurnished, any |
available_before | string | Optional | Any |
max_min_tenancy | integer | Optional | Any |
sort | string | Optional | relevance, price_asc, price_desc, newest, distance |
page | integer | Optional | Any |
pets_allowed | boolean | Optional | Any |
students_allowed | boolean | Optional | Any |
families_allowed | boolean | Optional | Any |
dss_accepted | boolean | Optional | Any |
bills_included | boolean | Optional | Any |
has_garden | boolean | Optional | Any |
has_parking | boolean | Optional | Any |
has_fireplace | boolean | Optional | Any |
has_video | boolean | Optional | Any |
live_only | boolean | Optional | Any |
Example request
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.
Run this endpoint in the playground with your own parameters. 1 credit per successful call; failed calls are free.