Aristocles Pty Ltd Housing Prices API

The government house price index from the Federal Housing Finance Agency, tracking repeat-sale home price changes back to the 1970s at national, census division, state and metro level, with seasonally adjusted and unadjusted values. Proptech, mortgage, real-estate investment and AI research agents use it to benchmark home values. Source: Source: U.S. Federal Housing Finance Agency, House Price Index.. Licence: Public Domain (U.S. Government Work). Base path: /v1/data/united-states-house-price-index. Requires an API key (X-API-Key).

Operations 3

GET /v1/data/united-states-house-price-index List United States House Price Index records #
GET /v1/data/united-states-house-price-index/search Search United States House Price Index by place_name #
GET /v1/data/united-states-house-price-index/{key} Get one United States House Price Index record by place_id #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/aristocles-com-au:aristocles-com-au-housing-prices-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

aristocles-com-au-housing-prices-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Aristocles Data Housing Prices API
  description: 'Four Australian data APIs on one key — subscriptions, trade pricing, PBS drugs, and rental prices.


    ---


    ## Quick start


    **1. Get your API key** — register in one request:

    ```

    POST /v1/auth/register

    {"email": "you@example.com", "name": "Your Name"}

    ```

    Copy the `api_key` from the response.


    **2. Authenticate** — add your key to every request as a header:

    ```

    X-API-Key: ar_live_xxxxxxxxxxxx

    ```


    **3. Run the discovery endpoint** — returns all available slugs, example calls, and your account limits:

    ```

    GET /v1/discovery

    ```


    **4. Make your first call:**

    ```

    GET /v1/prices/netflix?country=AU

    GET /v1/trades/electrician/prices?state=NSW&country=AU

    GET /v1/pbs/metformin

    GET /v1/rental/VIC/Richmond

    ```


    ---


    ## Four data domains


    | Domain | Base path | What it covers |

    |---|---|---|

    | **Subscription Pricing** | `/v1/prices`, `/v1/services` | 50+ SaaS & streaming services: Netflix, Spotify, Adobe, etc. |

    | **Contractor Trades** | `/v1/trades` | Plumbers, electricians, painters across AU, US, UK, CA, NZ |

    | **PBS Drug Pricing** | `/v1/pbs` | 14,000+ medications on Australia''s Pharmaceutical Benefits Scheme |

    | **Rental Market** | `/v1/rental` | Median weekly rent by suburb and postcode across Australia |

    | **RBA Economic Data** | `/v1/rba` | Cash rate, AUD FX rates, CPI inflation, mortgage rates, credit aggregates |


    ---


    ## MCP Server


    All four data domains are also available as MCP tools at:

    ```

    https://api.aristocles.com.au/mcp/

    ```

    Connect any MCP-compatible AI agent (Claude, GPT, Gemini) to get structured data without writing API calls.'
  version: 2.1.0
tags:
- name: Housing Prices
  description: 'The government house price index from the Federal Housing Finance Agency, tracking repeat-sale home price changes back to the 1970s at national, census division, state and metro level, with seasonally adjusted and unadjusted values. Proptech, mortgage, real-estate investment and AI research agents use it to benchmark home values. Source: Source: U.S. Federal Housing Finance Agency, House Price Index.. Licence: Public Domain (U.S. Government Work). Base path: /v1/data/united-states-house-price-index. Requires an API key (X-API-Key).'
