Public API Documentation

Access UK property & land data programmatically. All endpoints return JSON. No authentication required.

Base URL https://deedinsight.co.uk/api

Get Title Detail

GET /api/titles/{title_number}

Returns the title's tenure, district, addresses, proprietors (with overseas / Companies House cross-links where available), and recent PPD sales at the same postcode.

Example
curl "https://deedinsight.co.uk/api/titles/CYM566831"

Properties by Proprietor Name

GET /api/proprietors/by-name/{name}

List every title held by a proprietor name (URL-encoded, exact match).

ParameterTypeDescription
pageintPage number (default: 1)
Example
curl "https://deedinsight.co.uk/api/proprietors/by-name/STONEGATE%20PUB%20COMPANY%20LIMITED"

Properties by Companies House Number

GET /api/proprietors/by-company/{company_number}

List every title held by a specific Companies House company. The bridge from Firm Insight — used by its company pages to surface a "this company owns N properties" badge.

Example
curl "https://deedinsight.co.uk/api/proprietors/by-company/07465254"

Search Sales (Price Paid Data)

GET /api/transactions

All filters are optional. Prices are integers in pence.

ParameterTypeDescription
postcodestringPostcode (full or prefix)
townstringTown name (exact)
min_priceintMinimum price in pence
from_dateYYYY-MM-DDEarliest transfer date
to_dateYYYY-MM-DDLatest transfer date
pageintPage number (default: 1)
limitintResults per page (1-100, default: 25)
Example
curl "https://deedinsight.co.uk/api/transactions?town=OXFORD&min_price=100000000&from_date=2024-01-01"

Reports

GET /api/reports/{report}

Reports: recent-sales, biggest-sales, new-titles, overseas-owners, top-owners. 15 items per page; max 500 pages (newest 7,500 items).

ParameterTypeDescription
pageintPage number (default: 1, max: 500)
Example
curl "https://deedinsight.co.uk/api/reports/biggest-sales?page=1"

Cross-Site Bridge

GET /api/cross/company/{company_number}

How many UK titles a Companies House company owns, plus a sample. Designed to be called from Firm Insight so company pages can surface property holdings.

Example
curl "https://deedinsight.co.uk/api/cross/company/07465254"

Health

GET /api/health

Liveness probe. Returns {"status":"ok"}.

Rate Limits

120 requests/minute per source IP. Hits above the cap return HTTP 429. If you need higher volume, get in touch at [email protected].

MCP Server

We also provide an MCP (Model Context Protocol) server for use with AI assistants like Claude. View MCP documentation →