Redfin

Redfin Search API

Endpoints for searching properties by location, region, and filters.

GitHub OpenAPI

Operations 2

GET /do/gis-search Search properties via GIS #
GET /api/gis Search properties via GIS API #

Documentation

📖
Documentation
https://github.com/alientechsw/RedfinPlus/blob/master/docs/REDFIN.md
📖
Documentation
https://www.redfin.com/news/data-center/
📖
Documentation
https://support.redfin.com/hc/en-us/articles/360016476931-Downloading-Data

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/redfin/refs/heads/main/openapi/redfin-search-api-openapi.yml

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/redfin/refs/heads/main/json-schema/redfin-market-tracker-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/redfin/refs/heads/main/json-schema/redfin-property-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/redfin/refs/heads/main/json-structure/redfin-property-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/redfin/refs/heads/main/json-structure/redfin-market-tracker-structure.json

Other Resources

🔗
SpectralRules
https://raw.githubusercontent.com/api-evangelist/redfin/refs/heads/main/rules/redfin-rules.yml
🔗
JSONLD
https://raw.githubusercontent.com/api-evangelist/redfin/refs/heads/main/json-ld/redfin-context.jsonld
🔗
Vocabulary
https://raw.githubusercontent.com/api-evangelist/redfin/refs/heads/main/vocabulary/redfin-vocabulary.yml

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/redfin-search-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

redfin-search-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Redfin Stingray Search API
  description: The Redfin Stingray API is the internal REST API that powers the Redfin website and mobile applications.
  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: Search
  description: Endpoints for searching properties by location, region, and filters.
paths:
  /do/gis-search:
    get:
      operationId: gisSearch
      summary: Search properties via GIS
      description: Performs a geographic information system search for properties within a specified region. Returns property listings matching the provided filters including price range, property type, bedroom and bathroom counts, and geographic boundaries.
      tags:
      - Search
      parameters:
      - $ref: '#/components/parameters/regionId'
      - $ref: '#/components/parameters/regionType'
      - $ref: '#/components/parameters/uipt'
      - $ref: '#/components/parameters/status'
      - $ref: '#/components/parameters/minPrice'
      - $ref: '#/components/parameters/maxPrice'
      - $ref: '#/components/parameters/numBeds'
      - $ref: '#/components/parameters/maxNumBeds'
      - $ref: '#/components/parameters/numBaths'
      - $ref: '#/components/parameters/maxNumBaths'
      - $ref: '#/components/parameters/minYearBuilt'
      - $ref: '#/components/parameters/maxYearBuilt'
      - $ref: '#/components/parameters/minListingApproxSize'
      - $ref: '#/components/parameters/maxListingApproxSize'
      - $ref: '#/components/parameters/minParcelSize'
      - $ref: '#/components/parameters/maxParcelSize'
      - $ref: '#/components/parameters/numHomes'
      - $ref: '#/components/parameters/pageNumber'
      - name: user_poly
        in: query
        description: Custom polygon coordinates defining a geographic search boundary.
        schema:
          type: string
      responses:
        '200':
          description: Successful property search results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GisSearchResponse'
  /api/gis:
    get:
      operationId: gisApiSearch
      summary: Search properties via GIS API
      description: Alternative GIS-based property search endpoint. Returns property data in JSON format matching the specified region and filter criteria. Supports polygon-based geographic boundaries and all standard property filters.
      tags:
      - Search
      parameters:
      - $ref: '#/components/parameters/regionId'
      - $ref: '#/components/parameters/regionType'
      - $ref: '#/components/parameters/uipt'
      - $ref: '#/components/parameters/status'
      - $ref: '#/components/parameters/minPrice'
      - $ref: '#/components/parameters/maxPrice'
      - $ref: '#/components/parameters/numBeds'
      - $ref: '#/components/parameters/numBaths'
      - $ref: '#/components/parameters/numHomes'
      - $ref: '#/components/parameters/pageNumber'
      - name: al
        in: query
        description: Access level for the request, controlling the detail of data returned.
        schema:
          type: integer
      - name: sp
        in: query
        description: Sort parameter controlling the ordering of search results.
        schema:
          type: string
      - name: v
        in: query
        description: API version parameter.
        schema:
          type: integer
      responses:
        '200':
          description: Successful property search results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GisSearchResponse'
