OpenAI logo

OpenAI

ChatGPT Actions Setup

Custom GPT Actions 46 EndpointsAPI Key Auth

Empower ChatGPT with Live Property Data

Build a custom GPT agent that can query live UK property valuations, sold prices, crime stats, school data, and more through natural conversation.

Prerequisites

ChatGPT Plus Active

Custom GPTs with Actions require a paid ChatGPT subscription (Plus, Team, or Enterprise).

API Key Ready

You need an active key from your dashboard. Calls use the documented endpoint price, and each action response reports its billing result.

Supercharge your Conversations

Transform ChatGPT into a powerhouse property analyst.

Natural Language

Ask about any UK property, postcode, or area using plain English. The GPT automatically formats and executes the optimal API calls.

Real-Time Data

Bypass outdated training data. Access live valuations, recent sold prices, current mortgage rates, and the latest EPC ratings instantly.

Deep Analysis

Let ChatGPT do the heavy lifting. It interprets complex data sets, compares investment options, and synthesises nuanced property insights.

Quick Configuration

Follow these steps to wire up your Custom GPT.

1

Initialize new GPT

Navigate to chatgpt.com/gpts/mine and select Create a GPT.

2

Basic Configuration

In the Configure tab, set up the identity:

Name: UK Property Analyst
Description: Expert assistant powered by live UK property data APIs.
3

System Instructions

Paste this core instruction set to define endpoint behaviors.

System Prompt
You are a UK property research assistant. You have access to the Property Insights API Hub which provides live data about UK properties, areas, and markets.

When a user asks about a property, postcode, or area, use the appropriate API action to fetch real data before answering. Always prefer live data over your training knowledge for property-specific questions.

Available actions and when to use them:

- property_analysis: Analyse a property by postcode with price, type, bedrooms, and floor area. Use when someone asks about a specific property listing.
- property_valuation: Get an estimated property value by postcode and address. Use when someone asks "how much is X worth?" or "what's the value of...".
- property_sold_comparables: Find comparable sold properties near a postcode. Use for "what have similar properties sold for?" questions.
- property_sold_prices: Search sold prices by postcode with filters for radius, bedrooms, type, and price range. Use for broader sold price research.
- area_sold_prices: Get complete sold price history for a postcode area or inferred area from a postcode. Use for street- and area-level transaction history.
- sdlt_calculate: Calculate stamp duty land tax. Use when someone asks about stamp duty, SDLT, or tax on a property purchase.
- council_tax_lookup: Look up council tax bands and costs by postcode, optionally for a specific tax year.
- council_tax_property_lookup: Look up council tax for a specific property by postcode and address, optionally for a specific tax year.
- council_tax_authorities: Search billing authorities when the user knows the council name but not the postcode.
- council_tax_authority_lookup: Get council tax rates for a billing authority and tax year. Use this for authority-level lookups and Welsh band I responses.
- epc_search: Search latest EPC (Energy Performance Certificate) ratings by postcode/address or UPRN.
- crime_by_postcode: Get crime statistics for an area by postcode with configurable time range.
- company_ownership_search: Search for property company ownership records.
- area_statistics: Get demographic and area statistics for a postcode.
- schools_search: Search for schools near a postcode with filters for phase, Ofsted rating, and type.
- hpi: Query the UK House Price Index by region with date ranges, property types, and metrics.
- floor_area_lookup: Look up the interior floor area of a property.
- mortgage_rates: Get current mortgage rate data filtered by term and LTV.
- bank_rates: Get Bank of England base rate history.
- inflation_rates: Get UK inflation rate history.
- property_renovation_uplift_calculator: Estimate the value uplift from renovations and extensions.

Guidelines:
- Always include the postcode when calling property or area endpoints.
- If the user only knows the council or local authority, use the council tax authority search and authority lookup actions instead of asking for a postcode first.
- Format currency values with pound signs and commas (e.g. £450,000).
- When comparing areas, make multiple API calls to gather data for each location.
- If an API call returns an error, explain the issue clearly and suggest what the user can try differently.
- Present data in a clear, structured way using tables or bullet points where appropriate.
4

Add API Action

Under Actions, click Create new action. Set up Authentication (gear icon):

  • Auth Type API Key
  • API Key Your Key Here
  • Auth Type Custom
  • Header Name x-api-key
5

Import Schema

In the Schema box, click Import from URL and paste the OpenAPI JSON:

https://propertyinsights.co.uk/api/v1/openapi.json
Open JSONThis schema is generated from the same 46-tool catalog used by our MCP server.

Try these prompts

Copy and paste these directly into your configured GPT.

Valuations & Prices

"What's the estimated value of a 3-bed semi in BS5 6LA?"
Fetching valuation for BS5 6LA...
The estimated value is £365,000 (Confidence: High).
"Compare sold prices for detached houses in LS1 vs LS6 over the last 2 years."

Due Diligence

"What's the crime rate like around E1 6AN compared to national averages?"
"Find the EPC rating and potential improvements for 10 Downing Street, SW1A 2AA."
Found EPC Record: Current Rating E (45). Potential Rating C (72).

Investment Analysis

"Calculate stamp duty on a £450k buy-to-let purchase."
"Estimate the renovation uplift for adding a 15sqm extension to a £300k property in Bristol."

46 Live Endpoints

Every API available directly within your chat.

OpenAPI v3.1 Compliant
Property Analysis
Valuation
Sold Prices
Area Sold Prices
Comparables
Stamp Duty
Council Tax Lookup
Council Tax Property Lookup
Council Tax Authorities
Council Tax Authority Lookup
EPC Search
Crime Rates
Company Ownership
Area Stats
Schools Search
House Price Index
Floor Area Lookup
Mortgage Rates
Bank Rates
Inflation Rates
Renovation Uplift

Common Questions

Does this use my API credits?

Yes. Every time ChatGPT calls an endpoint, it uses that endpoint's documented credit price. The action response includes billing.creditsCharged, billing.creditsRemaining and billing.creditsRefreshAt.

Can I share my custom GPT?

You can, but users will be making API calls with your key and consuming your credits. Use caution if sharing publicly.

Can I use this with Claude?

Yes! For Claude, Cursor, and other compatible AI tools, we recommend using our dedicated MCP server instead of OpenAPI actions.

Is the data UK-only?

Yes. Property Insights is UK-focused. Coverage varies by dataset: council tax covers England, Wales, and Scotland, while some other datasets remain England-and-Wales-first.

Deploy your AI Analyst

Get your API key and have your custom property intelligence GPT running in under five minutes.