OnTheMarket API

OnTheMarket API for UK Property Search, Listing Details, and Estate-Agent Data

Scrappa's OnTheMarket API returns structured JSON from OnTheMarket, a UK property portal. Search homes for sale or to rent by location, price, bedrooms and property type, open any listing for its price, tenure, description, images, floorplans, EPC, broadband, stations, schools and agent, and read an estate-agent branch profile with its current inventory. Scrappa is an independent service and is not affiliated with or endorsed by OnTheMarket.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
4
Endpoints
15
Search filters
$0.20
Per 1k requests

Try it now

Make one request. Inspect structured JSON.

Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.

Request preview
Request
curl -X GET "https://scrappa.co/api/onthemarket/search?search_type=for-sale&location_id=nottingham" \
  -H "Accept: application/json" \
  -H "X-API-KEY: YOUR_API_KEY"
JSON response
{
  "success": true,
  "data": {
    "search_metadata": {
      "page": 1,
      "frame_size": 30,
      "total_results": 3049,
      "total_results_display": "3,049",
      "has_more": true,
      "last_page": 34,
      "sort_field": "recommended",
      "direction": "desc",
      "search_type": "for-sale",
      "location_id": "nottingham",
      "location_type": "town",
      "location_name": "Nottingham"
    },
    "listings": [
      {
        "id": "20035804",
        "property_title": "2 bedroom bungalow for sale",
        "price": "£275,000",
        "price_value": 275000,
        "bedrooms": 2,
        "bathrooms": 1,
        "address": "Marshall Road, Nottingham, Nottinghamshire, NG3",
        "postcode": "NG3",
        "features": ["Tenure: Freehold", "Detached Bungalow", "Two Bedrooms"],
        "tenure": "Freehold",
        "location": { "lat": 52.977144, "lon": -1.115554 },
        "images_count": 17,
        "property_url": "https://www.onthemarket.com/details/20035804/",
        "agent": { "branch_id": 73818, "name": "Frank Innes - Mapperley", "telephone": "0115 691 4648" }
      }
    ]
  },
  "meta": { "endpoint_family": "search", "billable": true }
}

What you can build

Structured data for real applications. Here are some ideas.

UK Property Price Analysis

Track asking prices by location, property type and bedroom count with numeric GBP price values.

Estate-Agent Coverage

Read any branch profile and page through its current sale and rent inventory.

Listing Monitoring

Follow new and reduced listings by location and surface EPC, floorplan and image data.

Cross-Portal Comparison

Combine OnTheMarket with Zoopla and Rightmove to compare the same UK market.

Investment Screening

Filter by price and bedrooms, then read tenure, area price statistics and crime levels.

OnTheMarket scraper API

OnTheMarket API for UK property listings, prices, and estate agents

The OnTheMarket API is built for property analytics, proptech tools, and home-search features. Each search card includes the id, title, display price with a numeric GBP value, bedrooms, bathrooms, address, images and the branch summary. Listing detail adds the description as html and plain text, tenure, key facts, floorplans, EPC rating, broadband speeds, nearest stations and schools, room sizes, area price statistics and similar properties. Agent branches add the address, telephone, logo, socials and their featured sale and rent listings.

Search for-sale or to-rent listings by location, price, bedrooms, property type and radius with sorting and pagination.

Open any listing for price, tenure, description, images, floorplans, EPC, broadband, stations, schools and the agent.

Read an estate-agent branch profile with contact details, socials and featured listings.

Page through one branch's current sale or rent inventory.

Unknown ids and slugs answer a non-billed 404 and are never charged.

Choose the right OnTheMarket API endpoint

Use Property Search for market coverage

Combine location, price, bedroom and property-type filters to collect matching listings with numeric GBP prices and live paging metadata.

Open OnTheMarket Search API docs

Use Listing Details for full property records

Open a listing by id for its description, tenure, key facts, images, floorplans, EPC, broadband, stations, schools, rooms, area statistics and agent.

Open OnTheMarket Listing API docs

Use the agent endpoints for branch coverage

Read a branch profile and page through its current inventory to follow one agency's stock across a market.

Open OnTheMarket Agent Listings API docs

Available endpoints

Everything you need in one API.

GET

Listing Details

/api/onthemarket/listing

Get one property listing with price, tenure, description, images, EPC and agent

Scrappa vs ScrapingBee / ScraperAPI

See how Scrappa compares to the official API.

OnTheMarket listing data as JSON
Scrappa:
ScrapingBee / ScraperAPI: Build your own parser
Search filter vocabulary
Scrappa: 15 filters
ScrapingBee / ScraperAPI: Parse it yourself
Agent branch profiling
Scrappa:
ScrapingBee / ScraperAPI:
Price per 1k requests
Scrappa: From $0.20
ScrapingBee / ScraperAPI: Varies by credits per request
Unified API key
Scrappa: Yes (80+ APIs)
ScrapingBee / ScraperAPI: Scraping only
Free tier
Scrappa: 500 credits/month
ScrapingBee / ScraperAPI: Trial credits

Key features

UK for-sale and to-rent property search with location, price, bedroom, property-type and radius filters
Numeric GBP price values alongside the display price string
Full listing details with description as html and plain text, tenure, key facts, images and floorplans
EPC rating, broadband speeds, nearest stations and schools, room sizes and area price statistics
Estate-agent branch profiles with contact details, logo, socials and featured listings
Unknown ids and slugs answer a non-billed 404 and are never charged

Frequently asked questions

No. Scrappa is an independent service and is not affiliated with or endorsed by OnTheMarket. The OnTheMarket API returns structured JSON from current public listings through a Scrappa API key.

Every Scrappa account includes 500 free credits each month. After that, each request costs one credit, which works out to $0.20 to $0.30 per 1,000 requests depending on the credit pack or plan. Failed requests are never charged.

Use the one-based page parameter. OnTheMarket returns 30 listings per page and surfaces at most 34 pages per search, so total_results is a cap rather than an exact count. has_more is true while more pages exist, and a valid empty result is a successful response.

Pass a location slug such as nottingham, london or manchester. The slug is resolved by OnTheMarket and an unknown location answers a non-billed 404.

Start using the OnTheMarket API

Sign up and get 500 free credits. No credit card required.