API Documentation

Hotpostcodes API is available on rapidapi.com. For direct access, we do provide temporary free API keys for a limited quota at our discretion. You can apply for a free API key through our contact form. Our endpoints will then be accessible on https://hotpostcodes.com?postcode=DE24+9ER&key=your_api_key

/api/v1/summary

Returns a quick overview of the postcode including county, elevation, total sales, and average price.

{ "postcode": "DE24 9ER", "status": "success", "response_code": "16.26.19950829.20180504", "data": { "geo-location": "52.879024,-1.447681", "elevation": 50, "streets": [ "Weston Park Avenue" ], "towns": [ "City Of Derby", "Derby" ], "properties": 16, "sales": 26, "activity_level": 1.62, "roi_average": 5.79, "ceiling_price": 1389606 }, "@copyright": "Contains HM Land Registry data © Crown copyright and database right 2025. This data is licensed under the Open Government Licence v3.0. Link: https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/" } }

/api/v1/prices

Returns average and median property prices by type (flat, terraced, etc) per year.

{ "postcode": "DE24 9ER", "status": "success", "response_code": "16.26.19950829.20180504", "data": { "average_price": { "detached": 490371, "semi_detached": 211486, "terraced": 0, "flat": 0 }, "median_price": { "detached": 272192, "semi_detached": 213318, "terraced": 0, "flat": 0 }, "standard_deviation": { "detached": 502963.3, "semi_detached": 27887.88, "terraced": 0, "flat": 0 }, "ceiling": { "detached": { "ceiling_price": 1389606, "ceiling_date": "2025-03", "full_address": "61A, Weston Park Avenue, Derby, City Of Derby, Shelton Lock, DE24 9ER" }, "semi_detached": { "ceiling_price": 252507, "ceiling_date": "2025-03", "full_address": "33, Weston Park Avenue, Derby, City Of Derby, Shelton Lock, DE24 9ER" }, "terraced": { "full_address": null, "ceiling_date": 0, "ceiling_price": 0 }, "flat": { "full_address": null, "ceiling_date": 0, "ceiling_price": 0 } }, "highest_sold": { "detached": { "full_address": "61A, Weston Park Avenue, Derby, City Of Derby, Shelton Lock, DE24 9ER", "price_sold": 996434, "date_sold": "2016-07-22" }, "semi_detached": { "full_address": "29, Weston Park Avenue, Derby, City Of Derby, Shelton Lock, DE24 9ER", "price_sold": 205000, "date_sold": "2021-12-21" }, "terraced": { "full_address": null, "price_sold": 0, "date_sold": null }, "flat": { "full_address": null, "price_sold": 0, "date_sold": null }, "non_residential": { "full_address": null, "price_sold": 0, "date_sold": null } } }, "@copyright": "Contains HM Land Registry data © Crown copyright and database right 2025. This data is licensed under the Open Government Licence v3.0. Link: https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/" }

/api/v1/roi

Returns estimated rental yield, ROI, and average rent based on recent sales data.

{ "postcode": "DE24 9ER", "status": "success", "response_code": "16.26.19950829.20180504", "data": { "bytype": { "detached": 7.46, "semi_detached": 4.11, "terraced": 0, "flat": 0, "non_residential": 0, "sample_size": { "detached": 4, "semi_detached": 3, "terraced": 0, "flat": 0, "non_residential": 0 }, "average": 5.79 } }, "@copyright": "Contains HM Land Registry data © Crown copyright and database right 2025. This data is licensed under the Open Government Licence v3.0. Link: https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/" }

/api/v1/comparison

Compares prices and sales volume with nearby postcodes.

{ "postcode": "EX2 6AG", "nearby": [ { "postcode": "EX2 6AE", "avg_price": 260000 }, { "postcode": "EX2 6AJ", "avg_price": 250000 } ] }

/api/v1/sales

Returns number of sales per year and property type since 1995.

