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.
Three steps
From sign-up to first response
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 trialGet 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_KEYMake your first call
Point any HTTP client at the base URL below. Structured JSON comes back ready to use.
https://propertyinsights.co.uk/api/v1curl "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/v1Authentication
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.
# Claude Code
claude mcp add property-insights \
https://mcp.propertyinsights.co.uk/mcpReference
Every API, fully documented
Jump straight into any endpoint. Each guide has parameters, response schema, worked examples and error handling.
Address and identity
Property intelligence
Market and ownership
Area and location
Finance and economy
Ready to make your first call?
Start a 14-day free trial with 500 test API credits and build straight away.