Getting started

Your first property API call
in a few minutes

Sign up, grab a key, and query UK property data over plain REST. Every plan includes all 46 APIs, the MCP server and ChatGPT Actions.

REST JSONx-api-key auth46 APIsMCP + ChatGPT

Three steps

From sign-up to first response

1

Start your free trial

Create an account to start a 14-day free trial with 500 test API credits. A card is required to start.

Start free trial
2

Get your API key

Your key is on the dashboard the moment you sign in. Send it in the x-api-key header on every request.

x-api-key: YOUR_API_KEY
3

Make your first call

Point any HTTP client at the base URL below. Structured JSON comes back ready to use.

https://propertyinsights.co.uk/api/v1
GET/api/v1/council-tax/lookup?postcode=S11+8YL
curl "https://propertyinsights.co.uk/api/v1/council-tax/lookup?postcode=S11%208YL" \
  -H "x-api-key: YOUR_API_KEY"
const res = await fetch(
  "https://propertyinsights.co.uk/api/v1/council-tax/lookup?postcode=S11%208YL",
  { headers: { "x-api-key": process.env.PI_API_KEY } }
);
const data = await res.json();

The essentials

What you need to know

Base URL

All 46 APIs live under one base.

https://propertyinsights.co.uk/api/v1

Authentication

Send your key in the x-api-key request header. No OAuth, no SDK required.

Credits

Most calls cost 1 credit. Address autocomplete suggestions are free, successful UPRN lookups cost 35 credits, and weighted property reports publish their full cost in the API Hub. Successful responses report billing.creditsCharged, billing.creditsRemaining and billing.creditsRefreshAt. Matching X-Credits-* headers are also available to clients.

Rate limits

Every successful response returns X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset. Over the limit you get a 429.

OpenAPI spec

Generate a typed client in your language from the OpenAPI schema, or use any HTTP client you already have.

Errors

Predictable JSON errors with a status code and message. A missing key returns 401, a bad request returns 400.

Agent ready

Call the data from your AI agent

The same API key works across the REST API, our MCP server and ChatGPT Actions, so agents can call every endpoint as a typed tool.

mcp.propertyinsights.co.uk
# Claude Code
claude mcp add property-insights \
  https://mcp.propertyinsights.co.uk/mcp

Reference

Every API, fully documented

Jump straight into any endpoint. Each guide has parameters, response schema, worked examples and error handling.

Property intelligence

Ready to make your first call?

Start a 14-day free trial with 500 test API credits and build straight away.