{ "postcode": "DE24 9ER", "status": "success", "response_code": "16.26.19950829.20180504", "data": { "breakdown": { "detached": 5, "semi_detached": 11, "terraced": 0, "flat": 0, "non_residential": 0, "total": 16 } }, "@copyright": "Contains HM Land Registry data © Crown copyright and database right 2025. This data is licensed under the Open Government Licence v3.0. Link: https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/" }

/api/v1/saleshistory

Returns full sales history for a postcode including date, price, type and address.

{ "postcode": "DE24 9ER", "status": "success", "response_code": "16.26.19950829.20180504", "data": { "properties": 16, "sales": 26, "history": [ { "full_address": "1, Weston Park Avenue, Derby, City Of Derby, Shelton Lock, DE24 9ER", "property_type": "S", "sales_history": [ { "TransferDate": "1999-08-16", "Price": 39000 } ], "number_of_sales": 1, "annual_profit_gbp": [], "estimated_sale_annual_profit": 4887, "estimated_value": { "date": "2025-03", "price": 186047 }, "linear_prediction": { "2025": 193294, "2026": 198736, "2027": 204178, "2028": 209619, "2029": 215061 }, "roi_average": 0 }, { "full_address": "5, Weston Park Avenue, Derby, City Of Derby, Shelton Lock, DE24 9ER", "property_type": "S", "sales_history": [ { "TransferDate": "2016-11-09", "Price": 147000 } ], "number_of_sales": 1, "annual_profit_gbp": [], "estimated_sale_annual_profit": 5610, "estimated_value": { "date": "2025-03", "price": 213318 }, "linear_prediction": { "2025": 221897, "2026": 228161, "2027": 234424, "2028": 240687, "2029": 246950 }, "roi_average": 0 }, { "full_address": "7, Weston Park Avenue, Derby, City Of Derby, Shelton Lock, DE24 9ER", "property_type": "S", "sales_history": [ { "TransferDate": "2017-09-18", "Price": 124950 } ], "number_of_sales": 1, "annual_profit_gbp": [], "estimated_sale_annual_profit": 4658, "estimated_value": { "date": "2025-03", "price": 177074 }, "linear_prediction": { "2025": 184201, "2026": 189403, "2027": 194605, "2028": 199807, "2029": 205009 }, "roi_average": 0 } ] }, "@copyright": "Contains HM Land Registry data © Crown copyright and database right 2025. This data is licensed under the Open Government Licence v3.0. Link: https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/" }

/api/v1/breakdown_lists

Breakdown by bedroom count, lease type, and whether the property is a new build.

{ "postcode": "DE24 9ER", "status": "success", "response_code": "16.26.19950829.20180504", "data": { "roi": { "detached": [ 1.24, 18.58, 3.46, 6.58 ], "semi_detached": [ 5.53, 2.46, 4.35 ], "terraced": [], "flat": [], "non_residential": [] }, "prices": { "detached": [ 1389606, 255821, 289097, 245141, 272192 ], "semi_detached": [ 209304, 186047, 237506, 252507, 196232, 218781, 235733, 165019, 213318, 177074, 234834 ], "terraced": [], "flat": [], "non_residential": [] }, "compare_to_town_average": { "detached": [ 6.8, 1.25, 1.42, 1.2, 1.33 ], "semi_detached": [ 0.82, 0.9, 1.15, 1.23, 0.95, 1.06, 1.15, 0.8, 1.04, 0.86, 1.14 ], "terraced": [], "flat": [] }, "compare_bytype_to_town_average": { "detached": [ 4.45, 0.82, 0.93, 0.78, 0.87 ], "semi_detached": [ 0.89, 0.9, 1.15, 1.22, 0.95, 1.06, 1.14, 0.8, 1.03, 0.86, 1.14 ], "terraced": [], "flat": [] } }, "@copyright": "Contains HM Land Registry data © Crown copyright and database right 2025. This data is licensed under the Open Government Licence v3.0. Link: https://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/" }