API DocsProperty Market Intel
Getting StartedServiced Accommodation
AI & Integrations
Pricing
API Reference
1. Property Identity & Lookup
2. Valuations & Pricing
4. Serviced Accommodation
5. Listings & Sourcing
6. Location Intelligence
7. Environmental & Risk
8. Planning & Regulatory
9. Account & Platform
Free Tier

Get 100 credits free, no card required. Try every endpoint with your own key.

Get a free keyNo credit card · cancel anytime

Rental Yields

GET2 credits
GET/rents/yields

Gross rental yield for an area — `(median annual rent / median asking price) × 100`. Uses IQR-filtered robust statistics.

Overview

Returns overall + breakdown by bedrooms. Uses p5–p95 trimmed statistics to stay robust against outliers — one £10k/mo luxury listing in SW1 won't skew the answer.

Why this endpoint exists

No commercial source exposes yield at postcode granularity. We compute it live from our rental + sales tables.

Query parameters
postcodestringOne of

Full postcode or sector.

outcodestringOne of

District code.

bedroomsintegerOptional

Filter.

property_typestringOptional

Same enum.

Response Schema
location

Location label.

gross_yield_pct

Number — overall gross yield %.

median_rent_pcm

Number (GBP).

average_rent_pcm

Number (GBP).

median_price

Number (GBP).

average_price

Number (GBP).

rent_count

Integer — rental sample size.

sale_count

Integer — sales sample size.

data_quality

"high" | "medium" | "low".

by_bedrooms

Array of { bedrooms, median_rent_pcm, median_price, gross_yield_pct, rent_count, sale_count }.

currency

Always "GBP".

Example

Try this endpoint with your own key

100 free credits, no card required.

Sign up free →

More about this endpoint

Use Cases
1

"Best yields" heatmap or league table in an investor portal.

2

Area shortlisting for BTL buyers.

3

Refinance stress testing.

Base URL: https://pmi-api-beta-7tvvt.ondigitalocean.app/v1API version 1.1