Redfin CSV Export API

openapi: 3.2.0
info:
  title: Redfin GIS CSV Export API
  description: The Redfin GIS CSV Export API provides bulk property data downloads in CSV format. This endpoint returns up to 350 property records per request in tabular format, making it suitable for data analysis and spreadsheet workflows. It accepts parameters for market selection, price ranges, bedroom and bathroom counts, region identifiers, and property status filters. The CSV output includes fields such as address, list price, property type, square footage, lot size, and listing status, enabling developers and analysts to aggregate property data for research and comparison purposes.
  version: 1.0.0
  contact:
    name: Redfin
    url: https://www.redfin.com
  termsOfService: https://www.redfin.com/about/terms-of-use
servers:
- url: https://www.redfin.com/stingray
  description: Redfin Stingray Production Server
tags:
- name: CSV Export
  description: Endpoints for exporting property search results in CSV format.
paths:
  /api/gis-csv:
    get:
      operationId: exportGisCsv
      summary: Export property search results as CSV
      description: Exports property search results in CSV format based on the specified region, property type, status, and filter parameters. Returns up to 350 property records per request. The CSV output includes columns for address, city, state, ZIP code, list price, beds, baths, square footage, lot size, year built, days on market, property type, listing status, and other property attributes. This endpoint corresponds to the Download All link on Redfin search result pages.
      tags:
      - CSV Export
      parameters:
      - name: region_id
        in: query
        description: The unique identifier for a Redfin region.
        schema:
          type: integer
      - name: region_type
        in: query
        description: The type of region to search. Values include 1 (neighborhood), 2 (ZIP code), 5 (county), 6 (city).
        schema:
          type: integer
          enum:
          - 1
          - 2
          - 5
          - 6
      - name: uipt
        in: query
        description: Property type filter. Values include 1 (house), 2 (condo), 3 (townhouse), 4 (multi-family), 5 (land), 6 (other). Multiple values can be comma-separated.
        schema:
          type: string
      - name: status
        in: query
        description: Listing status filter. Values include 1 (active), 130 (pending), 131 (active and pending).
        schema:
          type: integer
          enum:
          - 1
          - 130
          - 131
      - name: min_price
        in: query
        description: Minimum listing price filter in USD.
        schema:
          type: integer
      - name: max_price
        in: query
        description: Maximum listing price filter in USD.
        schema:
          type: integer
      - name: num_beds
        in: query
        description: Minimum number of bedrooms filter.
        schema:
          type: integer
      - name: max_num_beds
        in: query
        description: Maximum number of bedrooms filter.
        schema:
          type: integer
      - name: num_baths
        in: query
        description: Minimum number of bathrooms filter.
        schema:
          type: integer
      - name: max_num_baths
        in: query
        description: Maximum number of bathrooms filter.
        schema:
          type: integer
      - name: min_year_built
        in: query
        description: Minimum year built filter.
        schema:
          type: integer
      - name: max_year_built
        in: query
        description: Maximum year built filter.
        schema:
          type: integer
      - name: min_listing_approx_size
        in: query
        description: Minimum approximate square footage filter.
        schema:
          type: integer
      - name: max_listing_approx_size
        in: query
        description: Maximum approximate square footage filter.
        schema:
          type: integer
      - name: min_parcel_size
        in: query
        description: Minimum lot/parcel size filter.
        schema:
          type: integer
      - name: max_parcel_size
        in: query
        description: Maximum lot/parcel size filter.
        schema:
          type: integer
      - name: min_stories
        in: query
        description: Minimum number of stories filter.
        schema:
          type: integer
      - name: max_stories
        in: query
        description: Maximum number of stories filter.
        schema:
          type: integer
      - name: gar
        in: query
        description: Garage availability filter.
        schema:
          type: boolean
      - name: hoa
        in: query
        description: HOA filter. Value of 0 means no HOA.
        schema:
          type: integer
      - name: num_homes
        in: query
        description: Maximum number of results to return per request. The API caps at approximately 350 records.
        schema:
          type: integer
          maximum: 350
      - name: sf
        in: query
        description: Listing type sub-filters for refining results.
        schema:
          type: string
      - name: time_on_market_range
        in: query
        description: Days on market range filter. Uses reverse range format.
        schema:
          type: string
      responses:
        '200':
          description: CSV file containing property search results
          content:
            text/csv:
              schema:
                type: string
                description: CSV-formatted property data with columns including address, city, state, ZIP, price, beds, baths, square footage, lot size, year built, days on market, property type, and listing status.
externalDocs:
  description: Reverse-Engineered API Documentation
  url: https://github.com/alientechsw/RedfinPlus/blob/master/docs/REDFIN.md