APIs / OpenRent / Search

OpenRent: Search

Search from OpenRent as JSON. 1 credit per successful call.

GET /v1/openrent/search

Parameters

Send parameters in the query string.

ParameterTypeRequiredAllowed values
locationstringRequiredUp to 80 characters
min_priceintegerOptionalAny
max_priceintegerOptionalAny
min_bedroomsintegerOptionalAny
max_bedroomsintegerOptionalAny
min_bathroomsintegerOptionalAny
max_bathroomsintegerOptionalAny
property_typestringOptionalhouse, flat, room
furnishedstringOptionalfurnished, unfurnished, any
available_beforestringOptionalAny
max_min_tenancyintegerOptionalAny
sortstringOptionalrelevance, price_asc, price_desc, newest, distance
pageintegerOptionalAny
pets_allowedbooleanOptionalAny
students_allowedbooleanOptionalAny
families_allowedbooleanOptionalAny
dss_acceptedbooleanOptionalAny
bills_includedbooleanOptionalAny
has_gardenbooleanOptionalAny
has_parkingbooleanOptionalAny
has_fireplacebooleanOptionalAny
has_videobooleanOptionalAny
live_onlybooleanOptionalAny

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.