Redfin Data Center

openapi: 3.1.0
info:
  title: Redfin Data Center
  description: >-
    The Redfin Data Center provides downloadable housing market data for
    metropolitan areas, cities, neighborhoods, and zip codes across the
    United States. Data is available at national, metro, state, county,
    city, zip code, and neighborhood levels. Weekly data is updated every
    Wednesday with new data for the prior week, computed as rolling 1, 4,
    or 12-week windows. Monthly data is released during the Friday of the
    third full week of each month. Datasets cover median sale prices,
    homes sold, new listings, days on market, inventory levels, and
    price drops. Data is provided in compressed TSV format hosted on
    Amazon S3.
  version: '1.0.0'
  contact:
    name: Redfin Economics Team
    url: https://www.redfin.com/news/data-center/
  termsOfService: https://www.redfin.com/about/terms-of-use
externalDocs:
  description: Redfin Data Center Documentation
  url: https://www.redfin.com/news/data-center/
servers:
  - url: https://redfin-public-data.s3.us-west-2.amazonaws.com
    description: Redfin Public Data S3 Bucket
tags:
  - name: Market Tracker
    description: >-
      Downloadable housing market tracker datasets segmented by region level.
paths:
  /redfin_market_tracker/us_national_market_tracker.tsv000.gz:
    get:
      operationId: downloadNationalMarketTracker
      summary: Download national market tracker data
      description: >-
        Downloads the national-level housing market tracker dataset in
        compressed TSV format. Contains aggregate housing metrics across
        the entire United States including median sale price, homes sold,
        new listings, days on market, inventory, and price drops.
      tags:
        - Market Tracker
      responses:
        '200':
          description: Compressed TSV file with national market data
          content:
            application/gzip:
              schema:
                type: string
                format: binary
                description: >-
                  Gzipped TSV file containing national housing market data.
  /redfin_market_tracker/redfin_metro_market_tracker.tsv000.gz:
    get:
      operationId: downloadMetroMarketTracker
      summary: Download metro-level market tracker data
      description: >-
        Downloads the metro-level housing market tracker dataset in
        compressed TSV format. Contains housing metrics segmented by
        metropolitan statistical areas across the United States.
      tags:
        - Market Tracker
      responses:
        '200':
          description: Compressed TSV file with metro market data
          content:
            application/gzip:
              schema:
                type: string
                format: binary
                description: >-
                  Gzipped TSV file containing metro-level housing market data.
  /redfin_market_tracker/state_market_tracker.tsv000.gz:
    get:
      operationId: downloadStateMarketTracker
      summary: Download state-level market tracker data
      description: >-
        Downloads the state-level housing market tracker dataset in
        compressed TSV format. Contains housing metrics aggregated at
        the state level for all US states and territories.
      tags:
        - Market Tracker
      responses:
        '200':
          description: Compressed TSV file with state market data
          content:
            application/gzip:
              schema:
                type: string
                format: binary
                description: >-
                  Gzipped TSV file containing state-level housing market data.
  /redfin_market_tracker/county_market_tracker.tsv000.gz:
    get:
      operationId: downloadCountyMarketTracker
      summary: Download county-level market tracker data
      description: >-
        Downloads the county-level housing market tracker dataset in
        compressed TSV format. Contains housing metrics segmented by
        county across the United States.
      tags:
        - Market Tracker
      responses:
        '200':
          description: Compressed TSV file with county market data
          content:
            application/gzip:
              schema:
                type: string
                format: binary
                description: >-
                  Gzipped TSV file containing county-level housing market data.
  /redfin_market_tracker/city_market_tracker.tsv000.gz:
    get:
      operationId: downloadCityMarketTracker
      summary: Download city-level market tracker data
      description: >-
        Downloads the city-level housing market tracker dataset in
        compressed TSV format. Contains housing metrics segmented by
        city across the United States.
      tags:
        - Market Tracker
      responses:
        '200':
          description: Compressed TSV file with city market data
          content:
            application/gzip:
              schema:
                type: string
                format: binary
                description: >-
                  Gzipped TSV file containing city-level housing market data.
  /redfin_market_tracker/zip_code_market_tracker.tsv000.gz:
    get:
      operationId: downloadZipCodeMarketTracker
      summary: Download ZIP code-level market tracker data
      description: >-
        Downloads the ZIP code-level housing market tracker dataset in
        compressed TSV format. Contains housing metrics segmented by
        ZIP code across the United States. This is the most granular
        widely available dataset.
      tags:
        - Market Tracker
      responses:
        '200':
          description: Compressed TSV file with ZIP code market data
          content:
            application/gzip:
              schema:
                type: string
                format: binary
                description: >-
                  Gzipped TSV file containing ZIP code-level housing market data.
  /redfin_market_tracker/neighborhood_market_tracker.tsv000.gz:
    get:
      operationId: downloadNeighborhoodMarketTracker
      summary: Download neighborhood-level market tracker data
      description: >-
        Downloads the neighborhood-level housing market tracker dataset
        in compressed TSV format. Contains housing metrics segmented by
        Redfin-defined neighborhood boundaries.
      tags:
        - Market Tracker
      responses:
        '200':
          description: Compressed TSV file with neighborhood market data
          content:
            application/gzip:
              schema:
                type: string
                format: binary
                description: >-
                  Gzipped TSV file containing neighborhood-level housing
                  market data.
