Redfin 'For Rent' Listings API
This endpoint will retrieve listing information from a single 'For Rent' property listing 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",
:raw => "RAW",
}
uri = URI('https://api.scraperapi.com/structured/redfin/forrent')
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 page. The URL has to be the URL of a property for rent.
country_code
Allows you to geotarget the request. Use this parameter if you want Redfin to be scraped from a specific country.
TLD
raw
This is a boolean param - true or false
If the raw parameter is set to true, the raw data will be extracted from the page without further parsing.
Important: The structure of the data in raw mode cannot be guaranteed, it’s a tradeoff: You get a lot more information back, but the structure of the response may change if Redfin modifies their page layout.
Sample Response
{
"url": "https://www.redfin.com/MD/Baltimore/Domain-Brewers-Hill/apartment/45425151",
"type": "for_rent",
"name": "Domain Brewers Hill",
"map_url": "https://maps.google.com/maps/api/staticmap?sensor=false&style=feature%3Aadministrative.land_parcel%7Cvisibility%3Aoff&style=feature%3Alandscape.man_made%7Cvisibility%3Aoff&style=feature%3Atransit.station%7Chue%3A0xffa200¢er=39.2789921%2C-76.566816&channel=seekers-search_map&size=574x430&format=jpg&scale=2&zoom=11&client=gme-redfin&signature=OLlnwknVzX_j_5CTXqaRKUQ-3kY=",
"bed_min": 1,
"bed_max": 2,
"bath_min": 1,
"bath_max": 2,
"price_min": 1894,
"price_max": 3003,
"sqft_min": 723,
"sqft_max": 1417,
"description": "Domain Brewers Hill offers apartments in Baltimore with stunning views, modern finishes, and great amenities. Choose from furnished or unfurnished apartments featuring wood plank flooring, in-home was",
"available_units": 10,
"address": {
"street_line": "1200 S Conkling St",
"city": "Baltimore",
"state": "MD",
"zip": "21224"
},
"last_updated": "2025-03-04T12:45:30.733106Z",
"image_urls": [
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/0_7.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/1_6.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/2_6.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/3_5.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/4_5.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/5_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/6_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/7_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/8_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/9_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/10_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/11_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/12_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/13_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/14_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/15_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/16_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/17_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/18_5.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/19_8.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/20_6.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/21_6.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/22_6.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/23_7.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/24_7.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/25_7.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/26_7.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/27_7.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/28_4.jpg",
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/29_4.jpg"
],
"floor_plans": [
{
"name": "522",
"unit_type": {
"unit_type_id": "a45be046-1b13-4152-8784-e2f7d896dbc2",
"units": [
{
"unit_id": "addb1b30-cc12-46e9-b294-64de7b987a66",
"bedrooms": 1,
"date_available": "2025-05-25T00:00:00Z",
"deposit": 500,
"deposit_currency": "USD",
"floor": 5,
"full_baths": 1,
"half_baths": 0,
"name": "522",
"rent_currency": "USD",
"rent_price": 2558,
"sqft": 1246,
"status": "upcoming"
}
],
"available_lease_terms": [
"3-Month",
"6-Month",
"7-Month",
"9-Month",
"12-Month",
"13-Month"
],
"available_photos": [
{
"start_pos": 0,
"end_pos": 0,
"version": "2"
}
],
"available_units": 1,
"bedrooms": 1,
"date_available": "2025-05-25T00:00:00Z",
"full_baths": 1,
"half_baths": 0,
"name": "Plan E (A1E)",
"rent_price_max": 2558,
"rent_price_min": 2558,
"sqft_max": 1246,
"sqft_min": 1246,
"status": "upcoming",
"style": "Plan E (A1E)",
"total_units": 1
},
"bedroom_title": "1 Bed",
"available": true,
"unit_id": "addb1b30-cc12-46e9-b294-64de7b987a66",
"bedrooms": 1,
"date_available": "2025-05-25T00:00:00Z",
"deposit": 500,
"deposit_currency": "USD",
"floor": 5,
"full_baths": 1,
"half_baths": 0,
"rent_currency": "USD",
"rent_price": 2558,
"sqft": 1246,
"status": "upcoming",
"available_lease_terms": [
"3-Month",
"6-Month",
"7-Month",
"9-Month",
"12-Month",
"13-Month"
],
"available_units": 1,
"rent_price_max": 2558,
"rent_price_min": 2558,
"style": "Plan E (A1E)",
"total_units": 1,
"image_urls": [
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/ut/a45be046-1b13-4152-8784-e2f7d896dbc2/0_2.jpg"
]
},
{
"name": "509",
"unit_type": {
"unit_type_id": "eb1ca7bc-6b96-4865-8b1d-4221f3ad7251",
"units": [
{
"unit_id": "1d3947ef-eb84-4c93-bad5-53ab83f69bb6",
"bedrooms": 1,
"date_available": "2025-04-25T00:00:00Z",
"deposit": 500,
"deposit_currency": "USD",
"floor": 5,
"full_baths": 1,
"half_baths": 0,
"name": "509",
"rent_currency": "USD",
"rent_price": 2368,
"sqft": 981,
"status": "upcoming"
},
{
"unit_id": "4cb8e192-d999-4d69-9c07-2513b6f8f80c",
"bedrooms": 1,
"date_available": "2025-05-07T00:00:00Z",
"deposit": 500,
"deposit_currency": "USD",
"floor": 2,
"full_baths": 1,
"half_baths": 0,
"name": "207",
"rent_currency": "USD",
"rent_price": 2206,
"sqft": 981,
"status": "upcoming"
}
],
"available_lease_terms": [
"3-Month",
"6-Month",
"7-Month",
"9-Month",
"12-Month",
"13-Month"
],
"available_photos": [
{
"start_pos": 0,
"end_pos": 0,
"version": "2"
}
],
"available_units": 2,
"bedrooms": 1,
"date_available": "2025-04-25T00:00:00Z",
"full_baths": 1,
"half_baths": 0,
"name": "Plan B (A1B)",
"rent_price_max": 2368,
"rent_price_min": 2206,
"sqft_max": 981,
"sqft_min": 981,
"status": "upcoming",
"style": "Plan B (A1B)",
"total_units": 2
},
"bedroom_title": "1 Bed",
"available": true,
"unit_id": "1d3947ef-eb84-4c93-bad5-53ab83f69bb6",
"bedrooms": 1,
"date_available": "2025-04-25T00:00:00Z",
"deposit": 500,
"deposit_currency": "USD",
"floor": 5,
"full_baths": 1,
"half_baths": 0,
"rent_currency": "USD",
"rent_price": 2368,
"sqft": 981,
"status": "upcoming",
"available_lease_terms": [
"3-Month",
"6-Month",
"7-Month",
"9-Month",
"12-Month",
"13-Month"
],
"available_units": 2,
"rent_price_max": 2368,
"rent_price_min": 2206,
"style": "Plan B (A1B)",
"total_units": 2,
"image_urls": [
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/ut/eb1ca7bc-6b96-4865-8b1d-4221f3ad7251/0_2.jpg"
]
},
{
"name": "207",
"unit_type": {
"unit_type_id": "eb1ca7bc-6b96-4865-8b1d-4221f3ad7251",
"units": [
{
"unit_id": "1d3947ef-eb84-4c93-bad5-53ab83f69bb6",
"bedrooms": 1,
"date_available": "2025-04-25T00:00:00Z",
"deposit": 500,
"deposit_currency": "USD",
"floor": 5,
"full_baths": 1,
"half_baths": 0,
"name": "509",
"rent_currency": "USD",
"rent_price": 2368,
"sqft": 981,
"status": "upcoming"
},
{
"unit_id": "4cb8e192-d999-4d69-9c07-2513b6f8f80c",
"bedrooms": 1,
"date_available": "2025-05-07T00:00:00Z",
"deposit": 500,
"deposit_currency": "USD",
"floor": 2,
"full_baths": 1,
"half_baths": 0,
"name": "207",
"rent_currency": "USD",
"rent_price": 2206,
"sqft": 981,
"status": "upcoming"
}
],
"available_lease_terms": [
"3-Month",
"6-Month",
"7-Month",
"9-Month",
"12-Month",
"13-Month"
],
"available_photos": [
{
"start_pos": 0,
"end_pos": 0,
"version": "2"
}
],
"available_units": 2,
"bedrooms": 1,
"date_available": "2025-04-25T00:00:00Z",
"full_baths": 1,
"half_baths": 0,
"name": "Plan B (A1B)",
"rent_price_max": 2368,
"rent_price_min": 2206,
"sqft_max": 981,
"sqft_min": 981,
"status": "upcoming",
"style": "Plan B (A1B)",
"total_units": 2
},
"bedroom_title": "1 Bed",
"available": true,
"unit_id": "4cb8e192-d999-4d69-9c07-2513b6f8f80c",
"bedrooms": 1,
"date_available": "2025-05-07T00:00:00Z",
"deposit": 500,
"deposit_currency": "USD",
"floor": 2,
"full_baths": 1,
"half_baths": 0,
"rent_currency": "USD",
"rent_price": 2206,
"sqft": 981,
"status": "upcoming",
"available_lease_terms": [
"3-Month",
"6-Month",
"7-Month",
"9-Month",
"12-Month",
"13-Month"
],
"available_units": 2,
"rent_price_max": 2368,
"rent_price_min": 2206,
"style": "Plan B (A1B)",
"total_units": 2,
"image_urls": [
"https://ssl.cdn-redfin.com/photo/rent/1bfa1fde-0036-468e-99d5-cee19e9bfc0d/bigphoto/ut/eb1ca7bc-6b96-4865-8b1d-4221f3ad7251/0_2.jpg"
]
},
...
{
"name": "Digital Harbor High School",
"address": "1100 Covington St, Baltimore, MD 21230",
"url": "https://www.redfin.com/school/88481/MD/Baltimore/Digital-Harbor-High-School",
"review_count": 10,
"great_schools_rating": 1,
"great_school_url": "https://www.greatschools.org/maryland/baltimore/2049-Digital-Harbor-High-School/",
"parent_rating": 2,
"distance_in_miles": "2.2",
"grade_ranges": "9-12",
"institution_type": "Public",
"number_of_students": 1315,
"student_to_teacher_ratio": 17
}
]
}Last updated
Was this helpful?