OnTheMarket APIonthemarket.com ↗
Search UK rental properties on OnTheMarket.com by location, price, bedrooms, and type. Returns listings with address, price, agent details, and features.
What is the OnTheMarket API?
The OnTheMarket Rentals API exposes 1 endpoint — search_rentals — that returns up to 30 rental listings per page from OnTheMarket.com, covering the full UK market. Each result includes address, monthly rent in GBP, bedroom and bathroom counts, property features, and agent details. Location accepts UK postcodes or city/area names, and optional filters let you narrow by price range, bedroom count, property type, and keywords.
curl -X GET 'https://api.parse.bot/scraper/fcb9bd7d-a4e6-4105-80a4-ba97b8eab5cd/search_rentals?page=1&keywords=garden&location=SW1A+1AA&max_price=5000&min_price=1000&max_bedrooms=3&min_bedrooms=2&property_type=detached' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace onthemarket-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: OnTheMarket SDK — bounded, re-runnable; every call capped."""
from parse_apis.onthemarket_com_api import OnTheMarket, PropertyType, LocationNotFound
client = OnTheMarket()
# Search for flats to rent near a London postcode, filtered by price and bedrooms
for prop in client.rental_properties.search(
location="SW1A 1AA",
property_type=PropertyType.FLAT,
min_bedrooms=2,
max_price=5000,
limit=3,
):
print(prop.address, prop.price, prop.bedrooms, prop.property_type)
# Drill-down: take one result
result = client.rental_properties.search(
location="manchester", keywords="garden", limit=1
).first()
if result:
print(result.property_title, result.short_price, result.agent_name)
# Typed error handling
try:
for p in client.rental_properties.search(location="ZZZZZ999", limit=1):
print(p.address)
except LocationNotFound as e:
print(f"Location not found: {e.location}")
print("exercised: rental_properties.search")
Search rental properties by location with optional filters for price range (PCM), bedroom count, property type, and keywords. Returns paginated results with 30 properties per page, auto-iterated by the SDK. Results include address, price, bedrooms, bathrooms, features, agent details, and coordinates.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (30 results per page). |
| keywords | string | Keyword filter for property descriptions (e.g. 'garden', 'air-conditioning', 'parking'). |
| locationrequired | string | UK postcode (e.g. 'SW1A 1AA') or area/city name (e.g. 'london', 'manchester'). Resolved to a location slug via the OnTheMarket autocomplete API. |
| max_price | integer | Maximum monthly rent in GBP (per calendar month). |
| min_price | integer | Minimum monthly rent in GBP (per calendar month). |
| max_bedrooms | integer | Maximum number of bedrooms. |
| min_bedrooms | integer | Minimum number of bedrooms. |
| property_type | string | Filter by property type. When omitted, all property types are returned. |
{
"type": "object",
"fields": {
"page": "current page number",
"per_page": "number of results per page (always 30)",
"properties": "array of rental property listings",
"total_results": "total number of matching properties"
},
"sample": {
"data": {
"page": 1,
"per_page": 30,
"properties": [
{
"id": "15071921",
"price": "£3,900 pcm (£900 pw)",
"address": "Buckingham Gate, London, SW1E",
"bedrooms": 2,
"features": [
"Nearest station 0.2mi.",
"Furnished",
"Nearest school 0.1mi."
],
"latitude": 51.49891,
"bathrooms": 2,
"image_url": "https://media.onthemarket.com/properties/15071921/1628608525/image-0-480x320.webp",
"longitude": -0.138518,
"agent_name": "Chestertons - Westminster",
"agent_phone": "020 8022 7380",
"details_url": "https://www.onthemarket.com/details/15071921/",
"short_price": "£3,900",
"property_type": "Flat",
"property_title": "2 bedroom flat to rent",
"days_since_added": "Added > 14 days"
}
],
"total_results": 5
},
"status": "success"
}
}About the OnTheMarket API
What the API Returns
The search_rentals endpoint queries UK rental listings from OnTheMarket.com and returns a paginated response. Each call yields a properties array alongside total_results, page, and per_page (fixed at 30). Individual property objects include address, monthly rent (PCM in GBP), bedroom count, bathroom count, a features list, and agent contact details.
Filtering and Location
The only required parameter is location, which accepts either a UK postcode (e.g. SW1A 1AA) or a place name (e.g. manchester, edinburgh). Price filters use min_price and max_price in GBP per calendar month. Bedroom range is controlled by min_bedrooms and max_bedrooms. The property_type parameter narrows results to a specific type (e.g. flat, house); omitting it returns all types. The keywords parameter matches against property descriptions for terms like garden, parking, or air-conditioning.
Pagination
Results are paginated at 30 per page. The page parameter selects which page to retrieve, and total_results tells you how many listings match your query in total. The Parse SDK auto-iterates pages when needed, so you can collect full result sets without manually managing page increments.
The OnTheMarket API is a managed, monitored endpoint for onthemarket.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when onthemarket.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official onthemarket.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a rental search tool filtered by London postcode, bedroom count, and maximum monthly budget
- Aggregate property listings across multiple UK cities to compare average asking rents by area
- Alert users to new listings matching saved keyword searches like 'garden flat' or 'parking included'
- Track how many rental properties are available in a given postcode over time using total_results
- Feed agent contact details into a CRM for property professionals monitoring active listings
- Filter by property_type and min_bedrooms to find family houses available in a target neighbourhood
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does OnTheMarket have an official developer API?+
What property detail fields does each listing include?+
properties array includes address, monthly rent in GBP, bedroom count, bathroom count, a features array, and agent details. Keyword filters apply against property descriptions, but the raw description text itself is not a guaranteed top-level field in every response — check the features array for descriptive attributes.Does the API cover sale listings, not just rentals?+
search_rentals endpoint. You can fork it on Parse and revise it to add a sales listings endpoint.