Redfin Listing Search API

Scrape Redfin property search results into structured JSON/CSV using ScraperAPI in Ruby. Supports search page URLs, country targeting, and domain selection.

This endpoint will return the search results from a listing search page and transform it into usable JSON.

require 'net/http'
require 'json'
params = {
:api_key => "API_KEY",
:url => "URL",
:country_code => "COUNTRY_CODE",
:tld => "TLD",
}
uri = URI('https://api.scraperapi.com/structured/redfin/search')
uri.query = URI.encode_www_form(params)
website_content = Net::HTTP.get(uri)
print(website_content)

Parameters	Details
API_KEY (required)	User's API Key.
URL (required)	The URL of the Redfin search page. The URL has to be a Redfin Search page.
country_code	Allows you to geotarget the request. Use this parameter if you want Redfin to be scraped from a specific country.
TLD	The top level domain to scrape. Valid options: ‘com’ (for redfin.com) ‘ca’ (for redfin.ca)

Sample Response

{
  "url": "https://www.redfin.com/city/1826/MA/Boston/filter/min-beds=3,min-baths=2",
  "type": "search_for_sale",
  "listing": [
    {
      "address": "370 Beacon St #3, Boston, MA 02116",
      "phone": "",
      "number_beds": "3 beds",
      "number_baths": "4 baths",
      "sq_ft": "3,300 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/system_files/media/1045768_JPG/genDesktopMapHomeCardUrl/item_29.jpg",
      "price": [
        {
          "cost": 5899000,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [
        "LISTED BY REDFIN",
        "3D WALKTHROUGH"
      ],
      "key_facts": [
        "$6,557 HOA",
        "Community pool",
        "Walker's paradise"
      ],
      "badge_sold": ""
    },
    {
      "address": "74 Green St, Boston, MA 02130",
      "phone": "",
      "number_beds": "4 beds",
      "number_baths": "3.5 baths",
      "sq_ft": "6,200 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/722/genIslnoResize.73335722_0.jpg",
      "price": [
        {
          "cost": 1850000,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [
        "NEW 59 MINS AGO"
      ],
      "key_facts": [
        "4,160 sq ft lot",
        "3 garage spots",
        "Walker's paradise"
      ],
      "badge_sold": ""
    },
    {
      "address": "",
      "phone": "",
      "number_beds": "",
      "number_baths": "",
      "sq_ft": "",
      "price": [],
      "badge": [],
      "key_facts": [],
      "badge_sold": ""
    },
    {
      "address": "16 Lawrence St #2, Boston, MA 02129",
      "phone": "",
      "number_beds": "4 beds",
      "number_baths": "3.5 baths",
      "sq_ft": "2,298 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/654/genIslnoResize.73335654_0.jpg",
      "price": [
        {
          "cost": 1895000,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [
        "OPEN SUN, 12PM TO 1:30PM"
      ],
      "key_facts": [
        "$250 HOA",
        "Walker's paradise"
      ],
      "badge_sold": ""
    },
    {
      "address": "5 Oakhurst St #2, Boston, MA 02124",
      "phone": "",
      "number_beds": "4 beds",
      "number_baths": "2 baths",
      "sq_ft": "1,597 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/599/genIslnoResize.73335599_0.jpg",
      "price": [
        {
          "cost": 549900,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [],
      "key_facts": [
        "$275 HOA",
        "2 garage spots",
        "Somewhat walkable"
      ],
      "badge_sold": ""
    },
    {
      "address": "38 Montgomery St, Boston, MA 02116",
      "phone": "",
      "number_beds": "4 beds",
      "number_baths": "3 baths",
      "sq_ft": "3,061 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/575/genIslnoResize.73335575_0.jpg",
      "price": [
        {
          "cost": 3295000,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [],
      "key_facts": [
        "Walker's paradise"
      ],
      "badge_sold": ""
    },
    {
      "address": "352 Marlborough St, Boston, MA 02115",
      "phone": "",
      "number_beds": "4 beds",
      "number_baths": "5.5 baths",
      "sq_ft": "4,754 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/458/genIslnoResize.73335458_1.jpg",
      "price": [
        {
          "cost": 9450000,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [
        "OPEN SAT, 10:30AM TO 12:30PM",
        "VIDEO TOUR"
      ],
      "key_facts": [
        "2,576 sq ft lot",
        "Walker's paradise"
      ],
      "badge_sold": ""
    },
    {
      "address": "21 Goldfinch Ct #21, Boston, MA 02126",
      "phone": "",
      "number_beds": "3 beds",
      "number_baths": "2 baths",
      "sq_ft": "1,270 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/448/genIslnoResize.73335448_0.jpg",
      "price": [
        {
          "cost": 599000,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [],
      "key_facts": [
        "$455 HOA",
        "Car-dependent"
      ],
      "badge_sold": ""
    },
    {
      "address": "252 Aspinwall Ave, Brookline, MA 02445",
      "phone": "",
      "number_beds": "9 beds",
      "number_baths": "2 baths",
      "sq_ft": "4,566 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/417/genIslnoResize.73335417_0.jpg",
      "price": [
        {
          "cost": 2300000,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [],
      "key_facts": [
        "4,435 sq ft lot",
        "Very walkable"
      ],
      "badge_sold": ""
    },
    {
      "address": "29 E Cottage, Boston, MA 02125",
      "phone": "",
      "number_beds": "7 beds",
      "number_baths": "3 baths",
      "sq_ft": "2,832 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/379/genIslnoResize.73335379_0.jpg",
      "price": [
        {
          "cost": 1050000,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [],
      "key_facts": [
        "3,717 sq ft lot",
        "Very walkable"
      ],
      "badge_sold": ""
    },
    {
      "address": "79 Parkton Rd #1, Boston, MA 02130",
      "phone": "",
      "number_beds": "3 beds",
      "number_baths": "2 baths",
      "sq_ft": "1,033 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/309/genIslnoResize.73335309_0.jpg",
      "price": [
        {
          "cost": 749900,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [],
      "key_facts": [
        "$215 HOA",
        "Very walkable"
      ],
      "badge_sold": ""
    },
    {
      "address": "39 Juliette St #3, Boston, MA 02122",
      "phone": "",
      "number_beds": "3 beds",
      "number_baths": "3 baths",
      "sq_ft": "1,386 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/296/genIslnoResize.73335296_0.jpg",
      "price": [
        {
          "cost": 730000,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [],
      "key_facts": [
        "1,386 sq ft lot",
        "$250 HOA",
        "Garage"
      ],
      "badge_sold": ""
    },
    {
      "address": "38 Kappius Path, Newton, MA 02459",
      "phone": "",
      "number_beds": "6 beds",
      "number_baths": "6.5 baths",
      "sq_ft": "5,500 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/226/genIslnoResize.73335226_0.jpg",
      "price": [
        {
          "cost": 2795000,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [],
      "key_facts": [
        "7,000 sq ft lot",
        "2 garage spots",
        "Car-dependent"
      ],
      "badge_sold": ""
    },
    {
      "address": "10 Briarcliff Ter, Boston, MA 02126",
      "phone": "",
      "number_beds": "4 beds",
      "number_baths": "3 baths",
      "sq_ft": "1,756 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/057/genIslnoResize.73335057_0.jpg",
      "price": [
        {
          "cost": 580000,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [],
      "key_facts": [
        "0.32 acre lot",
        "Car-dependent"
      ],
      "badge_sold": ""
    },
    {
      "address": "17 Thompson St, Boston, MA 02136",
      "phone": "",
      "number_beds": "4 beds",
      "number_baths": "2.5 baths",
      "sq_ft": "1,860 sq ft",
      "thumbnail_img_url": "https://ssl.cdn-redfin.com/photo/52/islphoto/015/genIslnoResize.73335015_1.jpg",
      "price": [
        {
          "cost": 899000,
          "currency": "USD",
          "charge-rate": "one-time",
          "deal": ""
        }
      ],
      "badge": [],
      "key_facts": [
        "6,250 sq ft lot",
        "Community pool",
        "Somewhat walkable"
      ],
      "badge_sold": ""
    },
  ]
}
.......................................................