OnTheMarket API & Scraper
The OnTheMarket API returns UK real-estate listings as clean JSON.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
You first call location_search to resolve a location id, then search returns matching properties and property_detail returns the full listing. It is built for UK proptech and property portals that need OnTheMarket data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.
OnTheMarket price fields, and why some rows have almost nothing in them
Prices behave differently in the two channels and differently between search and property_detail, and every page of 30 results can contain sponsored rows that look like broken listings. These values were read from live for-sale and to-rent searches plus a property_detail call on 2026-08-27.
| Field | for-sale | to-rent | Note |
|---|---|---|---|
| property_id | "19648142" | "18159214" | 8 digits for a real listing. Sponsored rows carry a short 4-digit id such as "1689". |
| price_display | "£695,000" | "£1,625 pcm (£375 pw)" | Formatted text. The rental string packs monthly and weekly rent into one value. |
| price_short | "£695k" | "£1,625" | Abbreviated display text. |
| price_amount | absent on search rows | absent on search rows | The numeric price exists only on property_detail, which returned 695000 for the same listing. |
| price_qualifier | "Guide price" or null | null on every row sampled | Free text from the agent, not a fixed list. null means no qualifier was set. |
| added | "Added today", "Reduced today", "Added > 14 days" | "Added today", "Added < 14 days" | A human phrase, not a date. Use added_within_days to filter by recency. |
| features[0] | "Tenure: Share of freehold" | - | Tenure is usually first in features on a sale listing; property_detail returns it properly in key_info. |
| total_results vs count | 8933 vs 30 | 2071 vs 30 | total_results is the market-wide match count; count is what came back on this page. |
Sponsored developer adverts are returned inside items[] alongside real listings. They have a short property_id, an agent block, images under an /agent-products/in-market-ads/ path, and null for title, price_display, bedrooms, address, latitude, longitude and details_url. A Manchester to-rent page of 30 contained 2 of them. Filter on details_url being non-null to get properties only.
Real request and response JSON
Captured from the indexed primary action, search, on .
{
"method": "POST",
"url": "https://api.reefapi.com/onthemarket/v1/search",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"location": "London"
}
}{
"ok": true,
"meta": {
"api": "onthemarket",
"endpoint": "search",
"mode": "live",
"latency_ms": 1074.3,
"record_count": 28,
"bytes": 577254,
"cache_hit": false,
"completeness_pct": 100,
"stop_reason": "max_pages",
"channel": "for-sale",
"total_results": 50000,
"filters_applied": {
"location-type": "country",
"page": 1,
"exclusive-first": true,
"under-offer": false,
"location-id": "london",
"search-type": "for-sale",
"frame-size": 30,
"direction": "desc",
"location-data": {
"name": "London",
"seo-id": "london",
"location-type": "country"
},
"view": "list",
"sort-field": "recommended"
},
"grid_rows": 30,
"sponsored_count": 2,
"field_note": "OnTheMarket mixes paid adverts into its results grid. They are marked by the source itself; 2 were found and removed, so `count` is properties only — pass include_sponsored=true to receive them.",
"charged_credits": 2,
"version": "1.1.0"
},
"data": {
"items": [
{
"sponsored": false,
"property_id": "18527409",
"title": "3 bedroom semi-detached house for sale",
"property_type": "Semi-detached house",
"price_display": "£850,000",
"price_short": "£850k",
"price_qualifier": "Offers in excess of",
"bedrooms": 3,
"address": "Coppetts Road, London, N10",
"added": "Added > 14 days",
"features": [
"Tenure: Freehold",
"3 Bedrooms",
"2 Reception rooms",
"Downstairs WC"
],
"latitude": 51.600319,
"longitude": -0.153085,
"spotlight": true,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/18527409/1636944061/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/18527409/1636944061/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/18527409/1636944061/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/18527409/1636944061/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/18527409/1636944061/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/18527409/1636944061/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/18527409/",
"agent": {
"id": 70864,
"name": "Martyn Gerrard - Muswell Hill",
"logo_url": "https://media.onthemarket.com/agents/companies/14128/250211145132343/logo-190x100.png",
"details_url": "https://www.onthemarket.com/agents/branch/martyn-gerrard-muswell-hill/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20398753",
"title": "1 bedroom apartment for sale",
"property_type": "Apartment",
"price_display": "£75,000",
"price_short": "£75k",
"price_qualifier": "Shared ownership",
"bedrooms": 1,
"address": "25% SHARE AVAILABLE",
"added": "Added today",
"features": [
"Tenure: Leasehold (119 years remaining)",
"Shared ownership",
"25% share available",
"One bedroom"
],
"latitude": 51.561279982124,
"longitude": -0.27638001380319,
"spotlight": null,
"has_virtual_tour": null,
"cover_image": "https://media.onthemarket.com/properties/20398753/1646635898/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20398753/1646635898/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20398753/1646635898/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20398753/1646635898/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20398753/1646635898/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20398753/1646635898/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20398753/",
"agent": {
"id": 5432,
"name": "haart Estate Agents - Wembley",
"logo_url": "https://media.onthemarket.com/agents/branches/5432/240501112207256/logo-190x100.jpg",
"details_url": "https://www.onthemarket.com/agents/branch/haart-estate-agents-wembley/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20398124",
"title": "2 bedroom apartment for sale",
"property_type": "Apartment",
"price_display": "£525,000",
"price_short": "£525k",
"price_qualifier": null,
"bedrooms": 2,
"address": "Wembley Park",
"added": "Added today",
"features": [
"Tenure: Leasehold (122 years remaining)",
"Two bedroom",
"Apartment",
"Two bathroom"
],
"latitude": 51.5611873853,
"longitude": -0.274732687276,
"spotlight": null,
"has_virtual_tour": null,
"cover_image": "https://media.onthemarket.com/properties/20398124/1646623791/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20398124/1646623791/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20398124/1646623791/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20398124/1646623791/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20398124/1646623791/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20398124/1646623791/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20398124/",
"agent": {
"id": 5432,
"name": "haart Estate Agents - Wembley",
"logo_url": "https://media.onthemarket.com/agents/branches/5432/240501112207256/logo-190x100.jpg",
"details_url": "https://www.onthemarket.com/agents/branch/haart-estate-agents-wembley/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20386104",
"title": "8 bedroom detached house for sale",
"property_type": "Detached house",
"price_display": "£15,000,000",
"price_short": "£15m",
"price_qualifier": null,
"bedrooms": 8,
"address": "Roedean Crescent, London SW15",
"added": "Added yesterday",
"features": [
"New build",
"Online viewing",
"Chain-free",
"Nearest station 0.9mi.",
"Nearest school 0.3mi."
],
"latitude": 51.456805,
"longitude": -0.257117,
"spotlight": null,
"has_virtual_tour": null,
"cover_image": "https://media.onthemarket.com/properties/20386104/1646284032/image-0-480x320.png",
"images": [
"https://media.onthemarket.com/properties/20386104/1646284032/image-0-480x320.png"
],
"details_url": "https://www.onthemarket.com/details/20386104/",
"agent": {
"id": 67674,
"name": "James Nightingall - London",
"logo_url": "https://media.onthemarket.com/agents/branches/67674/250815142323817/logo-190x100.jpg",
"details_url": "https://www.onthemarket.com/agents/branch/james-nightingall-london/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "19984011",
"title": "Studio for sale",
"property_type": "Studio",
"price_display": "£455,000",
"price_short": "£455k",
"price_qualifier": "Shared ownership",
"bedrooms": null,
"address": "Zone Oval Village Shared Ownership at Zone at Oval Village, 15 Gasholder Place, Oval, Lambeth SE11",
"added": "Added > 14 days",
"features": [
"Tenure: Leasehold",
"High spec finishes throughout",
"New build"
],
"latitude": 51.486372,
"longitude": -0.114071,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/19984011/1631169515/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/19984011/1631169515/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/19984011/1631169515/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/19984011/1631169515/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/19984011/1631169515/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/19984011/1631169515/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/19984011/",
"agent": {
"id": 62759,
"name": "Peabody - Zone Oval Village Shared Ownership",
"logo_url": "https://media.onthemarket.com/agents/companies/10420/260827122621078/logo-190x100.png",
"details_url": "https://www.onthemarket.com/new-homes/developers/development/zone-oval-village-shared-ownership-62759/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "19984012",
"title": "Studio for sale",
"property_type": "Studio",
"price_display": "£113,750",
"price_short": "£114k",
"price_qualifier": "Shared ownership",
"bedrooms": null,
"address": "Zone Oval Village Shared Ownership at Zone at Oval Village, 15 Gasholder Place, Oval, Lambeth SE11",
"added": "Added > 14 days",
"features": [
"Tenure: Leasehold",
"High spec finishes throughout",
"New build"
],
"latitude": 51.486372,
"longitude": -0.114071,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/19984012/1631169516/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/19984012/1631169516/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/19984012/1631169516/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/19984012/1631169516/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/19984012/1631169516/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/19984012/1631169516/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/19984012/",
"agent": {
"id": 62759,
"name": "Peabody - Zone Oval Village Shared Ownership",
"logo_url": "https://media.onthemarket.com/agents/companies/10420/260827122621078/logo-190x100.png",
"details_url": "https://www.onthemarket.com/new-homes/developers/development/zone-oval-village-shared-ownership-62759/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "19986928",
"title": "Studio for sale",
"property_type": "Studio",
"price_display": "£455,000",
"price_short": "£455k",
"price_qualifier": "Shared ownership",
"bedrooms": null,
"address": "Zone Oval Village Shared Ownership at Zone at Oval Village, 15 Gasholder Place, Oval, Lambeth SE11",
"added": "Added > 14 days",
"features": [
"Tenure: Leasehold",
"High spec finishes throughout",
"New build"
],
"latitude": 51.486372,
"longitude": -0.114071,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/19986928/1631218342/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/19986928/1631218342/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/19986928/1631218342/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/19986928/1631218342/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/19986928/1631218342/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/19986928/1631218342/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/19986928/",
"agent": {
"id": 62759,
"name": "Peabody - Zone Oval Village Shared Ownership",
"logo_url": "https://media.onthemarket.com/agents/companies/10420/260827122621078/logo-190x100.png",
"details_url": "https://www.onthemarket.com/new-homes/developers/development/zone-oval-village-shared-ownership-62759/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "19986929",
"title": "Studio for sale",
"property_type": "Studio",
"price_display": "£113,750",
"price_short": "£114k",
"price_qualifier": "Shared ownership",
"bedrooms": null,
"address": "Zone Oval Village Shared Ownership at Zone at Oval Village, 15 Gasholder Place, Oval, Lambeth SE11",
"added": "Added > 14 days",
"features": [
"Tenure: Leasehold",
"High spec finishes throughout",
"New build"
],
"latitude": 51.486372,
"longitude": -0.114071,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/19986929/1631218343/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/19986929/1631218343/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/19986929/1631218343/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/19986929/1631218343/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/19986929/1631218343/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/19986929/1631218343/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/19986929/",
"agent": {
"id": 62759,
"name": "Peabody - Zone Oval Village Shared Ownership",
"logo_url": "https://media.onthemarket.com/agents/companies/10420/260827122621078/logo-190x100.png",
"details_url": "https://www.onthemarket.com/new-homes/developers/development/zone-oval-village-shared-ownership-62759/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20400583",
"title": "1 bedroom flat for sale",
"property_type": "Flat",
"price_display": "£250,000",
"price_short": "£250k",
"price_qualifier": "Offers in excess of",
"bedrooms": 1,
"address": "Taylor Place, Fondant Court, E3",
"added": "Added today",
"features": [
"Tenure: Leasehold (178 years remaining)",
"Stunning balcony views across London",
"Chain-free"
],
"latitude": 51.529849,
"longitude": -0.015805,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20400583/1646671240/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20400583/1646671240/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20400583/1646671240/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20400583/1646671240/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20400583/1646671240/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20400583/1646671240/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20400583/",
"agent": {
"id": 44815,
"name": "Oliver Jaques - Bow",
"logo_url": "https://media.onthemarket.com/agents/companies/5183/240618081329631/logo-190x100.jpg",
"details_url": "https://www.onthemarket.com/agents/branch/oliver-jaques-bow/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20399969",
"title": "2 bedroom flat for sale",
"property_type": "Flat",
"price_display": "£250,000",
"price_short": "£250k",
"price_qualifier": null,
"bedrooms": 2,
"address": "Sunrise Avenue, Hornchurch, RM12",
"added": "Added today",
"features": [
"Tenure: Leasehold (81 years remaining)",
"Chain-free",
"Nearest station 0.6mi.",
"Nearest school 0.2mi."
],
"latitude": 51.557208,
"longitude": 0.205618,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20399969/1646658141/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20399969/1646658141/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20399969/1646658141/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20399969/1646658141/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20399969/1646658141/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20399969/1646658141/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20399969/",
"agent": {
"id": 73372,
"name": "Bairstow Eves - Elm Park",
"logo_url": "https://media.onthemarket.com/agents/companies/14646/260126141925387/logo-190x100.jpg",
"details_url": "https://www.onthemarket.com/agents/branch/bairstow-eves-elm-park/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20193968",
"title": "2 bedroom apartment for sale",
"property_type": "Apartment",
"price_display": "£750,000",
"price_short": "£750k",
"price_qualifier": "Guide price",
"bedrooms": 2,
"address": "Hornsey Rise, London, N19",
"added": "Reduced today",
"features": [
"Tenure: Share of freehold (998 years remaining)",
"2 Bedroom raised ground period conversion"
],
"latitude": 51.570462,
"longitude": -0.123792,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20193968/1639248825/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20193968/1639248825/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20193968/1639249001/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20193968/1639249001/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20193968/1639249001/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20193968/1639248825/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20193968/",
"agent": {
"id": 70870,
"name": "Martyn Gerrard - Crouch End",
"logo_url": "https://media.onthemarket.com/agents/companies/14128/250211145132343/logo-190x100.png",
"details_url": "https://www.onthemarket.com/agents/branch/martyn-gerrard-crouch-end/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20290721",
"title": "2 bedroom flat for sale",
"property_type": "Flat",
"price_display": "£475,000",
"price_short": "£475k",
"price_qualifier": "Offers in excess of",
"bedrooms": 2,
"address": "South Lambeth Road, London",
"added": "Reduced today",
"features": [
"Tenure: Leasehold (82 years remaining)",
"Two/Three Double Bedrooms",
"Private Roof Terrace",
"Split Level"
],
"latitude": 51.476571,
"longitude": -0.123648,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20290721/1642686915/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20290721/1642686915/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20290721/1642686915/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20290721/1642686915/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20290721/1642686915/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20290721/1642686915/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20290721/",
"agent": {
"id": 73425,
"name": "Barnard Marcus - Kennington",
"logo_url": "https://media.onthemarket.com/agents/companies/14706/260218115605848/logo-190x100.png",
"details_url": "https://www.onthemarket.com/agents/branch/barnard-marcus-kennington/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20399413",
"title": "4 bedroom semi-detached house for sale",
"property_type": "Semi-detached house",
"price_display": "£1,400,000",
"price_short": "£1.4m",
"price_qualifier": null,
"bedrooms": 4,
"address": "Wessex Gardens, NW11",
"added": "Added today",
"features": [
"Tenure: Freehold",
"Spacious contemporary family home offering over 2,200 sq. ft.",
"Chain-free"
],
"latitude": 51.572978,
"longitude": -0.20726,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20399413/1646647377/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20399413/1646647377/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20399413/1646647377/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20399413/1646647377/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20399413/1646647377/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20399413/1646647377/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20399413/",
"agent": {
"id": 45370,
"name": "Hausman & Holmes - London",
"logo_url": "https://media.onthemarket.com/agents/companies/5587/180424111915782/logo-190x100.png",
"details_url": "https://www.onthemarket.com/agents/branch/hausman-and-holmes-london/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20292470",
"title": "2 bedroom apartment for sale",
"property_type": "Apartment",
"price_display": "£575,000",
"price_short": "£575k",
"price_qualifier": null,
"bedrooms": 2,
"address": "Gervase Street, London",
"added": "Reduced today",
"features": [
"Tenure: Leasehold (100 years remaining)",
"Two bedroom split level apartment",
"School conversion",
"Open plan living space",
"Chain-free"
],
"latitude": 51.47909927368164,
"longitude": -0.05851899832487106,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20292470/1642720631/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20292470/1642720631/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20292470/1642720631/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20292470/1642720631/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20292470/1642720631/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20292470/1642720631/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20292470/",
"agent": {
"id": 73431,
"name": "Barnard Marcus - Peckham",
"logo_url": "https://media.onthemarket.com/agents/companies/14706/260218115605848/logo-190x100.png",
"details_url": "https://www.onthemarket.com/agents/branch/barnard-marcus-peckham/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20308495",
"title": "5 bedroom terraced house for sale",
"property_type": "Terraced house",
"price_display": "£950,000",
"price_short": "£950k",
"price_qualifier": "Guide price",
"bedrooms": 5,
"address": "Glenthorne Road, Walthamstow",
"added": "Reduced today",
"features": [
"Tenure: Freehold",
"Stunning Victorian five bedroom terrace",
"Two bathrooms",
"Chain-free",
"Chain-free"
],
"latitude": 51.583986,
"longitude": -0.033919,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20308495/1645951884/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20308495/1645951884/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20308495/1645951884/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20308495/1645951884/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20308495/1645951884/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20308495/1643238623/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20308495/",
"agent": {
"id": 42862,
"name": "Douglas Allen - Walthamstow",
"logo_url": "https://media.onthemarket.com/agents/companies/4453/191010091523577/logo-190x100.jpg",
"details_url": "https://www.onthemarket.com/agents/branch/douglas-allen-walthamstow/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20308496",
"title": "5 bedroom terraced house for sale",
"property_type": "Terraced house",
"price_display": "£627,500",
"price_short": "£628k",
"price_qualifier": "Guide price",
"bedrooms": 5,
"address": "Glenthorne Road, London E17",
"added": "Reduced today",
"features": [
"Tenure: Freehold",
"Stunning Victorian five bedroom terrace",
"ONLY OVER 60s are eligible for the Home for Life from Homewise (incorporating a Lifetime Lease)",
"SAVINGS against the full price of this property typically range from 20% to 50% for a Lifetime Lease",
"Retirement",
"Chain-free"
],
"latitude": 51.583986,
"longitude": -0.033919,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20308496/1643725689/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20308496/1643725689/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20308496/1643238631/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20308496/1643238631/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20308496/1643238631/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20308496/1643238631/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20308496/",
"agent": {
"id": 42907,
"name": "Homewise- Southeast",
"logo_url": "https://media.onthemarket.com/agents/branches/42907/190424113818898/logo-190x100.jpg",
"details_url": "https://www.onthemarket.com/agents/branch/homewise-southeast/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20398826",
"title": "3 bedroom semi-detached house for sale",
"property_type": "Semi-detached house",
"price_display": "£690,000",
"price_short": "£690k",
"price_qualifier": null,
"bedrooms": 3,
"address": "Redhill Drive, Edgware, HA8",
"added": "Added today",
"features": [
"Tenure: Freehold",
"Chain Free",
"Chain-free"
],
"latitude": 51.597735,
"longitude": -0.268786,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20398826/1646637895/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20398826/1646637895/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20398826/1646637895/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20398826/1646637895/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20398826/1646637895/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20398826/1646637895/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20398826/",
"agent": {
"id": 5128,
"name": "Benham & Reeves - Beaufort Park",
"logo_url": "https://media.onthemarket.com/agents/companies/126/190613093114189/logo-190x100.jpg",
"details_url": "https://www.onthemarket.com/agents/branch/benham-and-reeves-beaufort-park/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "19979881",
"title": "2 bedroom apartment for sale",
"property_type": "Apartment",
"price_display": "£450,000",
"price_short": "£450k",
"price_qualifier": null,
"bedrooms": 2,
"address": "Station Road, Barnet, EN5",
"added": "Reduced today",
"features": [
"Tenure: Leasehold (141 years remaining)",
"1st & 2nd floor duplex apartment"
],
"latitude": 51.648135,
"longitude": -0.183124,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/19979881/1643793926/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/19979881/1643793926/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/19979881/1643793926/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/19979881/1643793926/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/19979881/1643793926/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/19979881/1643793926/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/19979881/",
"agent": {
"id": 70871,
"name": "Martyn Gerrard - Barnet",
"logo_url": "https://media.onthemarket.com/agents/companies/14128/250211145132343/logo-190x100.png",
"details_url": "https://www.onthemarket.com/agents/branch/martyn-gerrard-barnet/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20397825",
"title": "3 bedroom flat for sale",
"property_type": "Flat",
"price_display": "£700,000",
"price_short": "£700k",
"price_qualifier": null,
"bedrooms": 3,
"address": "City Road, London",
"added": "Added today",
"features": [
"Tenure: Leasehold",
"Private balcony with far-reaching views",
"Bright and spacious living room",
"Separate fitted kitchen",
"Study"
],
"latitude": 51.530899,
"longitude": -0.100941,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20397825/1646616976/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20397825/1646616976/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20397825/1646616976/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20397825/1646616976/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20397825/1646616976/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20397825/1646616976/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20397825/",
"agent": {
"id": 73415,
"name": "Barnard Marcus - Covent Garden",
"logo_url": "https://media.onthemarket.com/agents/companies/14706/260218115605848/logo-190x100.png",
"details_url": "https://www.onthemarket.com/agents/branch/barnard-marcus-covent-garden/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20249272",
"title": "1 bedroom flat for sale",
"property_type": "Flat",
"price_display": "£200,000",
"price_short": "£200k",
"price_qualifier": "Guide price",
"bedrooms": 1,
"address": "York Road, Ilford, IG1",
"added": "Reduced today",
"features": [
"Tenure: Leasehold",
"Auction",
"Nearest station 0.1mi.",
"Nearest school 0.2mi."
],
"latitude": 51.559165,
"longitude": 0.065859,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20249272/1641348504/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20249272/1641348504/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20249272/1641348504/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20249272/1641348504/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20249272/1641348504/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20249272/1641348504/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20249272/",
"agent": {
"id": 73347,
"name": "Bairstow Eves - Barkingside",
"logo_url": "https://media.onthemarket.com/agents/companies/14646/260126141925387/logo-190x100.jpg",
"details_url": "https://www.onthemarket.com/agents/branch/bairstow-eves-barkingside/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20396945",
"title": "2 bedroom flat for sale",
"property_type": "Flat",
"price_display": "£950,000",
"price_short": "£950k",
"price_qualifier": null,
"bedrooms": 2,
"address": "Wapping High Street, London",
"added": "Added today",
"features": [
"Tenure: Freehold",
"Exceptional private riverside terrace",
"Direct views across the River Thames towards Canary Wharf",
"Recently refurbished throughout to a high standard"
],
"latitude": 51.505404,
"longitude": -0.054276,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20396945/1646601045/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20396945/1646601045/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20396945/1646601045/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20396945/1646601045/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20396945/1646601045/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20396945/1646601045/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20396945/",
"agent": {
"id": 73415,
"name": "Barnard Marcus - Covent Garden",
"logo_url": "https://media.onthemarket.com/agents/companies/14706/260218115605848/logo-190x100.png",
"details_url": "https://www.onthemarket.com/agents/branch/barnard-marcus-covent-garden/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "19483223",
"title": "2 bedroom apartment for sale",
"property_type": "Apartment",
"price_display": "£532,500",
"price_short": "£533k",
"price_qualifier": "Shared ownership",
"bedrooms": 2,
"address": "Plot A2-05-004, 2 bed A2-05-004 at Pudding Mill Lane, Pudding Mill Lane E15",
"added": "Added > 14 days",
"features": [
"Tenure: Leasehold (990 years remaining)",
"Deposits from £6,656 for a 25% share",
"New build",
"Study"
],
"latitude": 51.532636,
"longitude": -0.010955,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/19483223/1644070372/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/19483223/1644070372/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/19483223/1644070372/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/19483223/1644070372/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/19483223/1644070372/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/19483223/1644070372/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/19483223/",
"agent": {
"id": 75567,
"name": "Sovereign Network Group - Pudding Mill Lane",
"logo_url": "https://media.onthemarket.com/agents/companies/11747/251104153139495/logo-190x100.png",
"details_url": "https://www.onthemarket.com/new-homes/developers/development/pudding-mill-lane-75567/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "19483707",
"title": "3 bedroom apartment for sale",
"property_type": "Apartment",
"price_display": "£635,000",
"price_short": "£635k",
"price_qualifier": "Shared ownership",
"bedrooms": 3,
"address": "Plot A2-05-008 , 3 bed Plot A2-05-008 at Pudding Mill Lane, Pudding Mill Lane E15",
"added": "Added > 14 days",
"features": [
"Tenure: Leasehold (990 years remaining)",
"Available with Shared Ownership starting with a 25% share",
"New build"
],
"latitude": 51.532636,
"longitude": -0.010955,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/19483707/1644068655/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/19483707/1644068655/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/19483707/1644068655/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/19483707/1644068655/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/19483707/1644068655/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/19483707/1644068655/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/19483707/",
"agent": {
"id": 75567,
"name": "Sovereign Network Group - Pudding Mill Lane",
"logo_url": "https://media.onthemarket.com/agents/companies/11747/251104153139495/logo-190x100.png",
"details_url": "https://www.onthemarket.com/new-homes/developers/development/pudding-mill-lane-75567/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "19484064",
"title": "3 bedroom apartment for sale",
"property_type": "Apartment",
"price_display": "£595,000",
"price_short": "£595k",
"price_qualifier": "Shared ownership",
"bedrooms": 3,
"address": "Plot A2-05-005, 3 bed A2-05-005 at Pudding Mill Lane, Pudding Mill Lane E15",
"added": "Added > 14 days",
"features": [
"Tenure: Leasehold (990 years remaining)",
"Available with Shared Ownership starting with a 25% share",
"New build",
"Study"
],
"latitude": 51.532636,
"longitude": -0.010955,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/19484064/1644069641/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/19484064/1644069641/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/19484064/1644069641/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/19484064/1644069641/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/19484064/1644069641/image-3-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/19484064/",
"agent": {
"id": 75567,
"name": "Sovereign Network Group - Pudding Mill Lane",
"logo_url": "https://media.onthemarket.com/agents/companies/11747/251104153139495/logo-190x100.png",
"details_url": "https://www.onthemarket.com/new-homes/developers/development/pudding-mill-lane-75567/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20396620",
"title": "3 bedroom apartment for sale",
"property_type": "Apartment",
"price_display": "£550,000",
"price_short": "£550k",
"price_qualifier": null,
"bedrooms": 3,
"address": "Medawar Drive, London, NW7",
"added": "Added today",
"features": [
"Tenure: Leasehold (993 years remaining)",
"Ridgeway Views"
],
"latitude": 51.618202,
"longitude": -0.221218,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20396620/1646594538/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20396620/1646594538/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20396620/1646594538/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20396620/1646594538/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20396620/1646594538/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20396620/1646594538/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20396620/",
"agent": {
"id": 70865,
"name": "Martyn Gerrard - Mill Hill",
"logo_url": "https://media.onthemarket.com/agents/companies/14128/250211145132343/logo-190x100.png",
"details_url": "https://www.onthemarket.com/agents/branch/martyn-gerrard-mill-hill/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20261986",
"title": "2 bedroom end of terrace house for sale",
"property_type": "End of terrace house",
"price_display": "£500,000",
"price_short": "£500k",
"price_qualifier": "Offers over",
"bedrooms": 2,
"address": "Downsell Road, London, E15",
"added": "Reduced today",
"features": [
"Tenure: Freehold",
"Nearest station 0.3mi.",
"Nearest school 0.2mi."
],
"latitude": 51.553366,
"longitude": -0.002622,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20261986/1641681333/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20261986/1641681333/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20261986/1641681333/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20261986/1641681333/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20261986/1641681333/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20261986/1641681333/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20261986/",
"agent": {
"id": 73402,
"name": "Bairstow Eves - Stratford",
"logo_url": "https://media.onthemarket.com/agents/companies/14646/260126141925387/logo-190x100.jpg",
"details_url": "https://www.onthemarket.com/agents/branch/bairstow-eves-stratford/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20395962",
"title": "2 bedroom apartment for sale",
"property_type": "Apartment",
"price_display": "£430,000",
"price_short": "£430k",
"price_qualifier": null,
"bedrooms": 2,
"address": "The Oxygen Apartments, Royal Victoria Dock",
"added": "Added today",
"features": [
"Tenure: Leasehold (168 years remaining)",
"- *Exclusive Purchaser Incentives such as savings on stamp duty, legal fees or redecoration package. Please Enquire for More Details*"
],
"latitude": 51.508291,
"longitude": 0.01893,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20395962/1646583158/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20395962/1646583158/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20395962/1646583158/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20395962/1646583158/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20395962/1646583158/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20395962/1646583158/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20395962/",
"agent": {
"id": 37019,
"name": "Madison Brook - Docklands",
"logo_url": "https://media.onthemarket.com/agents/companies/2015/260827122206037/logo-190x100.png",
"details_url": "https://www.onthemarket.com/agents/branch/madison-brook-docklands/",
"telephone": "[redacted-contact]"
}
},
{
"sponsored": false,
"property_id": "20395536",
"title": "2 bedroom flat for sale",
"property_type": "Flat",
"price_display": "£405,000",
"price_short": "£405k",
"price_qualifier": null,
"bedrooms": 2,
"address": "Balham High Road, London",
"added": "Added today",
"features": [
"Tenure: Leasehold (77 years remaining)",
"Two double bedrooms",
"Two bathrooms",
"Allocated parking space",
"Chain-free"
],
"latitude": 51.438081,
"longitude": -0.157081,
"spotlight": null,
"has_virtual_tour": true,
"cover_image": "https://media.onthemarket.com/properties/20395536/1646574922/image-0-480x320.jpg",
"images": [
"https://media.onthemarket.com/properties/20395536/1646574922/image-0-480x320.jpg",
"https://media.onthemarket.com/properties/20395536/1646574922/image-1-480x320.jpg",
"https://media.onthemarket.com/properties/20395536/1646574922/image-2-480x320.jpg",
"https://media.onthemarket.com/properties/20395536/1646574922/image-3-480x320.jpg",
"https://media.onthemarket.com/properties/20395536/1646574922/image-4-480x320.jpg"
],
"details_url": "https://www.onthemarket.com/details/20395536/",
"agent": {
"id": 73442,
"name": "Barnard Marcus - Tooting",
"logo_url": "https://media.onthemarket.com/agents/companies/14706/260218115605848/logo-190x100.png",
"details_url": "https://www.onthemarket.com/agents/branch/barnard-marcus-tooting/",
"telephone": "[redacted-contact]"
}
}
],
"count": 28,
"channel": "for-sale",
"total_results": 50000,
"sponsored_count": 2,
"filters_applied": {
"location-type": "country",
"page": 1,
"exclusive-first": true,
"under-offer": false,
"location-id": "london",
"search-type": "for-sale",
"frame-size": 30,
"direction": "desc",
"location-data": {
"name": "London",
"seo-id": "london",
"location-type": "country"
},
"view": "list",
"sort-field": "recommended"
},
"pages_fetched": 1,
"stop_reason": "max_pages"
}
}What the OnTheMarket API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| location_search | Resolve a text location (town, postcode, borough, area) to OnTheMarket location slug(s). Returns multiple ranked matches; use a result's location_id in search. | Real-estate investors call location_search to resolve a text location (town, postcode, borough, area) to OnTheMarket location slug(s). | query, channel, limit |
| search | Search UK property listings by location (for sale / to rent) with structured filters: price, beds, property type, radius, keywords, added-within and sort. Paginate with page/max_pages (30 per page). | Brokerage tools call search to search UK property listings by location (for sale / to rent) with structured filters. | location, location_id, channel, for_rent, price_min, ... |
| property_detail | Full property record: price (+qualifier), beds/baths, description, key features, key-info (tenure, council-tax band), images, floorplans, virtual/video tours, documents, nearby stations & schools, area stats (avg price, crime level), breadcrumbs and the listing agent. | Property dashboards call property_detail to get full property record. | property_id, url |
Call search from your stack
curl -X POST https://api.reefapi.com/onthemarket/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"location":"London"}'import requests
r = requests.post(
"https://api.reefapi.com/onthemarket/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"location": "London"
},
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/onthemarket/v1/search", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"location": "London"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.onthemarket.search with {"location":"London"}.Who uses this API and why
- Property portals call location_search then search to list properties in an area.
- Dashboards use property_detail to enrich a listing.
- Analysts use search to track UK inventory over time.
Questions developers ask before integrating
Why do some items have a property_id but null for price, address and bedrooms?
Those are sponsored developer adverts, not properties, and OnTheMarket mixes them into the results grid. They are easy to spot: the property_id is short ("1689", "2448", "2598" rather than an 8-digit listing id), details_url is null, every listing field is null, and the images sit under an /agent-products/in-market-ads/ path. A Manchester to-rent search returned 2 of them inside a page of 30 on 2026-08-27. Filtering on details_url being non-null removes them cleanly.
Where is the numeric price? I only get "£695,000" as a string.
search rows carry price_display and price_short only, and price_amount is not present on them at all. property_detail does return it: the same listing came back with price_display "£695,000" and price_amount 695000 on 2026-08-27. If you are only doing search, parse the display string, or filter server-side with price_min and price_max, which do take integers in GBP.
How is rent represented?
As one formatted string holding both periods: price_display "£1,625 pcm (£375 pw)", with price_short "£1,625" carrying the monthly figure alone. For the to-rent channel, price_min and price_max are monthly rent in pounds, not annual and not weekly. price_qualifier was null on every rental row sampled, since qualifiers are a sales-market thing.
What is price_qualifier, and what values can it take?
It is the agent's wording next to the asking price. "Guide price" is what showed up on live London flats, and null is common, meaning the agent set no qualifier rather than that the field failed. It is free text from the listing rather than a fixed set, so treat any string as valid and match loosely if you are grouping on it. property_detail returns the same field alongside a price_coming_soon flag.
Is `added` a date I can sort on?
No. added is a human phrase. "Added today", "Reduced today", "Added < 14 days" and "Added > 14 days" were all returned on 2026-08-27, and everything older collapses into one bucket. To work with recency, use added_within_days, which maps to the nearest window the site supports (1, 3, 7 or 14 days), and sort with sort: "newest". Anything finer than 14 days is not exposed.
Does the search include Sold STC and Under Offer properties?
Not by default. The response echoes back what it asked for in filters_applied, and a plain for-sale search showed "under-offer": false on 2026-08-27. Set include_under_offer to true to bring those listings in. The same echo is useful for debugging generally, since it shows exactly how your location, price, bedroom and property-type filters were translated, including the location slug that was resolved.
Why does total_results not match the number of items I got?
total_results is how many listings match your filters across the whole market; count is how many rows this response contains. A London flats search from £400k to £900k with 2+ beds returned total_results 8933 with count 30, and a Manchester 2-bed rental search returned 2071 with count 30. Pages are 30 listings each, max_pages merges up to 42 of them in one call, and stop_reason tells you why fetching stopped, "max_pages" when you hit your own limit.
What happens if I pass a channel value the API does not know?
channel is one of the few parameters here that rejects rather than ignores. Sending channel "purchase" returned INVALID_PARAM with detail.allowed listing every accepted value: for-sale, to-rent, buy, sale, rent, lettings. So buy and sale are aliases of for-sale, and rent and lettings of to-rent. Most other filters (price, beds, property_type, radius, sort, keywords) ignore an invalid value, meaning a bad value silently drops the filter and widens your result set instead of erroring.
How do I get the right location slug?
Call location_search first and pass a match's location_id into search as location_id. A postcode district resolves cleanly: "SW9" returned exactly one match with location_id "sw9" on 2026-08-27. Broad names are looser, and "London" resolves to the slug "london", which the echoed filters_applied reported with location-type "country". Pair a slug with radius, in miles from the 0, 0.25, 0.5, 1, 3, 5, 10, 15, 20 and 30 set, when you want a ring around a point rather than an administrative area.
What is the OnTheMarket API?
OnTheMarket API is a ReefAPI endpoint group for onthemarket It returns live JSON through POST requests under /onthemarket/v1.
Is the OnTheMarket API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. OnTheMarket calls use the same shared credit balance as every other ReefAPI engine.
Do I need an OnTheMarket login or account?
No login to OnTheMarket is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the OnTheMarket data?
The page example is captured from a live location_search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the OnTheMarket API use?
OnTheMarket actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.