paths:
  /v1/data/united-states-house-price-index:
    get:
      tags:
      - Housing Prices
      summary: List United States House Price Index records
      description: 'List United States House Price Index records with optional filters and pagination.


        **Source:** Source: U.S. Federal Housing Finance Agency, House Price Index. (Public Domain (U.S. Government Work)).


        **Fields returned:**

        - `hpi_type` (str) — Index type (e.g. traditional, distress-free)

        - `hpi_flavor` (str) — Purchase-only, all-transactions, expanded-data

        - `frequency` (str) — monthly or quarterly

        - `level` (str) — Geography level (USA, State, MSA, Census Division)

        - `place_name` (str) — Geography name

        - `place_id` (str) — Geography code

        - `year` (int) — Year

        - `period` (int) — Month or quarter number

        - `index_nsa` (float) — Index, not seasonally adjusted

        - `index_sa` (float) — Index, seasonally adjusted


        **Example:** `GET /v1/data/united-states-house-price-index?limit=10&hpi_type=example`'
      operationId: list_endpoint_v1_data_united_states_house_price_index_get
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Max records to return (1-100).
          default: 25
          title: Limit
        description: Max records to return (1-100).
      - name: offset
        in: query
        required: false
        schema:
          type: integer
          minimum: 0
          description: Records to skip, for pagination.
          default: 0
          title: Offset
        description: Records to skip, for pagination.
      - name: hpi_type
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Index type (e.g. traditional, distress-free)
          examples:
          - example
          title: Hpi Type
        description: Index type (e.g. traditional, distress-free)
      - name: hpi_flavor
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Purchase-only, all-transactions, expanded-data
          examples:
          - example
          title: Hpi Flavor
        description: Purchase-only, all-transactions, expanded-data
      - name: frequency
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: monthly or quarterly
          examples:
          - example
          title: Frequency
        description: monthly or quarterly
      - name: level
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Geography level (USA, State, MSA, Census Division)
          examples:
          - example
          title: Level
        description: Geography level (USA, State, MSA, Census Division)
      - name: place_id
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Geography code
          examples:
          - example
          title: Place Id
        description: Geography code
      - name: year
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          description: Year
          examples:
          - '42'
          title: Year
        description: Year
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: A page of United States House Price Index records with pagination metadata.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - hpi_type: example
                    hpi_flavor: example
                    frequency: example
                    level: example
                    place_name: example
                    place_id: example
                    year: 42
                    period: 42
                    index_nsa: 4.2
                    index_sa: 4.2
                  total: 1
                  limit: 25
                  offset: 0
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/united-states-house-price-index/search:
    get:
      tags:
      - Housing Prices
      summary: Search United States House Price Index by place_name
      description: 'Search United States House Price Index records by `place_name` (partial, case-insensitive).


        **Example:** `GET /v1/data/united-states-house-price-index/search?q=exa`'
      operationId: search_endpoint_v1_data_united_states_house_price_index_search_get
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
          minLength: 2
          maxLength: 100
          description: Case-insensitive partial match on place_name.
          examples:
          - exa
          title: Q
        description: Case-insensitive partial match on place_name.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          maximum: 100
          minimum: 1
          description: Max records to return (1-100).
          default: 25
          title: Limit
        description: Max records to return (1-100).
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: Matching United States House Price Index records.
          content:
            application/json:
              schema: {}
              example:
                data:
                  items:
                  - hpi_type: example
                    hpi_flavor: example
                    frequency: example
                    level: example
                    place_name: example
                    place_id: example
                    year: 42
                    period: 42
                    index_nsa: 4.2
                    index_sa: 4.2
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /v1/data/united-states-house-price-index/{key}:
    get:
      tags:
      - Housing Prices
      summary: Get one United States House Price Index record by place_id
      description: 'Fetch a single United States House Price Index record by its `place_id`.


        **Example:** `GET /v1/data/united-states-house-price-index/example`'
      operationId: get_endpoint_v1_data_united_states_house_price_index__key__get
      parameters:
      - name: key
        in: path
        required: true
        schema:
          type: string
          description: The place_id value to look up (case-insensitive).
          examples:
          - example
          title: Key
        description: The place_id value to look up (case-insensitive).
      - name: X-API-Key
        in: header
        required: true
        schema:
          type: string
          title: X-Api-Key
      responses:
        '200':
          description: A single United States House Price Index record.
          content:
            application/json:
              schema: {}
              example:
                data:
                  hpi_type: example
                  hpi_flavor: example
                  frequency: example
                  level: example
                  place_name: example
                  place_id: example
                  year: 42
                  period: 42
                  index_nsa: 4.2
                  index_sa: 4.2
        '404':
          content:
            application/json:
              example:
                error:
                  code: NOT_FOUND
                  message: No United States House Price Index record for '...'.
          description: Not Found
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError