openapi: 3.1.0
info:
  title: Redfin Data Center CSV Export Market Tracker API
  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
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.
externalDocs:
  description: Redfin Data Center Documentation
  url: https://www.redfin.com/news/data-center/