New build homes for sale across the UK, with house builders, schools and stamp duty.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use this for how much someone can borrow for a mortgage and the price that reaches: from household income, deposit and monthly commitments, at the income multiples most lenders use and the higher multiple some offer, with the monthly repayment and a stress test. Give a price to check whether it is within reach.
Gross income a year, all buyers together.
The home is a flat; some lenders lend less on flats.
Two buyers applying together.
A price to check, such as a home’s asking price.
Loans, cards and other monthly debts.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http newhomesearch https://newhomesearch.co.uk/mcp
Use this for how much someone can borrow for a mortgage and the price that reaches: from household income, deposit and monthly commitments, at the income multiples most lenders use and the higher multiple some offer, with the monthly repayment and a stress test. Give a price to check whether it is within reach.
| Argument | Type | Description |
|---|---|---|
| flat | boolean | The home is a flat; some lenders lend less on flats. |
| joint | boolean | Two buyers applying together. |
| price | integer | A price to check, such as a home’s asking price. |
| deposit* | integer | |
| term_years | integer | |
| first_time_buyer | boolean | |
| household_income* | integer | Gross income a year, all buyers together. |
| monthly_commitments | integer | Loans, cards and other monthly debts. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"household_income",
"deposit"
],
"properties": {
"flat": {
"type": "boolean",
"default": false,
"description": "The home is a flat; some lenders lend less on flats."
},
"joint": {
"type": "boolean",
"default": false,
"description": "Two buyers applying together."
},
"price": {
"type": "integer",
"maximum": 50000000,
"minimum": 10000,
"description": "A price to check, such as a home’s asking price."
},
"deposit": {
"type": "integer",
"maximum": 50000000,
"minimum": 0
},
"term_years": {
"type": "integer",
"default": 30,
"maximum": 40,
"minimum": 5
},
"first_time_buyer": {
"type": "boolean",
"default": true
},
"household_income": {
"type": "integer",
"maximum": 10000000,
"minimum": 1000,
"description": "Gross income a year, all buyers together."
},
"monthly_commitments": {
"type": "integer",
"default": 0,
"maximum": 100000,
"minimum": 0,
"description": "Loans, cards and other monthly debts."
}
}
}Use this for what an area is like around a new home, a development or a place: sold house prices nearby, flood and other risks, crime per 1,000 residents against the council, road and rail noise against the WHO guidelines, broadband and full fibre, indoor mobile signal, air quality, the nearest schools with their Ofsted judgement, shops, parks, GP and station distances, walk and transit scores, local pay and jobs, or the journey time by road or on foot to a place (journey_to). Ask only for the measures wanted. Describes places, never who lives there. Schools are held for England only.
| Argument | Type | Description |
|---|---|---|
| home | string | A home or development page address from a search. Give this or place. |
| mode | string | |
| place | string | A town, postcode district or full postcode, when no home is named. |
| measures* | array | |
| journey_to | string | A place to time the journey to from a home: a town, station or postcode. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"measures"
],
"properties": {
"home": {
"type": "string",
"maxLength": 300,
"minLength": 2,
"description": "A home or development page address from a search. Give this or place."
},
"mode": {
"enum": [
"drive",
"walk",
"transit"
],
"type": "string",
"default": "drive"
},
"place": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "A town, postcode district or full postcode, when no home is named."
},
"measures": {
"type": "array",
"items": {
"enum": [
"schools",
"places",
"scores",
"crime",
"noise",
"risks",
"broadband",
"mobile",
"air",
"pay",
"jobs",
"sold_prices"
],
"type": "string"
},
"maxItems": 12,
"minItems": 1
},
"journey_to": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "A place to time the journey to from a home: a town, station or postcode."
}
}
}Use this for the cash needed to buy one home: the deposit, stamp duty or its Scottish or Welsh equivalent, conveyancing, survey and mortgage fees, less the builder's stated cash offers that apply (for a home page address), against savings when given; and for a home, the monthly cost with the service charge and ground rent the builder states. Give a home page address, or a price and nation.
| Argument | Type | Description |
|---|---|---|
| home | string | A home page address from a search: its price, nation and builder offers are used. |
| price | integer | |
| nation | string | Where the home is. Scotland pays LBTT and Wales LTT; England and Northern Ireland stamp duty. |
| survey | boolean | |
| deposit | integer | |
| savings | integer | |
| mortgage | boolean | Buying with a mortgage: mortgage fees are counted. |
| additional_home | boolean | |
| deposit_percent |
Use this for how buying a new build home works: reservation, snagging, warranties such as NHBC, part exchange, completion, stamp duty on new builds, mortgages for new builds, leasehold and service charges, and the data-led articles on new build prices. Search by topic to list guides, or give a guide slug for its full text with today's figures filled, its sources and its questions and answers.
| Argument | Type | Description |
|---|---|---|
| slug | string | A guide, article or explainer slug a previous call listed. |
| topic | string | What the buyer wants to know, in a few words. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"slug": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "A guide, article or explainer slug a previous call listed."
},
"topic": {
"type": "string",
"maxLength": 120,
"minLength": 2,
"description": "What the buyer wants to know, in a few words."
}
}
}Use this for which house builders are selling new homes in a place, with how many developments and homes each has there; or for one builder by name: its developments with homes for sale and prices, when it was founded, its parent group, what it says about itself, and the awards its own website lists. Give a place, a builder, or both.
| Argument | Type | Description |
|---|---|---|
| place | string | A town, city, county, council area, postcode district or full postcode (within 10 miles of it). |
| builder | string | A house builder by name, for example Barratt Homes or Taylor Wimpey. |
| place_option | integer | Which of several places with that name, by the option a previous call returned. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"place": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "A town, city, county, council area, postcode district or full postcode (within 10 miles of it)."
},
"builder": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "A house builder by name, for example Barratt Homes or Taylor Wimpey."
},
"place_option": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Which of several places with that name, by the option a previous call returned."
}
}
}Use this for schools near the new homes for sale in a place: by phase (primary or secondary), Ofsted grade (Outstanding, or good or better), grammar schools and single-sex schools. Each school comes with its Ofsted judgement and date, how many new homes for sale are near it, and its nearest developments; by council groups them for "where are the grammar schools". For the schools nearest one home, use area_facts. England only.
| Argument | Type | Description |
|---|---|---|
| by | string | |
| grade | string | |
| phase | any | |
| place* | string | A town, county or council area. |
| single | any | |
| grammar | boolean | Grammar schools only: secondaries that select by ability. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"place"
],
"properties": {
"by": {
"enum": [
"school",
"council"
],
"type": "string",
"default": "school"
},
"grade": {
"enum": [
"outstanding",
"good_or_better",
"any"
],
"type": "string",
"default": "any"
},
"phase": {
"anyOf": [
{
"enum": [
"primary",
"secondary"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"place": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "A town, county or council area."
},
"single": {
"anyOf": [
{
"enum": [
"boys",
"girls"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"grammar": {
"type": "boolean",
"default": false,
"description": "Grammar schools only: secondaries that select by ability."
}
}
}Use this for one new development: its builder, homes for sale, reserved and coming soon with prices, the house types and their prices, the offers stated, homes that have left with their last prices, and the builder's own words from its brochure and site when asked (query). Name it by the page address a search returned.
| Argument | Type | Description |
|---|---|---|
| query | string | Words to find in the builder's brochure, floor plans and descriptions: 'study', 'EV charger'. |
| development* | string | The page address a search returned (ref), or the full link. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"development"
],
"properties": {
"query": {
"type": "string",
"maxLength": 160,
"minLength": 2,
"description": "Words to find in the builder's brochure, floor plans and descriptions: 'study', 'EV charger'."
},
"development": {
"type": "string",
"maxLength": 300,
"minLength": 2,
"description": "The page address a search returned (ref), or the full link."
}
}
}Use this for the facts of 1 to 6 homes, side by side when more than one: price and its history since first listed, status, rooms, floor area, tenure and lease, service charge and ground rent, council tax band, EPC, parking, expected completion, key features, every offer the builder states, the cash needed to complete, the other plots of the same house type with their prices and those that sold or left, and the area around it. Name homes by the page address a search returned. Say what is not stated rather than guess.
| Argument | Type | Description |
|---|---|---|
| homes* | array |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"homes"
],
"properties": {
"homes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 300,
"minLength": 2,
"description": "The page address a search returned (ref), or the full link."
},
"maxItems": 6,
"minItems": 1
}
}
}Use this for a monthly mortgage payment: on a price and deposit over a term, at the lowest 2 or 5 year fixed rate or tracker published today for that loan to value, the Bank of England average, or a rate given; with the payment after the deal ends, total interest, monthly overpayments and their saving, and the payment if rates rose 1 to 3 points. Repayment or interest only. Give a price, or a home page address.
| Argument | Type | Description |
|---|---|---|
| home | string | A home page address from a search: its price, nation and builder offers are used. |
| rate | string | |
| price | integer | |
| deposit | integer | Deposit in pounds. |
| term_years | integer | |
| interest_only | boolean | |
| my_deal_years | integer | With rate my_rate: years at that rate, 0 for the whole term. |
| deposit_percent | number | Deposit as a percent of the price; 10 when neither is given. |
Use this for current mortgage rates from lenders' own websites, read each night: each product's initial rate, follow-on rate, APRC, maximum loan to value and fees, with a link to the lender; for a price and deposit, the monthly payment and APRC for that loan. Filter by fixed or tracker, deal length, first time buyer or mover, and lender. Recent rate changes too. Listed by lender, not ranked: information, not a recommendation.
| Argument | Type | Description |
|---|---|---|
| type | string | |
| buyer | string | |
| price | integer | |
| years | string | Deal length in years. |
| lender | string | One lender by name, for example Nationwide. |
| changes | boolean | Also list rate changes in the last five weeks. |
| deposit | integer | |
| term_years | integer | |
| deposit_percent | number | 10 when no deposit is given. |
Use this for how a new home’s asking price compares with resale homes nearby: the premium from HM Land Registry sales adjusted by the house price index, with its range, confidence and the sales it rests on, or why no figure is given (Scotland, too few sales, or no measured method yet). At low confidence there is only a range. Give a home page address.
| Argument | Type | Description |
|---|---|---|
| home* | string | A home page address from a search. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"home"
],
"properties": {
"home": {
"type": "string",
"maxLength": 300,
"minLength": 2,
"description": "A home page address from a search."
}
}
}Use this for whether someone qualifies for a government home buying scheme: shared ownership, First Homes, Your First Home, Deposit Unlock, Lifetime ISA, the Mortgage Guarantee Scheme, Rent to Buy, Own New and the closed Help to Buy equity loan. Each scheme comes back likely eligible, possibly eligible (local rules unconfirmed) or not eligible, with the rule that decided it, its source, and the facts still needed. With no facts, it lists every scheme and whether it is open.
| Argument | Type | Description |
|---|---|---|
| ages | array | Each buyer’s age. |
| home | string | A home page address from a search: its price, nation and builder offers are used. |
| price | integer | |
| nation | string | Where the home is. Scotland pays LBTT and Wales LTT; England and Northern Ireland stamp duty. |
| deposit | integer | |
| schemes | array | |
| employed | boolean | |
| key_worker | boolean | |
| with_mortgage |
Use this when someone wants new developments or new build sites in an area, including those coming soon: each development with its builder, "from" price over the homes for sale, homes for sale, reserved and coming soon, bedrooms and types, and its page address. Takes the same filters as search_homes; with filters, each development says how many of its homes match and from what price.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page of results, from 1. |
| sort | string | |
| limit | integer | |
| place | string | Where to search: a town, city, county, council area, postcode district or full postcode. A full postcode searches within 10 miles of it unless within_miles says otherwise. Leave out only to search the whole UK. |
| types | array | house covers every house type; flat includes maisonettes. |
| offers | array | Only homes whose builder states one of these offers, for example part_exchange, stamp_duty_paid or deposit_contribution. |
| builder | string | A house builder, as the buyer named it. |
| include |
Use this when someone wants new build homes, new builds or new homes for sale in a place: by price, bedrooms, house, flat or bungalow, house builder, part exchange or another builder offer, price reductions, or schools nearby. Returns the number of matching homes and developments, the homes on this page (price, status, bedrooms, bathrooms, floor area, tenure, the builder offer, the date each was checked and its page address), and a link to the same search on newhomesearch.co.uk. Only homes for sale today unless include asks for more. New build homes only: not resale homes or rentals.
| Argument | Type | Description |
|---|---|---|
| page | integer | Page of results, from 1. |
| sort | string | |
| limit | integer | |
| place | string | Where to search: a town, city, county, council area, postcode district or full postcode. A full postcode searches within 10 miles of it unless within_miles says otherwise. Leave out only to search the whole UK. |
| types | array | house covers every house type; flat includes maisonettes. |
| offers | array | Only homes whose builder states one of these offers, for example part_exchange, stamp_duty_paid or deposit_contribution. |
| builder | string |
Use this for stamp duty on a home in England or Northern Ireland, LBTT in Scotland or LTT in Wales: the tax band by band for a first time buyer, a home mover or an additional home, with first time buyer relief and where the next band starts. Give a price and a nation, or a home page address.
| Argument | Type | Description |
|---|---|---|
| home | string | A home page address from a search: its price, nation and builder offers are used. |
| price | integer | |
| nation | string | Where the home is. Scotland pays LBTT and Wales LTT; England and Northern Ireland stamp duty. |
| additional_home | boolean | Buying while keeping another home: the higher rates. |
| non_uk_resident | boolean | |
| first_time_buyer | boolean |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"home": {
"type": "string",
"maxLength": 300,
"minLength": 2,
"description": "A home page address from a search: its price, nation and builder offers are used."
},
"price": {
"type": "integer",
"maximum": 50000000,
"minimum": 10000
},
"nation": {
"enum": [
"england",
"northern_ireland",
"scotland",
"wales"
],
"type": "string",
"description": "Where the home is. Scotland pays LBTT and Wales LTT; England and Northern Ireland stamp duty."
},
"additional_home": {
"type": "boolean",
"default": false,
"description": "Buying while keeping another home: the higher rates."
},
"non_uk_resident": {
"type": "boolean",
"default": false
},
"first_time_buyer": {
"type": "boolean",
"default": false
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 12, 2026.
| number |
| 10 when no deposit is given. |
| first_time_buyer | boolean |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"home": {
"type": "string",
"maxLength": 300,
"minLength": 2,
"description": "A home page address from a search: its price, nation and builder offers are used."
},
"price": {
"type": "integer",
"maximum": 50000000,
"minimum": 10000
},
"nation": {
"enum": [
"england",
"northern_ireland",
"scotland",
"wales"
],
"type": "string",
"description": "Where the home is. Scotland pays LBTT and Wales LTT; England and Northern Ireland stamp duty."
},
"survey": {
"type": "boolean",
"default": true
},
"deposit": {
"type": "integer",
"maximum": 50000000,
"minimum": 0
},
"savings": {
"type": "integer",
"maximum": 50000000,
"minimum": 0
},
"mortgage": {
"type": "boolean",
"default": true,
"description": "Buying with a mortgage: mortgage fees are counted."
},
"additional_home": {
"type": "boolean",
"default": false
},
"deposit_percent": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "10 when no deposit is given."
},
"first_time_buyer": {
"type": "boolean",
"default": false
}
}
}| my_rate_percent |
| number |
| With rate my_rate: the interest rate. |
| overpay_monthly | integer |
| my_follow_on_percent | number |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"home": {
"type": "string",
"maxLength": 300,
"minLength": 2,
"description": "A home page address from a search: its price, nation and builder offers are used."
},
"rate": {
"enum": [
"lowest_2_year_fixed",
"lowest_5_year_fixed",
"lowest_tracker",
"bank_of_england_average",
"my_rate"
],
"type": "string",
"default": "lowest_2_year_fixed"
},
"price": {
"type": "integer",
"maximum": 50000000,
"minimum": 10000
},
"deposit": {
"type": "integer",
"maximum": 50000000,
"minimum": 0,
"description": "Deposit in pounds."
},
"term_years": {
"type": "integer",
"default": 25,
"maximum": 40,
"minimum": 5
},
"interest_only": {
"type": "boolean",
"default": false
},
"my_deal_years": {
"type": "integer",
"default": 0,
"maximum": 10,
"minimum": 0,
"description": "With rate my_rate: years at that rate, 0 for the whole term."
},
"deposit_percent": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Deposit as a percent of the price; 10 when neither is given."
},
"my_rate_percent": {
"type": "number",
"maximum": 20,
"minimum": 0.1,
"description": "With rate my_rate: the interest rate."
},
"overpay_monthly": {
"type": "integer",
"default": 0,
"maximum": 100000,
"minimum": 0
},
"my_follow_on_percent": {
"type": "number",
"maximum": 20,
"minimum": 0.1
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"type": {
"enum": [
"any",
"fixed",
"tracker"
],
"type": "string",
"default": "any"
},
"buyer": {
"enum": [
"first_time_buyer",
"home_mover"
],
"type": "string",
"default": "first_time_buyer"
},
"price": {
"type": "integer",
"maximum": 50000000,
"minimum": 10000
},
"years": {
"enum": [
"2",
"3",
"5",
"10",
"any"
],
"type": "string",
"default": "any",
"description": "Deal length in years."
},
"lender": {
"type": "string",
"maxLength": 60,
"minLength": 2,
"description": "One lender by name, for example Nationwide."
},
"changes": {
"type": "boolean",
"default": false,
"description": "Also list rate changes in the last five weeks."
},
"deposit": {
"type": "integer",
"maximum": 50000000,
"minimum": 0
},
"term_years": {
"type": "integer",
"default": 25,
"maximum": 40,
"minimum": 5
},
"deposit_percent": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "10 when no deposit is given."
}
}
}| boolean |
| owns_a_home_now | boolean |
| first_time_buyer | boolean |
| household_income | integer |
| in_greater_london | boolean |
| lifetime_isa_first_payment | string | The date of the first payment into a Lifetime ISA, if one is held. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"ages": {
"type": "array",
"items": {
"type": "integer",
"maximum": 110,
"minimum": 16
},
"maxItems": 4,
"minItems": 1,
"description": "Each buyer’s age."
},
"home": {
"type": "string",
"maxLength": 300,
"minLength": 2,
"description": "A home page address from a search: its price, nation and builder offers are used."
},
"price": {
"type": "integer",
"maximum": 50000000,
"minimum": 10000
},
"nation": {
"enum": [
"england",
"northern_ireland",
"scotland",
"wales"
],
"type": "string",
"description": "Where the home is. Scotland pays LBTT and Wales LTT; England and Northern Ireland stamp duty."
},
"deposit": {
"type": "integer",
"maximum": 50000000,
"minimum": 0
},
"schemes": {
"type": "array",
"items": {
"enum": [
"first_homes",
"shared_ownership",
"rent_to_buy",
"lifetime_isa",
"mortgage_guarantee",
"own_new_rate_reducer",
"deposit_unlock",
"help_to_buy_equity_loan",
"your_first_home"
],
"type": "string"
},
"maxItems": 9
},
"employed": {
"type": "boolean"
},
"key_worker": {
"type": "boolean"
},
"with_mortgage": {
"type": "boolean"
},
"owns_a_home_now": {
"type": "boolean"
},
"first_time_buyer": {
"type": "boolean"
},
"household_income": {
"type": "integer",
"maximum": 10000000,
"minimum": 0
},
"in_greater_london": {
"type": "boolean"
},
"lifetime_isa_first_payment": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "The date of the first payment into a Lifetime ISA, if one is held."
}
}
}| array |
| Also show homes in these states. By default only homes for sale today are shown. |
| reduced | boolean | Only homes reduced in price since first listed. |
| schools | array | Only homes within reach of at least one school of each kind asked: kind any, primary, secondary, grammar or independent; grade outstanding or good; results top10, top25 or above (DfE results against England). England only. |
| any_offer | boolean | Only homes with an offer of any kind. |
| max_price | integer |
| min_price | integer |
| max_bedrooms | integer |
| min_bedrooms | integer | 0 is a studio. |
| place_option | integer | Which of several places with that name, by the option number a previous call returned. |
| within_miles | integer | Search within this many miles of the place rather than inside its boundary. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 50,
"minimum": 1,
"description": "Page of results, from 1."
},
"sort": {
"enum": [
"recommended",
"price_low",
"price_high",
"newest"
],
"type": "string",
"default": "recommended"
},
"limit": {
"type": "integer",
"default": 6,
"maximum": 12,
"minimum": 1
},
"place": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Where to search: a town, city, county, council area, postcode district or full postcode. A full postcode searches within 10 miles of it unless within_miles says otherwise. Leave out only to search the whole UK."
},
"types": {
"type": "array",
"items": {
"enum": [
"house",
"detached",
"semi_detached",
"terraced",
"town_house",
"bungalow",
"flat"
],
"type": "string"
},
"maxItems": 7,
"description": "house covers every house type; flat includes maisonettes."
},
"offers": {
"type": "array",
"items": {
"enum": [
"deposit_contribution",
"mortgage_contribution",
"stamp_duty_paid",
"cashback",
"legal_fees",
"moving_costs",
"flooring",
"kitchen_upgrade",
"appliances",
"landscaping",
"part_exchange",
"assisted_move",
"rate_reducer",
"key_worker_discount",
"other"
],
"type": "string"
},
"maxItems": 15,
"description": "Only homes whose builder states one of these offers, for example part_exchange, stamp_duty_paid or deposit_contribution."
},
"builder": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "A house builder, as the buyer named it."
},
"include": {
"type": "array",
"items": {
"enum": [
"coming_soon",
"reserved",
"sold_stc"
],
"type": "string"
},
"maxItems": 3,
"description": "Also show homes in these states. By default only homes for sale today are shown."
},
"reduced": {
"type": "boolean",
"description": "Only homes reduced in price since first listed."
},
"schools": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"any",
"primary",
"secondary",
"grammar",
"independent"
],
"type": "string"
},
"faith": {
"anyOf": [
{
"enum": [
"catholic",
"church_of_england",
"christian",
"jewish",
"muslim",
"sikh",
"hindu",
"any"
],
"type": "string"
},
{
"type": "null"
}
]
},
"grade": {
"anyOf": [
{
"enum": [
"outstanding",
"good"
],
"type": "string"
},
{
"type": "null"
}
]
},
"single": {
"anyOf": [
{
"enum": [
"boys",
"girls"
],
"type": "string"
},
{
"type": "null"
}
]
},
"results": {
"anyOf": [
{
"enum": [
"top10",
"top25",
"above"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
}
},
"maxItems": 4,
"description": "Only homes within reach of at least one school of each kind asked: kind any, primary, secondary, grammar or independent; grade outstanding or good; results top10, top25 or above (DfE results against England). England only."
},
"any_offer": {
"type": "boolean",
"description": "Only homes with an offer of any kind."
},
"max_price": {
"type": "integer",
"maximum": 50000000,
"minimum": 10000
},
"min_price": {
"type": "integer",
"maximum": 50000000,
"minimum": 0
},
"max_bedrooms": {
"type": "integer",
"maximum": 10,
"minimum": 0
},
"min_bedrooms": {
"type": "integer",
"maximum": 10,
"minimum": 0,
"description": "0 is a studio."
},
"place_option": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Which of several places with that name, by the option number a previous call returned."
},
"within_miles": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Search within this many miles of the place rather than inside its boundary."
}
}
}| A house builder, as the buyer named it. |
| include | array | Also show homes in these states. By default only homes for sale today are shown. |
| reduced | boolean | Only homes reduced in price since first listed. |
| schools | array | Only homes within reach of at least one school of each kind asked: kind any, primary, secondary, grammar or independent; grade outstanding or good; results top10, top25 or above (DfE results against England). England only. |
| any_offer | boolean | Only homes with an offer of any kind. |
| max_price | integer |
| min_price | integer |
| max_bedrooms | integer |
| min_bedrooms | integer | 0 is a studio. |
| place_option | integer | Which of several places with that name, by the option number a previous call returned. |
| within_miles | integer | Search within this many miles of the place rather than inside its boundary. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"default": 1,
"maximum": 50,
"minimum": 1,
"description": "Page of results, from 1."
},
"sort": {
"enum": [
"recommended",
"price_low",
"price_high",
"newest",
"most_bedrooms",
"biggest_reduction"
],
"type": "string",
"default": "recommended"
},
"limit": {
"type": "integer",
"default": 6,
"maximum": 12,
"minimum": 1
},
"place": {
"type": "string",
"maxLength": 120,
"minLength": 1,
"description": "Where to search: a town, city, county, council area, postcode district or full postcode. A full postcode searches within 10 miles of it unless within_miles says otherwise. Leave out only to search the whole UK."
},
"types": {
"type": "array",
"items": {
"enum": [
"house",
"detached",
"semi_detached",
"terraced",
"town_house",
"bungalow",
"flat"
],
"type": "string"
},
"maxItems": 7,
"description": "house covers every house type; flat includes maisonettes."
},
"offers": {
"type": "array",
"items": {
"enum": [
"deposit_contribution",
"mortgage_contribution",
"stamp_duty_paid",
"cashback",
"legal_fees",
"moving_costs",
"flooring",
"kitchen_upgrade",
"appliances",
"landscaping",
"part_exchange",
"assisted_move",
"rate_reducer",
"key_worker_discount",
"other"
],
"type": "string"
},
"maxItems": 15,
"description": "Only homes whose builder states one of these offers, for example part_exchange, stamp_duty_paid or deposit_contribution."
},
"builder": {
"type": "string",
"maxLength": 80,
"minLength": 2,
"description": "A house builder, as the buyer named it."
},
"include": {
"type": "array",
"items": {
"enum": [
"coming_soon",
"reserved",
"sold_stc"
],
"type": "string"
},
"maxItems": 3,
"description": "Also show homes in these states. By default only homes for sale today are shown."
},
"reduced": {
"type": "boolean",
"description": "Only homes reduced in price since first listed."
},
"schools": {
"type": "array",
"items": {
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"enum": [
"any",
"primary",
"secondary",
"grammar",
"independent"
],
"type": "string"
},
"faith": {
"anyOf": [
{
"enum": [
"catholic",
"church_of_england",
"christian",
"jewish",
"muslim",
"sikh",
"hindu",
"any"
],
"type": "string"
},
{
"type": "null"
}
]
},
"grade": {
"anyOf": [
{
"enum": [
"outstanding",
"good"
],
"type": "string"
},
{
"type": "null"
}
]
},
"single": {
"anyOf": [
{
"enum": [
"boys",
"girls"
],
"type": "string"
},
{
"type": "null"
}
]
},
"results": {
"anyOf": [
{
"enum": [
"top10",
"top25",
"above"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
}
}
},
"maxItems": 4,
"description": "Only homes within reach of at least one school of each kind asked: kind any, primary, secondary, grammar or independent; grade outstanding or good; results top10, top25 or above (DfE results against England). England only."
},
"any_offer": {
"type": "boolean",
"description": "Only homes with an offer of any kind."
},
"max_price": {
"type": "integer",
"maximum": 50000000,
"minimum": 10000
},
"min_price": {
"type": "integer",
"maximum": 50000000,
"minimum": 0
},
"max_bedrooms": {
"type": "integer",
"maximum": 10,
"minimum": 0
},
"min_bedrooms": {
"type": "integer",
"maximum": 10,
"minimum": 0,
"description": "0 is a studio."
},
"place_option": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Which of several places with that name, by the option number a previous call returned."
},
"within_miles": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Search within this many miles of the place rather than inside its boundary."
}
}
}