components:
  parameters:
    minPrice:
      name: min_price
      in: query
      description: Minimum listing price filter in USD.
      schema:
        type: integer
    numBeds:
      name: num_beds
      in: query
      description: Minimum number of bedrooms filter.
      schema:
        type: integer
    numBaths:
      name: num_baths
      in: query
      description: Minimum number of bathrooms filter.
      schema:
        type: integer
    maxNumBaths:
      name: max_num_baths
      in: query
      description: Maximum number of bathrooms filter.
      schema:
        type: integer
    minParcelSize:
      name: min_parcel_size
      in: query
      description: Minimum lot/parcel size filter.
      schema:
        type: integer
    maxNumBeds:
      name: max_num_beds
      in: query
      description: Maximum number of bedrooms filter.
      schema:
        type: integer
    regionType:
      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
    maxListingApproxSize:
      name: max_listing_approx_size
      in: query
      description: Maximum approximate square footage filter.
      schema:
        type: integer
    minListingApproxSize:
      name: min_listing_approx_size
      in: query
      description: Minimum approximate square footage filter.
      schema:
        type: integer
    maxPrice:
      name: max_price
      in: query
      description: Maximum listing price filter in USD.
      schema:
        type: integer
    pageNumber:
      name: page_number
      in: query
      description: Page number for paginated results.
      schema:
        type: integer
    status:
      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
    minYearBuilt:
      name: min_year_built
      in: query
      description: Minimum year built filter.
      schema:
        type: integer
    maxYearBuilt:
      name: max_year_built
      in: query
      description: Maximum year built filter.
      schema:
        type: integer
    regionId:
      name: region_id
      in: query
      description: The unique identifier for a Redfin region.
      schema:
        type: integer
    maxParcelSize:
      name: max_parcel_size
      in: query
      description: Maximum lot/parcel size filter.
      schema:
        type: integer
    uipt:
      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
    numHomes:
      name: num_homes
      in: query
      description: Maximum number of results to return per request.
      schema:
        type: integer
  schemas:
    Address:
      type: object
      description: Property address information.
      properties:
        streetAddress:
          type: string
          description: Street address of the property.
        city:
          type: string
          description: City name.
        state:
          type: string
          description: Two-letter state abbreviation.
        zip:
          type: string
          description: ZIP code.
    PropertySummary:
      type: object
      description: Summary information for a property listing.
      properties:
        propertyId:
          type: integer
          description: Unique Redfin property identifier.
        listingId:
          type: integer
          description: Unique Redfin listing identifier.
        mlsId:
          type: string
          description: MLS listing identifier.
        price:
          type: object
          description: Price information for the listing.
          properties:
            value:
              type: number
              description: Listing price in USD.
        address:
          $ref: '#/components/schemas/Address'
        beds:
          type: integer
          description: Number of bedrooms.
        baths:
          type: number
          description: Number of bathrooms.
        sqFt:
          type: object
          description: Square footage information.
          properties:
            value:
              type: integer
              description: Approximate living area in square feet.
        lotSize:
          type: object
          description: Lot size information.
          properties:
            value:
              type: integer
              description: Lot size in square feet.
        yearBuilt:
          type: object
          description: Year the property was built.
          properties:
            value:
              type: integer
              description: Year of construction.
        daysOnMarket:
          type: integer
          description: Number of days the property has been listed.
        propertyType:
          type: integer
          description: Property type code (1=house, 2=condo, 3=townhouse, 4=multi-family, 5=land, 6=other).
        listingType:
          type: string
          description: Type of listing (e.g., MLS, FSBO).
        url:
          type: string
          description: Relative URL path to the property listing on Redfin.
        latitude:
          type: number
          description: Property latitude coordinate.
        longitude:
          type: number
          description: Property longitude coordinate.
    GisSearchResponse:
      type: object
      description: Response from a GIS-based property search.
      properties:
        resultCode:
          type: integer
          description: API result code indicating success or failure.
        errorMessage:
          type: string
          description: Error message if the request failed.
        payload:
          type: object
          description: Response payload containing search results.
          properties:
            homes:
              type: array
              description: List of property summaries matching the search criteria.
              items:
                $ref: '#/components/schemas/PropertySummary'
            totalResultCount:
              type: integer
              description: Total number of properties matching the search criteria.
externalDocs:
  description: Reverse-Engineered API Documentation
  url: https://github.com/alientechsw/RedfinPlus/blob/master/docs/REDFIN.md