components:
  schemas:
    MarketTrackerRecord:
      type: object
      description: >-
        A single record from a Redfin market tracker dataset representing
        housing market metrics for a specific region and time period.
      properties:
        period_begin:
          type: string
          format: date
          description: >-
            Start date of the measurement period.
        period_end:
          type: string
          format: date
          description: >-
            End date of the measurement period.
        period_duration:
          type: string
          description: >-
            Duration type of the period (e.g., weekly, monthly).
        region_type:
          type: string
          description: >-
            Type of region (national, metro, state, county, city,
            zip_code, neighborhood).
        region_type_id:
          type: integer
          description: >-
            Numeric identifier for the region type.
        table_id:
          type: integer
          description: >-
            Numeric identifier for the data table.
        is_seasonally_adjusted:
          type: boolean
          description: >-
            Whether the data is seasonally adjusted.
        region:
          type: string
          description: >-
            Name of the region.
        city:
          type: string
          description: >-
            City name if applicable.
        state:
          type: string
          description: >-
            State name or abbreviation.
        state_code:
          type: string
          description: >-
            Two-letter state code.
        property_type:
          type: string
          description: >-
            Property type (All Residential, Single Family Residential,
            Condo/Co-op, Townhouse, Multi-Family).
        median_sale_price:
          type: number
          description: >-
            Median sale price for the period and region in USD.
        median_list_price:
          type: number
          description: >-
            Median list price for the period and region in USD.
        median_ppsf:
          type: number
          description: >-
            Median price per square foot in USD.
        homes_sold:
          type: integer
          description: >-
            Number of homes sold during the period.
        pending_sales:
          type: integer
          description: >-
            Number of pending sales during the period.
        new_listings:
          type: integer
          description: >-
            Number of new listings added during the period.
        inventory:
          type: integer
          description: >-
            Total active inventory at the end of the period.
        months_of_supply:
          type: number
          description: >-
            Months of supply based on current sales pace.
        median_dom:
          type: integer
          description: >-
            Median days on market.
        avg_sale_to_list:
          type: number
          description: >-
            Average sale-to-list price ratio.
        sold_above_list:
          type: number
          description: >-
            Percentage of homes sold above list price.
        price_drops:
          type: number
          description: >-
            Percentage of listings with price drops.
        off_market_in_two_weeks:
          type: number
          description: >-
            Percentage of listings that went off market within two weeks.