Propalt API

Market & Analytics

Endpoint:https://propalt-api-live-main-5e2d419.zuplo.app

Get Regional Analysis

GET

https://propalt-api-live-main-5e2d419.zuplo.app

/market-analytics/get-analysis-data

Retrieve regional analysis data (property characteristics, energy costs, dwelling counts) by postcode outward code.

Get Regional Analysis › query Parameters

first_postcode

string · pattern: ^(?i)([A-Z]{1,2}\d[A… · required

Get Regional Analysis › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get Regional Analysis › Responses

Regional analysis data for a postcode outward code

Output schema for get_analysis_data endpoint (documentation only). Do NOT use as response_model — return plain dicts from endpoints.

The primary outward code of the UK postcode (e.g., SW1A) used for regional aggregation.

Mean count of bedrooms for residential properties within the specified sector.

Mean count of bathrooms for residential properties within the specified sector.

Mean count of reception rooms (lounges, dining rooms) within the specified sector.

Average Gross Internal Area (GIA) in square metres, measured per RICS professional standards.

Current Energy Performance Certificate (EPC) rating, ranging from A (high) to G (low).

Estimated annual cost (GBP) for property lighting based on current energy prices.

Estimated annual cost (GBP) for space heating based on current energy prices.

Estimated annual cost (GBP) for domestic hot water based on current energy prices.

Categorical age range of the property's original construction (e.g., '2007 onwards').

Mean fixed-line broadband download speed (Mbps) recorded within the sector.

Total count of Detached residential dwellings within the area.

Total count of Semi-Detached residential dwellings within the area.

Total count of Terraced residential dwellings within the area.

Total count of Flats or maisonettes within the area.

GET/market-analytics/get-analysis-data

curl --request GET \
  --url 'https://propalt-api-live-main-5e2d419.zuplo.app/market-analytics/get-analysis-data?first_postcode=%3Cstring%3E' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "first_posctode": "NW3",
  "number_of_bedrooms": 2.8,
  "number_of_bathrooms": 1.4,
  "number_of_reception_rooms": 1.2,
  "total_floor_area": 78.5,
  "current_energy_rating": "D",
  "lighting_cost_current": 88.5,
  "heating_cost_current": 645.2,
  "hot_water_cost_current": 172.8,
  "construction_age_band": "1900-1929",
  "average_download_speed": 82.5,
  "D_count": 320,
  "S_count": 580,
  "T_count": 1250,
  "F_count": 3800
}

json

application/json

Get Quarterly Market Analysis

GET

https://propalt-api-live-main-5e2d419.zuplo.app

/market-analytics/get-quarterly-market-analysis

Retrieve quarterly market analysis data (listings, sales, prices, SSTC times, reductions) by postcode outward code.

Get Quarterly Market Analysis › query Parameters

first_postcode

string · pattern: ^(?i)([A-Z]{1,2}\d[A… · required

return_national

string · pattern: ^[yn]$

Default: n

Get Quarterly Market Analysis › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get Quarterly Market Analysis › Responses

Quarterly market analysis data by postcode district

Output schema for get_quarterly_market_analysis endpoint (documentation only). Do NOT use as response_model — return plain dicts from endpoints.

The specific quarter/period of the analysis.

The geographic area or postcode district (e.g. 'AB10').

Count of properties listed in this period (All property types).

Count of properties sold in this period (All property types).

The median listing price of properties (All property types).

Percentage change in median listing price (All property types).

The median sold price of properties (All property types).

Average days from listing to Sold Subject to Contract (All property types).

Percentage change in average days to SSTC (All property types).

Count of properties listed (Detached).

Count of properties sold (Detached).

The median listing price (Detached).

Percentage change in median listing price (Detached).

The median sold price (Detached).

Average days from listing to SSTC (Detached).

Percentage change in average days to SSTC (Detached).

Count of properties listed (Flat).

Count of properties sold (Flat).

The median listing price (Flat).

Percentage change in median listing price (Flat).

The median sold price (Flat).

Average days from listing to SSTC (Flat).

Percentage change in average days to SSTC (Flat).

Count of properties listed (Semi-Detached).

Count of properties sold (Semi-Detached).

The median listing price (Semi-Detached).

Percentage change in median listing price (Semi-Detached).

The median sold price (Semi-Detached).

Average days from listing to SSTC (Semi-Detached).

Percentage change in average days to SSTC (Semi-Detached).

Count of properties listed (Terraced).

Count of properties sold (Terraced).

The median listing price (Terraced).

Percentage change in median listing price (Terraced).

The median sold price (Terraced).

Average days from listing to SSTC (Terraced).

Percentage change in average days to SSTC (Terraced).

Probability ratio that a property will receive a price reduction.

Ratio of properties with price reductions (All types).

Ratio of properties with price reductions (Detached).

Ratio of properties with price reductions (Semi-Detached).

Ratio of properties with price reductions (Terraced).

Ratio of properties with price reductions (Flats).

Total count of properties that reached legal Land Registry completion.

Average days from SSTC to legal completion (All property types).

Average days from SSTC to legal completion (Houses).

Average days from SSTC to legal completion (Flats).

Price reduction ratio based on final Land Registry sold price (All property types).

Price reduction ratio based on final Land Registry sold price (Flats).

Price reduction ratio based on final Land Registry sold price (Houses).

GET/market-analytics/get-quarterly-market-analysis

curl --request GET \
  --url 'https://propalt-api-live-main-5e2d419.zuplo.app/market-analytics/get-quarterly-market-analysis?first_postcode=%3Cstring%3E' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "quarter": "2025-Q4",
  "region": "NW3",
  "count_O": 285,
  "sold_count_O": 142,
  "median_price_O": 875000,
  "median_price_O_pct": 2.3,
  "median_sold_price_O": 850000,
  "avg_day_to_sstc_O": 45,
  "avg_day_to_sstc_O_pct": -5.2,
  "count_D": 18,
  "sold_count_D": 8,
  "median_price_D": 2450000,
  "median_price_D_pct": 1.8,
  "median_sold_price_D": 2380000,
  "avg_day_to_sstc_D": 62,
  "avg_day_to_sstc_D_pct": -3.1,
  "count_F": 185,
  "sold_count_F": 95,
  "median_price_F": 625000,
  "median_price_F_pct": 3.1,
  "median_sold_price_F": 610000,
  "avg_day_to_sstc_F": 38,
  "avg_day_to_sstc_F_pct": -6.8,
  "count_S": 32,
  "sold_count_S": 15,
  "median_price_S": 1350000,
  "median_price_S_pct": 1.5,
  "median_sold_price_S": 1320000,
  "avg_day_to_sstc_S": 52,
  "avg_day_to_sstc_S_pct": -4,
  "count_T": 50,
  "sold_count_T": 24,
  "median_price_T": 1150000,
  "median_price_T_pct": 2,
  "median_sold_price_T": 1125000,
  "avg_day_to_sstc_T": 48,
  "avg_day_to_sstc_T_pct": -3.5,
  "OTM_reduction_probability": 0.28,
  "reduction_ratio_O": 0.22,
  "reduction_ratio_D": 0.18,
  "reduction_ratio_S": 0.2,
  "reduction_ratio_T": 0.24,
  "reduction_ratio_F": 0.25,
  "completed_count_O": 128,
  "avg_day_from_sstc_to_LR_O": 95,
  "avg_day_from_sstc_to_LR_H": 88,
  "avg_day_from_sstc_to_LR_F": 102,
  "LR_reduction_ratio_O": -0.035,
  "LR_reduction_ratio_F": -0.028,
  "LR_reduction_ratio_H": -0.042
}

json

application/json

Get Monthly Market Analysis

GET

https://propalt-api-live-main-5e2d419.zuplo.app

/market-analytics/get-monthly-market-analysis

Retrieve monthly market analysis data (listings, sales, prices, SSTC times, reductions) by postcode outward code.

Get Monthly Market Analysis › query Parameters

first_postcode

string · pattern: ^(?i)([A-Z]{1,2}\d[A… · required

return_national

string · pattern: ^[yn]$

Default: n

Get Monthly Market Analysis › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get Monthly Market Analysis › Responses

Monthly market analysis data by postcode district

Output schema for get_monthly_market_analysis endpoint (documentation only). Do NOT use as response_model — return plain dicts from endpoints.

The specific month/period of the analysis (e.g. 'January 2026').

The geographic area or postcode district (e.g. 'AB10').

Count of properties listed in this period (All property types).

Count of properties sold in this period (All property types).

The median listing price of properties (All property types).

The median sold price of properties (All property types).

Average days from listing to SSTC (All property types).

Count of properties listed (Detached).

Count of properties sold (Detached).

The median listing price (Detached).

The median sold price (Detached).

Average days from listing to SSTC (Detached).

Count of properties listed (Flat).

Count of properties sold (Flat).

The median listing price (Flat).

The median sold price (Flat).

Average days from listing to SSTC (Flat).

Count of properties listed (Semi-Detached).

Count of properties sold (Semi-Detached).

The median listing price (Semi-Detached).

The median sold price (Semi-Detached).

Average days from listing to SSTC (Semi-Detached).

Count of properties listed (Terraced).

Count of properties sold (Terraced).

The median listing price (Terraced).

The median sold price (Terraced).

Average days from listing to SSTC (Terraced).

Ratio of properties sold within 30 days (All types).

Ratio of properties sold within 30 days (Detached).

Ratio of properties sold within 30 days (Semi-Detached).

Ratio of properties sold within 30 days (Terraced).

Ratio of properties sold within 30 days (Flat).

Ratio of properties sold within 60 days (All types).

Ratio of properties sold within 60 days (Detached).

Ratio of properties sold within 60 days (Semi-Detached).

Ratio of properties sold within 60 days (Terraced).

Ratio of properties sold within 60 days (Flat).

Ratio of properties sold within 90 days (All types).

Ratio of properties sold within 90 days (Detached).

Ratio of properties sold within 90 days (Semi-Detached).

Ratio of properties sold within 90 days (Terraced).

Ratio of properties sold within 90 days (Flat).

GET/market-analytics/get-monthly-market-analysis

curl --request GET \
  --url 'https://propalt-api-live-main-5e2d419.zuplo.app/market-analytics/get-monthly-market-analysis?first_postcode=%3Cstring%3E' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "month": "January 2026",
  "region": "NW3",
  "count_O": 95,
  "sold_count_O": 48,
  "median_price_O": 890000,
  "median_sold_price_O": 865000,
  "avg_day_to_sstc_O": 42,
  "count_D": 6,
  "sold_count_D": 3,
  "median_price_D": 2500000,
  "median_sold_price_D": 2420000,
  "avg_day_to_sstc_D": 58,
  "count_F": 62,
  "sold_count_F": 32,
  "median_price_F": 635000,
  "median_sold_price_F": 620000,
  "avg_day_to_sstc_F": 35,
  "count_S": 11,
  "sold_count_S": 5,
  "median_price_S": 1380000,
  "median_sold_price_S": 1340000,
  "avg_day_to_sstc_S": 50,
  "count_T": 16,
  "sold_count_T": 8,
  "median_price_T": 1175000,
  "median_sold_price_T": 1150000,
  "avg_day_to_sstc_T": 46,
  "D30_sold_ratio_O": 0.32,
  "D30_sold_ratio_D": 0.18,
  "D30_sold_ratio_S": 0.25,
  "D30_sold_ratio_T": 0.28,
  "D30_sold_ratio_F": 0.38,
  "D60_sold_ratio_O": 0.55,
  "D60_sold_ratio_D": 0.42,
  "D60_sold_ratio_S": 0.48,
  "D60_sold_ratio_T": 0.52,
  "D60_sold_ratio_F": 0.62,
  "D90_sold_ratio_O": 0.72,
  "D90_sold_ratio_D": 0.58,
  "D90_sold_ratio_S": 0.65,
  "D90_sold_ratio_T": 0.68,
  "D90_sold_ratio_F": 0.78
}

json

application/json

Get Price Distribution

GET

https://propalt-api-live-main-5e2d419.zuplo.app

/market-analytics/get-distribution-graph-data

Get selling valuation distribution graph data for a postcode outward code.

Get Price Distribution › query Parameters

first_postcode

string · pattern: ^(?i)([A-Z]{1,2}\d[A… · required

Get Price Distribution › Headers

Authorization

string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Get Price Distribution › Responses

Distribution graph data with dynamic and fixed price buckets

Output schema for get_distribution_graph_data endpoint (documentation only). Do NOT use as response_model — return plain dicts from endpoints.

array · required

Dynamic price range labels (10 buckets) based on the min/max selling valuations in the area.

array · required

Property counts for each dynamic price range bucket.

array · required

Fixed price range labels in £100k increments from £0 to >£1M.

array · required

Property counts for each fixed price range bucket.

GET/market-analytics/get-distribution-graph-data

curl --request GET \
  --url 'https://propalt-api-live-main-5e2d419.zuplo.app/market-analytics/get-distribution-graph-data?first_postcode=%3Cstring%3E' \
  --header 'Authorization: <string>'

shell

Example Responses

{
  "labels": [
    "£350k-£420k",
    "£420k-£490k",
    "£490k-£560k",
    "£560k-£630k",
    "£630k-£700k",
    "£700k-£770k",
    "£770k-£840k",
    "£840k-£910k",
    "£910k-£980k",
    "£980k-£1.05M"
  ],
  "data": [
    45,
    82,
    156,
    210,
    285,
    198,
    142,
    95,
    62,
    38
  ],
  "s_labels": [
    "£0-£100k",
    "£100k-£200k",
    "£200k-£300k",
    "£300k-£400k",
    "£400k-£500k",
    "£500k-£600k",
    "£600k-£700k",
    "£700k-£800k",
    "£800k-£900k",
    "£900k-£1M",
    ">£1M"
  ],
  "s_data": [
    5,
    12,
    28,
    65,
    142,
    258,
    312,
    245,
    185,
    120,
    380
  ]
}

json

application/json

Property Market Activity