How to scrape Redfin
Redfin (redfin.com) is a real estate listings site. This guide is built from our own checks of its public pages: what the pages contain, whether our requests get through right now, and the request settings that worked.
Ujeebu scrapes any public website. Not listed here? Try any URL in the Playground or ask us about a site.
12 of 21 of our checks passed in the last 7 days (57.1%).
Last check 2026-11-22 20:02 UTC · last pass 2026-11-22 13:33 UTC · checked with our own requests, never customer data.
Recipe one call
Use the Redfin recipe: send the URL, get JSON
curl -G 'https://api.ujeebu.com/scrape' \
-H "ApiKey: $UJEEBU_API_KEY" \
--data-urlencode 'url=https://www.redfin.com/city/5155/CO/Denver' \
--data-urlencode 'recipe=redfin/listing'
The answer is {"result": {...}} with the fields of the recipe. Billed like any /scrape call: successful responses cost credits; blocked, timed-out and failed requests are free.
Run the code on this page with your own key: 5,000 free credits for 7 days, no card. Get a free API key →
Recipes
Call a recipe by name with the recipe parameter: the Scrape API applies its extract rules and the settings that work on Redfin. Each recipe was run on two real Redfin pages and keeps only the fields that came back on both; it is checked again every week, and hidden if it stops working.
Search and listing pages
Validated 2026-11-19One call: recipe=redfin/listing 5 credits (JS) a page
curl -G 'https://api.ujeebu.com/scrape' \
-H "ApiKey: $UJEEBU_API_KEY" \
--data-urlencode 'url=https://www.redfin.com/city/5155/CO/Denver' \
--data-urlencode 'recipe=redfin/listing'
The answer is {"result": {...}} with the fields below; the Ujb-Recipe header names the version (for example redfin/listing@v1) and Ujb-Credits the cost.
Search with parameters: zip, sort
No URL needed: send recipe=redfin/search with the parameters below. The API builds the search URL (returned in the Ujb-Url header and the url field), applies the redfin/listing recipe and answers the same JSON, at the same credits.
| Parameter | Type | What it is |
|---|---|---|
zip * | text | US ZIP code. |
sort | recommended | newest | price_low | price_high | Sort order: recommended (the default), newest, price_low or price_high. Default: recommended. |
One call, for {"zip":"80202"}:
curl -G 'https://api.ujeebu.com/scrape' \
-H 'ApiKey: YOUR_API_KEY' \
-d 'recipe=redfin/search' \
-d 'zip=80202'
A missing or invalid parameter answers 400 with param naming it (not billed). Try it in the Playground or the Request builder (Search mode). Have the URL already? url=https://www.redfin.com/zipcode/80202 with recipe=redfin/listing works too. Search in the docs
What this recipe extracts
| Field | Type | Example |
|---|---|---|
listings | list of 3+ items | |
listings[].url | URL | https://www.redfin.com/CO/Denver/8707-E-Florida-Ave-80247/unit-102/... |
listings[].title | text | 8707 E Florida Ave #102, Denver, CO 80247 |
listings[].price | text | $255,000 |
listings[].beds | text | 2 beds |
listings[].baths | text | 2 baths |
listings[].area | text | 996 sq ft |
listings[].image | image URL | https://ssl.cdn-redfin.com/photo/94/islphoto/066/genIslnoResize.642... |
Examples from www.redfin.com/city/5155/CO/Denver on 2026-11-19, shortened.
Sample output (real, trimmed)
{
"listings": [
{
"url": "https://www.redfin.com/CO/Denver/3217-N-Monaco-Street-Pkwy-80207/home/34045605",
"title": "3217 N Monaco Street Pkwy, Denver, CO 80207",
"price": "$695,000",
"beds": "5 beds",
"baths": "4 baths",
"area": "2,444 sq ft",
"image": "https://ssl.cdn-redfin.com/photo/94/islphoto/974/genIslnoResize.3304974_0.webp"
},
{
"url": "https://www.redfin.com/CO/Denver/Undisclosed-address-80238/home/34009037",
"title": "Undisclosed address, Denver, CO 80238",
"price": "$450,000",
"beds": "2 beds",
"baths": "3 baths",
"area": "1,537 sq ft",
"image": "https://ssl.cdn-redfin.com/photo/641/islphoto/833/genIslnoResize.2237849959914825833_0.webp"
},
{
"url": "https://www.redfin.com/CO/Lakewood/1986-S-Vance-Ln-80227/home/177103131",
"title": "1986 S Vance Ln, Lakewood, CO 80227",
"price": "$535,000",
"beds": "2 beds",
"baths": "2 baths",
"area": "1,436 sq ft",
"image": "https://ssl.cdn-redfin.com/system_files/media/1292374_JPG/genDesktopMapHomeCardUrl/item_3.webp"
}
]
}
extract_rules (1 rule): the rules behind the recipe
The API applies these rules and the settings js=true for you when you send recipe=redfin/listing. To change what comes back, send your own extract_rules (they replace the recipe's) or any setting (yours always win). Sites without a recipe work the same way with extract rules.
{
"listings": {
"selector": "div.MapHomeCardReact.MapHomeCard",
"type": "obj",
"multiple": true,
"children": {
"url": {
"selector": "a.bp-Homecard__Address",
"type": "link"
},
"title": {
"selector": ".bp-Homecard",
"type": "attr",
"attribute": "title"
},
"price": {
"selector": ".bp-Homecard__Price--value",
"type": "text"
},
"beds": {
"selector": ".bp-Homecard__Stats--beds",
"type": "text"
},
"baths": {
"selector": ".bp-Homecard__Stats--baths",
"type": "text"
},
"area": {
"selector": ".bp-Homecard__Stats--sqft",
"type": "text"
},
"image": {
"selector": ".bp-Homecard__Photo--image",
"type": "image"
}
}
}
}
Property pages
Validated 2026-11-14One call: recipe=redfin/detail 5 credits (JS) a page
curl -G 'https://api.ujeebu.com/scrape' \
-H "ApiKey: $UJEEBU_API_KEY" \
--data-urlencode 'url=https://www.redfin.com/CO/Denver/10150-E-Virginia-Ave-80247/unit-108/home/45369738' \
--data-urlencode 'recipe=redfin/detail'
The answer is {"result": {...}} with the fields below; the Ujb-Recipe header names the version (for example redfin/detail@v1) and Ujb-Credits the cost.
What this recipe extracts
| Field | Type | Example |
|---|---|---|
product.availability | text | InStock |
product.currency | text | USD |
product.name | text | 10150 E Virginia Ave #108 |
product.price | number | 199000 |
product.url | URL | https://www.redfin.com/CO/Denver/10150-E-Virginia-Ave-80247/unit-10... |
home.address | text | 10150 E Virginia Ave #108, Denver, CO 80247 |
home.area | number | 943 |
home.area_unit | text | sqft |
home.beds | number | 2 |
home.city | text | Denver |
home.currency | text | USD |
home.description | text | A comfortable and updated ground-floor condo with a private garage... |
home.hoa_dues | text | $368/mo |
home.latitude | number | 39.7062068 |
home.longitude | number | -104.8693309 |
home.parking | text | 1 car garage |
home.price | number | 199000 |
home.price_per_sqft | text | $211 |
home.state | text | CO |
home.street | text | 10150 E Virginia Ave #108 |
home.type | text | Condo |
home.zip | number (as text) | 80247 |
Examples from www.redfin.com/CO/Denver/10150-E-Virginia-Ave-80247/unit-10... on 2026-11-14, shortened.
Sample output (real, trimmed)
{
"home": {
"address": "10150 E Virginia Ave #108, Denver, CO 80247",
"area": 943,
"area_unit": "sqft",
"beds": 2,
"city": "Denver",
"currency": "USD",
"description": "A comfortable and updated ground-floor condo with a private garage in the Oak Park community, with access to the High Line Canal Trail right outside your doo...",
"hoa_dues": "$368/mo",
"latitude": 39.7062068,
"longitude": -104.8693309,
"parking": "1 car garage",
"price": 199000,
"price_per_sqft": "$211",
"state": "CO",
"street": "10150 E Virginia Ave #108",
"type": "Condo",
"zip": "80247"
},
"product": {
"availability": "InStock",
"currency": "USD",
"name": "10150 E Virginia Ave #108",
"price": 199000,
"url": "https://www.redfin.com/CO/Denver/10150-E-Virginia-Ave-80247/unit-108/home/45369738"
}
}
extract_rules (2 rules): the rules behind the recipe
The API applies these rules and the settings js=true for you when you send recipe=redfin/detail. To change what comes back, send your own extract_rules (they replace the recipe's) or any setting (yours always win). Sites without a recipe work the same way with extract rules.
{
"product": {
"type": "fn",
"fn": "const T = ['Product', 'ProductGroup', 'IndividualProduct', 'Vehicle', 'Car']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { availability: all(g('offers.availability')), currency: all(g('offers.priceCurrency|offers.priceSpecification.priceCurrency')), name: all(g('name')), price: all(g('offers.price|offers.lowPrice|offers.priceSpecification.price')), url: one(g('url|offers.url')) };"
},
"home": {
"type": "fn",
"fn": "const __r = (() => { const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).includes('RealEstateListing')); const kd = {}; document.querySelectorAll('.keyDetails-row').forEach(r => { const v = r.querySelector('.valueText'); const t = r.querySelector('.valueType'); if (v && t) kd[t.textContent.trim().toLowerCase()] = v.textContent.trim(); }); if (!n) return null; const e = n.mainEntity || {}; const a = e.address || {}; const fs = e.floorSize || {}; const imgs = [].concat(e.image || n.image || []).map(i => typeof i === 'string' ? i : i && i.url).filter(Boolean).slice(0, 12); return { address: [a.streetAddress, a.addressLocality, a.addressRegion].filter(Boolean).join(', ') + (a.postalCode ? ' ' + a.postalCode : ''), street: a.streetAddress || null, city: a.addressLocality || null, state: a.addressRegion || null, zip: a.postalCode || null, price: n.offers ? n.offers.price : null, currency: n.offers ? n.offers.priceCurrency : null, beds: e.numberOfBedrooms ?? null, baths: e.numberOfBathroomsTotal ?? null, area: fs.value ?? null, area_unit: fs.unitText === 'FTK' ? 'sqft' : (fs.unitText || null), type: kd['property type'] || e.accommodationCategory || e['@type'] || null, year_built: e.yearBuilt ?? null, price_per_sqft: kd['price/sq.ft.'] || null, hoa_dues: kd['hoa dues'] || null, parking: kd['parking'] || null, lot_size: kd['lot size'] || null, listed: n.datePosted || null, latitude: e.geo ? e.geo.latitude : null, longitude: e.geo ? e.geo.longitude : null, description: n.description || null, images: imgs.length ? imgs : null }; })(); if (!__r) return null; const __o = {}; for (const k of [\"address\",\"area\",\"area_unit\",\"beds\",\"city\",\"currency\",\"description\",\"hoa_dues\",\"latitude\",\"longitude\",\"parking\",\"price\",\"price_per_sqft\",\"state\",\"street\",\"type\",\"zip\"]) if (__r[k] !== undefined && __r[k] !== null) __o[k] = __r[k]; return __o;"
}
}
Code
Complete scripts: set the UJEEBU_API_KEY environment variable and run them as they are. Each one calls the recipe by name (the Go SDK has no recipe field, so the Go script sends the recipe's rules and settings itself), prints the extracted JSON, and prints the credits the request cost (the Ujb-Credits response header) on stderr. A non-200 answer stops the script with the API's error message.
Search and listing pages
Runs the recipe on the two pages it was validated on, one after the other.
pip install ujeebu-python==0.1.5 # Scrape Redfin search and listing pages with the Ujeebu Scrape API.
# Calls the recipe redfin/listing: the API applies its extract rules and validated settings (validated 2026-11-19). Send extract_rules or any setting to override them.
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 redfin_listing_sdk.py
import json
import os
import sys
import time
import requests
from ujeebu_python import UjeebuClient
API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
"https://www.redfin.com/city/5155/CO/Denver",
"https://www.redfin.com/city/29470/IL/Chicago",
]
RECIPE = "redfin/listing" # rules and settings come from the recipe; add your own to override them
def scrape(client, url):
# a GET with recipe=: the API applies the recipe and answers {"result": {...}}
try:
response = client.scrape(url, params={"recipe": RECIPE})
except requests.RequestException as error:
sys.exit(f"Request failed for {url}: {error}")
if response.status_code != 200:
try:
message = response.json().get("message", response.text)
except ValueError:
message = response.text
sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}, Ujb-Recipe: {response.headers.get('Ujb-Recipe')}", file=sys.stderr)
return response.json()["result"]
if not API_KEY:
sys.exit("Set the UJEEBU_API_KEY environment variable.")
client = UjeebuClient(api_key=API_KEY)
for i, url in enumerate(URLS):
if i:
time.sleep(2) # be polite: one page at a time
result = scrape(client, url)
for item in result.get("listings") or []:
print(item.get("title"), item.get("price"), item.get("beds"))
# Example output:
# 3217 N Monaco Street Pkwy, Denver, CO... $695,000 5 beds
# Undisclosed address, Denver, CO 80238 $450,000 2 beds
# every field: print(json.dumps(result, indent=2, ensure_ascii=False))
npm install @ujeebu-org/ujeebu-sdk@0.1.2 // Scrape Redfin search and listing pages with the Ujeebu Scrape API.
// Calls the recipe redfin/listing: the API applies its extract rules and validated settings (validated 2026-11-19). Send extract_rules or any setting to override them.
// Uses the official SDK @ujeebu-org/ujeebu-sdk 0.1.2: npm install @ujeebu-org/ujeebu-sdk@0.1.2
// Run: UJEEBU_API_KEY=your_key node redfin_listing_sdk.mjs
import { UjeebuClient } from '@ujeebu-org/ujeebu-sdk';
const API_KEY = process.env.UJEEBU_API_KEY;
const URLS = [
"https://www.redfin.com/city/5155/CO/Denver",
"https://www.redfin.com/city/29470/IL/Chicago",
];
const RECIPE = "redfin/listing"; // rules and settings come from the recipe; add your own to override them
async function scrape(client, url) {
let res;
try {
// a GET with recipe=: the API applies the recipe and answers { result: {...} }
res = await client.scrape(url, { recipe: RECIPE });
} catch (err) {
const status = err.response?.status ?? 'error';
const message = err.response?.data?.message ?? err.message;
console.error(`HTTP ${status} for ${url}: ${String(message).slice(0, 300)}`);
process.exit(1);
}
console.error(`Ujb-Credits: ${res.headers['ujb-credits']}, Ujb-Recipe: ${res.headers['ujb-recipe']}`);
return res.data.result;
}
if (!API_KEY) {
console.error('Set the UJEEBU_API_KEY environment variable.');
process.exit(1);
}
const client = new UjeebuClient(API_KEY);
const pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
for (const [i, url] of URLS.entries()) {
if (i) await pause(2000); // be polite: one page at a time
const result = await scrape(client, url);
for (const item of (result?.listings ?? [])) {
console.log(item.title, item.price, item.beds);
}
// Example output:
// 3217 N Monaco Street Pkwy, Denver, CO... $695,000 5 beds
// Undisclosed address, Denver, CO 80238 $450,000 2 beds
// every field: console.log(JSON.stringify(result, null, 2));
}
pip install requests # Scrape Redfin search and listing pages with the Ujeebu Scrape API.
# Calls the recipe redfin/listing: the API applies its extract rules and validated settings (validated 2026-11-19). Send extract_rules or any setting to override them.
# Run: UJEEBU_API_KEY=your_key python3 redfin_listing.py (pip install requests)
import json
import os
import sys
import time
import requests
API_URL = "https://api.ujeebu.com/scrape"
API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
"https://www.redfin.com/city/5155/CO/Denver",
"https://www.redfin.com/city/29470/IL/Chicago",
]
RECIPE = "redfin/listing" # rules and settings come from the recipe; add your own to override them
def scrape(url):
response = requests.get(
API_URL,
headers={"ApiKey": API_KEY},
params={"url": url, "recipe": RECIPE},
timeout=180,
)
if response.status_code != 200:
try:
message = response.json().get("message", response.text)
except ValueError:
message = response.text
sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}, Ujb-Recipe: {response.headers.get('Ujb-Recipe')}", file=sys.stderr)
return response.json()["result"]
if not API_KEY:
sys.exit("Set the UJEEBU_API_KEY environment variable.")
for i, url in enumerate(URLS):
if i:
time.sleep(2) # be polite: one page at a time
result = scrape(url)
for item in result.get("listings") or []:
print(item.get("title"), item.get("price"), item.get("beds"))
# Example output:
# 3217 N Monaco Street Pkwy, Denver, CO... $695,000 5 beds
# Undisclosed address, Denver, CO 80238 $450,000 2 beds
# every field: print(json.dumps(result, indent=2, ensure_ascii=False))
// Scrape Redfin search and listing pages with the Ujeebu Scrape API.
// Calls the recipe redfin/listing: the API applies its extract rules and validated settings (validated 2026-11-19). Send extract_rules or any setting to override them.
// Run: UJEEBU_API_KEY=your_key node redfin_listing.mjs (Node.js 18 or later)
const API_URL = 'https://api.ujeebu.com/scrape';
const API_KEY = process.env.UJEEBU_API_KEY;
const URLS = [
"https://www.redfin.com/city/5155/CO/Denver",
"https://www.redfin.com/city/29470/IL/Chicago",
];
const RECIPE = "redfin/listing"; // rules and settings come from the recipe; add your own to override them
async function scrape(url) {
const params = new URLSearchParams({ url, recipe: RECIPE });
const res = await fetch(`${API_URL}?${params}`, {
headers: { ApiKey: API_KEY },
signal: AbortSignal.timeout(180000),
});
const text = await res.text();
if (res.status !== 200) {
let message = text;
try {
message = JSON.parse(text).message ?? text;
} catch {}
console.error(`HTTP ${res.status} for ${url}: ${String(message).slice(0, 300)}`);
process.exit(1);
}
console.error(`Ujb-Credits: ${res.headers.get('ujb-credits')}, Ujb-Recipe: ${res.headers.get('ujb-recipe')}`);
return JSON.parse(text).result;
}
if (!API_KEY) {
console.error('Set the UJEEBU_API_KEY environment variable.');
process.exit(1);
}
const pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
for (const [i, url] of URLS.entries()) {
if (i) await pause(2000); // be polite: one page at a time
const result = await scrape(url);
for (const item of (result?.listings ?? [])) {
console.log(item.title, item.price, item.beds);
}
// Example output:
// 3217 N Monaco Street Pkwy, Denver, CO... $695,000 5 beds
// Undisclosed address, Denver, CO 80238 $450,000 2 beds
// every field: console.log(JSON.stringify(result, null, 2));
}
#!/usr/bin/env bash
# Scrape Redfin search and listing pages with the Ujeebu Scrape API.
# Calls the recipe redfin/listing: the API applies its extract rules and validated settings (validated 2026-11-19). Send extract_rules or any setting to override them.
# Run: UJEEBU_API_KEY=your_key bash redfin_listing.sh (curl 7.76 or later)
set -euo pipefail
curl -sS --fail-with-body --max-time 180 -D headers.txt -G 'https://api.ujeebu.com/scrape' \
-H "ApiKey: ${UJEEBU_API_KEY:?Set the UJEEBU_API_KEY environment variable.}" \
--data-urlencode 'url=https://www.redfin.com/city/5155/CO/Denver' \
--data-urlencode 'recipe=redfin/listing'
echo
grep -i -E '^ujb-(credits|recipe)' headers.txt >&2
<?php
// Scrape Redfin search and listing pages with the Ujeebu Scrape API.
// Calls the recipe redfin/listing: the API applies its extract rules and validated settings (validated 2026-11-19). Send extract_rules or any setting to override them.
// Run: UJEEBU_API_KEY=your_key php redfin_listing.php (PHP 7.4 or later with curl)
$apiKey = getenv('UJEEBU_API_KEY') ?: exit("Set the UJEEBU_API_KEY environment variable.\n");
$urls = [
'https://www.redfin.com/city/5155/CO/Denver',
'https://www.redfin.com/city/29470/IL/Chicago',
];
$recipe = 'redfin/listing'; // rules and settings come from the recipe; add your own to override them
function scrape(string $url, string $apiKey, string $recipe)
{
$ch = curl_init('https://api.ujeebu.com/scrape?' . http_build_query(['url' => $url, 'recipe' => $recipe]));
$headers = [];
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 180,
CURLOPT_HTTPHEADER => ['ApiKey: ' . $apiKey],
CURLOPT_HEADERFUNCTION => function ($ch, $line) use (&$headers) {
if (strpos($line, ':') !== false) {
[$k, $v] = explode(':', $line, 2);
$headers[strtolower(trim($k))] = trim($v);
}
return strlen($line);
},
]);
$body = curl_exec($ch);
if ($body === false) {
fwrite(STDERR, 'Request failed: ' . curl_error($ch) . "\n");
exit(1);
}
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status !== 200) {
$message = json_decode($body, true)['message'] ?? $body;
fwrite(STDERR, "HTTP $status for $url: " . substr((string) $message, 0, 300) . "\n");
exit(1);
}
fwrite(STDERR, 'Ujb-Credits: ' . ($headers['ujb-credits'] ?? '?') . ', Ujb-Recipe: ' . ($headers['ujb-recipe'] ?? '?') . "\n");
return json_decode($body, true)['result'];
}
foreach ($urls as $i => $url) {
if ($i > 0) {
sleep(2); // be polite: one page at a time
}
$result = scrape($url, $apiKey, $recipe);
foreach ($result['listings'] ?? [] as $item) {
echo implode(' ', [$item['title'] ?? '', $item['price'] ?? '', $item['beds'] ?? '']), "\n";
}
// Example output:
// 3217 N Monaco Street Pkwy, Denver, CO... $695,000 5 beds
// Undisclosed address, Denver, CO 80238 $450,000 2 beds
// every field: echo json_encode($result, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE), "\n";
}
go mod init scraper && go get github.com/ujeebu/ujeebu-go@v0.1.8 // Scrape Redfin search and listing pages with the Ujeebu Scrape API.
// Sends the extract rules and settings of the recipe redfin/listing itself: the Go SDK v0.1.8 has no recipe field and always sends js, which would override the recipe.
// Uses the official SDK github.com/ujeebu/ujeebu-go v0.1.8: go mod init scraper && go get github.com/ujeebu/ujeebu-go@v0.1.8
// Run: UJEEBU_API_KEY=your_key go run redfin_listing.go
package main
import (
"encoding/json"
"errors"
"fmt"
"os"
"time"
ujeebu "github.com/ujeebu/ujeebu-go"
)
var urls = []string{
"https://www.redfin.com/city/5155/CO/Denver",
"https://www.redfin.com/city/29470/IL/Chicago",
}
// The extract rules of the recipe, as the JSON the API takes.
const extractRulesJSON = `{
"listings": {
"selector": "div.MapHomeCardReact.MapHomeCard",
"type": "obj",
"multiple": true,
"children": {
"url": {
"selector": "a.bp-Homecard__Address",
"type": "link"
},
"title": {
"selector": ".bp-Homecard",
"type": "attr",
"attribute": "title"
},
"price": {
"selector": ".bp-Homecard__Price--value",
"type": "text"
},
"beds": {
"selector": ".bp-Homecard__Stats--beds",
"type": "text"
},
"baths": {
"selector": ".bp-Homecard__Stats--baths",
"type": "text"
},
"area": {
"selector": ".bp-Homecard__Stats--sqft",
"type": "text"
},
"image": {
"selector": ".bp-Homecard__Photo--image",
"type": "image"
}
}
}
}`
var extractRules map[string]any
func fail(format string, args ...any) {
fmt.Fprintf(os.Stderr, format+"\n", args...)
os.Exit(1)
}
func short(s string) string {
if len(s) > 300 {
return s[:300]
}
return s
}
func params(target string) ujeebu.ScrapeParams {
p := ujeebu.ScrapeParams{URL: target}
p.JS = true
p.ExtractRules = extractRules
return p
}
func scrape(client *ujeebu.Client, target string) map[string]any {
// the int is the credits the request cost (the Ujb-Credits header), not an HTTP status
resp, credits, err := client.Scrape(params(target))
if err != nil {
var apiErr *ujeebu.APIError
if errors.As(err, &apiErr) {
fail("HTTP %d for %s: %s", apiErr.StatusCode, target, short(apiErr.Message))
}
fail("Request failed for %s: %v", target, err)
}
fmt.Fprintf(os.Stderr, "Ujb-Credits: %d\n", credits)
result, _ := resp.Result.(map[string]any)
return result
}
func printJSON(v any) {
enc := json.NewEncoder(os.Stdout)
enc.SetEscapeHTML(false)
enc.SetIndent("", " ")
if err := enc.Encode(v); err != nil {
fail("Cannot print the result: %v", err)
}
}
func main() {
apiKey := os.Getenv("UJEEBU_API_KEY")
if apiKey == "" {
fail("Set the UJEEBU_API_KEY environment variable.")
}
if err := json.Unmarshal([]byte(extractRulesJSON), &extractRules); err != nil {
fail("Bad extract rules: %v", err)
}
client, err := ujeebu.NewClient(apiKey, ujeebu.WithTimeout(180*time.Second))
if err != nil {
fail("%v", err)
}
for i, target := range urls {
if i > 0 {
time.Sleep(2 * time.Second) // be polite: one page at a time
}
printJSON(scrape(client, target))
}
}
Property pages
Runs the recipe on the two pages it was validated on, one after the other.
pip install ujeebu-python==0.1.5 # Scrape Redfin property pages with the Ujeebu Scrape API.
# Calls the recipe redfin/detail: the API applies its extract rules and validated settings (validated 2026-11-14). Send extract_rules or any setting to override them.
# Uses the official SDK ujeebu-python 0.1.5: pip install ujeebu-python==0.1.5
# Run: UJEEBU_API_KEY=your_key python3 redfin_detail_sdk.py
import json
import os
import sys
import time
import requests
from ujeebu_python import UjeebuClient
API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
"https://www.redfin.com/CO/Denver/10150-E-Virginia-Ave-80247/unit-108/home/45369738",
"https://www.redfin.com/CO/Denver/620-S-Alton-Way-80247/unit-5B/home/34180803",
]
RECIPE = "redfin/detail" # rules and settings come from the recipe; add your own to override them
def scrape(client, url):
# a GET with recipe=: the API applies the recipe and answers {"result": {...}}
try:
response = client.scrape(url, params={"recipe": RECIPE})
except requests.RequestException as error:
sys.exit(f"Request failed for {url}: {error}")
if response.status_code != 200:
try:
message = response.json().get("message", response.text)
except ValueError:
message = response.text
sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}, Ujb-Recipe: {response.headers.get('Ujb-Recipe')}", file=sys.stderr)
return response.json()["result"]
if not API_KEY:
sys.exit("Set the UJEEBU_API_KEY environment variable.")
client = UjeebuClient(api_key=API_KEY)
for i, url in enumerate(URLS):
if i:
time.sleep(2) # be polite: one page at a time
result = scrape(client, url)
home = result.get("home") or {}
print(home.get("address"), home.get("price"), home.get("beds"), home.get("area"))
# Example output: 10150 E Virginia Ave #108, Denver, CO... 199000 2 943
# every field: print(json.dumps(result, indent=2, ensure_ascii=False))
npm install @ujeebu-org/ujeebu-sdk@0.1.2 // Scrape Redfin property pages with the Ujeebu Scrape API.
// Calls the recipe redfin/detail: the API applies its extract rules and validated settings (validated 2026-11-14). Send extract_rules or any setting to override them.
// Uses the official SDK @ujeebu-org/ujeebu-sdk 0.1.2: npm install @ujeebu-org/ujeebu-sdk@0.1.2
// Run: UJEEBU_API_KEY=your_key node redfin_detail_sdk.mjs
import { UjeebuClient } from '@ujeebu-org/ujeebu-sdk';
const API_KEY = process.env.UJEEBU_API_KEY;
const URLS = [
"https://www.redfin.com/CO/Denver/10150-E-Virginia-Ave-80247/unit-108/home/45369738",
"https://www.redfin.com/CO/Denver/620-S-Alton-Way-80247/unit-5B/home/34180803",
];
const RECIPE = "redfin/detail"; // rules and settings come from the recipe; add your own to override them
async function scrape(client, url) {
let res;
try {
// a GET with recipe=: the API applies the recipe and answers { result: {...} }
res = await client.scrape(url, { recipe: RECIPE });
} catch (err) {
const status = err.response?.status ?? 'error';
const message = err.response?.data?.message ?? err.message;
console.error(`HTTP ${status} for ${url}: ${String(message).slice(0, 300)}`);
process.exit(1);
}
console.error(`Ujb-Credits: ${res.headers['ujb-credits']}, Ujb-Recipe: ${res.headers['ujb-recipe']}`);
return res.data.result;
}
if (!API_KEY) {
console.error('Set the UJEEBU_API_KEY environment variable.');
process.exit(1);
}
const client = new UjeebuClient(API_KEY);
const pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
for (const [i, url] of URLS.entries()) {
if (i) await pause(2000); // be polite: one page at a time
const result = await scrape(client, url);
const home = result?.home ?? {};
console.log(home.address, home.price, home.beds, home.area);
// Example output: 10150 E Virginia Ave #108, Denver, CO... 199000 2 943
// every field: console.log(JSON.stringify(result, null, 2));
}
pip install requests # Scrape Redfin property pages with the Ujeebu Scrape API.
# Calls the recipe redfin/detail: the API applies its extract rules and validated settings (validated 2026-11-14). Send extract_rules or any setting to override them.
# Run: UJEEBU_API_KEY=your_key python3 redfin_detail.py (pip install requests)
import json
import os
import sys
import time
import requests
API_URL = "https://api.ujeebu.com/scrape"
API_KEY = os.environ.get("UJEEBU_API_KEY")
URLS = [
"https://www.redfin.com/CO/Denver/10150-E-Virginia-Ave-80247/unit-108/home/45369738",
"https://www.redfin.com/CO/Denver/620-S-Alton-Way-80247/unit-5B/home/34180803",
]
RECIPE = "redfin/detail" # rules and settings come from the recipe; add your own to override them
def scrape(url):
response = requests.get(
API_URL,
headers={"ApiKey": API_KEY},
params={"url": url, "recipe": RECIPE},
timeout=180,
)
if response.status_code != 200:
try:
message = response.json().get("message", response.text)
except ValueError:
message = response.text
sys.exit(f"HTTP {response.status_code} for {url}: {str(message)[:300]}")
print(f"Ujb-Credits: {response.headers.get('Ujb-Credits')}, Ujb-Recipe: {response.headers.get('Ujb-Recipe')}", file=sys.stderr)
return response.json()["result"]
if not API_KEY:
sys.exit("Set the UJEEBU_API_KEY environment variable.")
for i, url in enumerate(URLS):
if i:
time.sleep(2) # be polite: one page at a time
result = scrape(url)
home = result.get("home") or {}
print(home.get("address"), home.get("price"), home.get("beds"), home.get("area"))
# Example output: 10150 E Virginia Ave #108, Denver, CO... 199000 2 943
# every field: print(json.dumps(result, indent=2, ensure_ascii=False))
// Scrape Redfin property pages with the Ujeebu Scrape API.
// Calls the recipe redfin/detail: the API applies its extract rules and validated settings (validated 2026-11-14). Send extract_rules or any setting to override them.
// Run: UJEEBU_API_KEY=your_key node redfin_detail.mjs (Node.js 18 or later)
const API_URL = 'https://api.ujeebu.com/scrape';
const API_KEY = process.env.UJEEBU_API_KEY;
const URLS = [
"https://www.redfin.com/CO/Denver/10150-E-Virginia-Ave-80247/unit-108/home/45369738",
"https://www.redfin.com/CO/Denver/620-S-Alton-Way-80247/unit-5B/home/34180803",
];
const RECIPE = "redfin/detail"; // rules and settings come from the recipe; add your own to override them
async function scrape(url) {
const params = new URLSearchParams({ url, recipe: RECIPE });
const res = await fetch(`${API_URL}?${params}`, {
headers: { ApiKey: API_KEY },
signal: AbortSignal.timeout(180000),
});
const text = await res.text();
if (res.status !== 200) {
let message = text;
try {
message = JSON.parse(text).message ?? text;
} catch {}
console.error(`HTTP ${res.status} for ${url}: ${String(message).slice(0, 300)}`);
process.exit(1);
}
console.error(`Ujb-Credits: ${res.headers.get('ujb-credits')}, Ujb-Recipe: ${res.headers.get('ujb-recipe')}`);
return JSON.parse(text).result;
}
if (!API_KEY) {
console.error('Set the UJEEBU_API_KEY environment variable.');
process.exit(1);
}
const pause = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
for (const [i, url] of URLS.entries()) {
if (i) await pause(2000); // be polite: one page at a time
const result = await scrape(url);
const home = result?.home ?? {};
console.log(home.address, home.price, home.beds, home.area);
// Example output: 10150 E Virginia Ave #108, Denver, CO... 199000 2 943
// every field: console.log(JSON.stringify(result, null, 2));
}
#!/usr/bin/env bash
# Scrape Redfin property pages with the Ujeebu Scrape API.
# Calls the recipe redfin/detail: the API applies its extract rules and validated settings (validated 2026-11-14). Send extract_rules or any setting to override them.
# Run: UJEEBU_API_KEY=your_key bash redfin_detail.sh (curl 7.76 or later)
set -euo pipefail
curl -sS --fail-with-body --max-time 180 -D headers.txt -G 'https://api.ujeebu.com/scrape' \
-H "ApiKey: ${UJEEBU_API_KEY:?Set the UJEEBU_API_KEY environment variable.}" \
--data-urlencode 'url=https://www.redfin.com/CO/Denver/10150-E-Virginia-Ave-80247/unit-108/home/45369738' \
--data-urlencode 'recipe=redfin/detail'
echo
grep -i -E '^ujb-(credits|recipe)' headers.txt >&2
<?php
// Scrape Redfin property pages with the Ujeebu Scrape API.
// Calls the recipe redfin/detail: the API applies its extract rules and validated settings (validated 2026-11-14). Send extract_rules or any setting to override them.
// Run: UJEEBU_API_KEY=your_key php redfin_detail.php (PHP 7.4 or later with curl)
$apiKey = getenv('UJEEBU_API_KEY') ?: exit("Set the UJEEBU_API_KEY environment variable.\n");
$urls = [
'https://www.redfin.com/CO/Denver/10150-E-Virginia-Ave-80247/unit-108/home/45369738',
'https://www.redfin.com/CO/Denver/620-S-Alton-Way-80247/unit-5B/home/34180803',
];
$recipe = 'redfin/detail'; // rules and settings come from the recipe; add your own to override them
function scrape(string $url, string $apiKey, string $recipe)
{
$ch = curl_init('https://api.ujeebu.com/scrape?' . http_build_query(['url' => $url, 'recipe' => $recipe]));
$headers = [];
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 180,
CURLOPT_HTTPHEADER => ['ApiKey: ' . $apiKey],
CURLOPT_HEADERFUNCTION => function ($ch, $line) use (&$headers) {
if (strpos($line, ':') !== false) {
[$k, $v] = explode(':', $line, 2);
$headers[strtolower(trim($k))] = trim($v);
}
return strlen($line);
},
]);
$body = curl_exec($ch);
if ($body === false) {
fwrite(STDERR, 'Request failed: ' . curl_error($ch) . "\n");
exit(1);
}
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
if ($status !== 200) {
$message = json_decode($body, true)['message'] ?? $body;
fwrite(STDERR, "HTTP $status for $url: " . substr((string) $message, 0, 300) . "\n");
exit(1);
}
fwrite(STDERR, 'Ujb-Credits: ' . ($headers['ujb-credits'] ?? '?') . ', Ujb-Recipe: ' . ($headers['ujb-recipe'] ?? '?') . "\n");
return json_decode($body, true)['result'];
}
foreach ($urls as $i => $url) {
if ($i > 0) {
sleep(2); // be polite: one page at a time
}
$result = scrape($url, $apiKey, $recipe);
$home = $result['home'] ?? [];
echo implode(' ', [$home['address'] ?? '', $home['price'] ?? '', $home['beds'] ?? '', $home['area'] ?? '']), "\n";
// Example output: 10150 E Virginia Ave #108, Denver, CO... 199000 2 943
// every field: echo json_encode($result, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE), "\n";
}
go mod init scraper && go get github.com/ujeebu/ujeebu-go@v0.1.8 // Scrape Redfin property pages with the Ujeebu Scrape API.
// Sends the extract rules and settings of the recipe redfin/detail itself: the Go SDK v0.1.8 has no recipe field and always sends js, which would override the recipe.
// Uses the official SDK github.com/ujeebu/ujeebu-go v0.1.8: go mod init scraper && go get github.com/ujeebu/ujeebu-go@v0.1.8
// Run: UJEEBU_API_KEY=your_key go run redfin_detail.go
package main
import (
"encoding/json"
"errors"
"fmt"
"os"
"time"
ujeebu "github.com/ujeebu/ujeebu-go"
)
var urls = []string{
"https://www.redfin.com/CO/Denver/10150-E-Virginia-Ave-80247/unit-108/home/45369738",
"https://www.redfin.com/CO/Denver/620-S-Alton-Way-80247/unit-5B/home/34180803",
}
// The extract rules of the recipe, as the JSON the API takes.
const extractRulesJSON = `{
"product": {
"type": "fn",
"fn": "const T = ['Product', 'ProductGroup', 'IndividualProduct', 'Vehicle', 'Car']; const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)).flatMap(x => x['@graph'] || [x]); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).some(t => T.includes(t))); if (!n) return null; const g = p => p.split('|').map(q => q.split('.').reduce((v, k) => v == null ? v : (Array.isArray(v) ? v[0] : v)?.[k], n)).find(v => v != null && v !== ''); const all = v => Array.isArray(v) ? v.map(all).filter(x => x != null).join(', ') : (v && typeof v === 'object' ? (v.name ?? v['@id'] ?? null) : (typeof v === 'string' ? v.replace('https://schema.org/', '').replace('http://schema.org/', '') : v ?? null)); const one = v => all(Array.isArray(v) ? v[0] : v); return { availability: all(g('offers.availability')), currency: all(g('offers.priceCurrency|offers.priceSpecification.priceCurrency')), name: all(g('name')), price: all(g('offers.price|offers.lowPrice|offers.priceSpecification.price')), url: one(g('url|offers.url')) };"
},
"home": {
"type": "fn",
"fn": "const __r = (() => { const n = [...document.querySelectorAll('script[type=\"application/ld+json\"]')].flatMap(s => { try { return [].concat(JSON.parse(s.textContent)); } catch (e) { return []; } }).find(x => x && [].concat(x['@type']).includes('RealEstateListing')); const kd = {}; document.querySelectorAll('.keyDetails-row').forEach(r => { const v = r.querySelector('.valueText'); const t = r.querySelector('.valueType'); if (v && t) kd[t.textContent.trim().toLowerCase()] = v.textContent.trim(); }); if (!n) return null; const e = n.mainEntity || {}; const a = e.address || {}; const fs = e.floorSize || {}; const imgs = [].concat(e.image || n.image || []).map(i => typeof i === 'string' ? i : i && i.url).filter(Boolean).slice(0, 12); return { address: [a.streetAddress, a.addressLocality, a.addressRegion].filter(Boolean).join(', ') + (a.postalCode ? ' ' + a.postalCode : ''), street: a.streetAddress || null, city: a.addressLocality || null, state: a.addressRegion || null, zip: a.postalCode || null, price: n.offers ? n.offers.price : null, currency: n.offers ? n.offers.priceCurrency : null, beds: e.numberOfBedrooms ?? null, baths: e.numberOfBathroomsTotal ?? null, area: fs.value ?? null, area_unit: fs.unitText === 'FTK' ? 'sqft' : (fs.unitText || null), type: kd['property type'] || e.accommodationCategory || e['@type'] || null, year_built: e.yearBuilt ?? null, price_per_sqft: kd['price/sq.ft.'] || null, hoa_dues: kd['hoa dues'] || null, parking: kd['parking'] || null, lot_size: kd['lot size'] || null, listed: n.datePosted || null, latitude: e.geo ? e.geo.latitude : null, longitude: e.geo ? e.geo.longitude : null, description: n.description || null, images: imgs.length ? imgs : null }; })(); if (!__r) return null; const __o = {}; for (const k of [\"address\",\"area\",\"area_unit\",\"beds\",\"city\",\"currency\",\"description\",\"hoa_dues\",\"latitude\",\"longitude\",\"parking\",\"price\",\"price_per_sqft\",\"state\",\"street\",\"type\",\"zip\"]) if (__r[k] !== undefined && __r[k] !== null) __o[k] = __r[k]; return __o;"
}
}`
var extractRules map[string]any
func fail(format string, args ...any) {
fmt.Fprintf(os.Stderr, format+"\n", args...)
os.Exit(1)
}
func short(s string) string {
if len(s) > 300 {
return s[:300]
}
return s
}
func params(target string) ujeebu.ScrapeParams {
p := ujeebu.ScrapeParams{URL: target}
p.JS = true
p.ExtractRules = extractRules
return p
}
func scrape(client *ujeebu.Client, target string) map[string]any {
// the int is the credits the request cost (the Ujb-Credits header), not an HTTP status
resp, credits, err := client.Scrape(params(target))
if err != nil {
var apiErr *ujeebu.APIError
if errors.As(err, &apiErr) {
fail("HTTP %d for %s: %s", apiErr.StatusCode, target, short(apiErr.Message))
}
fail("Request failed for %s: %v", target, err)
}
fmt.Fprintf(os.Stderr, "Ujb-Credits: %d\n", credits)
result, _ := resp.Result.(map[string]any)
return result
}
func printJSON(v any) {
enc := json.NewEncoder(os.Stdout)
enc.SetEscapeHTML(false)
enc.SetIndent("", " ")
if err := enc.Encode(v); err != nil {
fail("Cannot print the result: %v", err)
}
}
func main() {
apiKey := os.Getenv("UJEEBU_API_KEY")
if apiKey == "" {
fail("Set the UJEEBU_API_KEY environment variable.")
}
if err := json.Unmarshal([]byte(extractRulesJSON), &extractRules); err != nil {
fail("Bad extract rules: %v", err)
}
client, err := ujeebu.NewClient(apiKey, ujeebu.WithTimeout(180*time.Second))
if err != nil {
fail("%v", err)
}
for i, target := range urls {
if i > 0 {
time.Sleep(2 * time.Second) // be polite: one page at a time
}
printJSON(scrape(client, target))
}
}
SDK tabs use the official Ujeebu SDKs (ujeebu-python 0.1.5, @ujeebu-org/ujeebu-sdk 0.1.2, github.com/ujeebu/ujeebu-go v0.1.8); there is no PHP SDK, so the PHP tab calls the API with curl. For agents and scripts, the same status and settings are at /scrape/redfin.json.
Try it yourself
Run this on Redfin with your own key
Get a free API key, set UJEEBU_API_KEY and run any script above as it is. 5,000 free credits for 7 days, no card.
URL patterns and pagination
What the URLs look like, read from the pages our checks fetched.
Search and listing pages
- Pattern
https://www.redfin.com/city/{id}/{slug}/{slug}- Next pages
- We did not see a next-page link on the pages we fetched. Results may load as you scroll: try
scroll_down. - Validated on
https://www.redfin.com/city/5155/CO/Denverhttps://www.redfin.com/city/29470/IL/Chicago
Property pages
- Pattern
https://www.redfin.com/CO/Denver/{slug}/{id}/home/{id}- Validated on
https://www.redfin.com/CO/Denver/10150-E-Virginia-Ave-80247/unit-108/home/45369738https://www.redfin.com/CO/Denver/620-S-Alton-Way-80247/unit-5B/home/34180803
Settings that work today
From our health checks over the last 7 days: the cheapest settings that return the real page most of the time.
| Endpoint | /scrape |
|---|---|
js | true |
wait_for | 8000 |
| Cost | up to 5 credits a request |
| Learned | js + wait 8000 (found by our retry layer) |
Collect detail page URLs from listing pages first, then fetch each detail page. Our checks pass with JavaScript rendering on (js=true) and a wait of 8 seconds (wait_for=8000) before the snapshot: keep both.
Troubleshooting
The failures our own checks of redfin.com ran into over the last 7 days, and what got the page in the same check.
| What happened | Times | What fixed it |
|---|---|---|
| The site blocked the request (HTTP 403 or a block page) | 4 | None of the settings we tried got past it in 7 days. |
| An empty page | 1 | A retry with wait_for=8000 got the page (1 of 1).
|
What people build with Redfin data
- Market pricesFollow asking prices by city and property size to see where the market moves.More on this use case
- New listings alertsCatch new listings in the areas you watch shortly after they appear.
- Inventory trackingCount active listings per area and type over time.
Limits and etiquette
- Public pages only. Pages behind a login, and data shown only to signed-in users, are out of scope.
- Keep the rate modest: fetch pages one after another or with low concurrency, and cache what you already have.
- robots.txt of www.redfin.com (read 2026-11-17): public pages allowed for generic crawlers; no crawl delay set.
- Read Redfin's terms of service before you collect data at scale, and do not collect personal data you have no basis to process. This guide is not legal advice.
Questions
Can you scrape Redfin with Ujeebu?
Partly. 12 of 21 checks of public Redfin pages passed in the last 7 days; most failures were the site blocked the request (HTTP 403 or a block page). Retry failed pages later, and use the settings on this page.
Which settings work for Redfin?
Call /scrape with js=true, wait_for=8000. Our retry layer found that this site needs "js + wait 8000".
How many credits does a Redfin request cost?
With these settings a request costs up to 5 credits. Only responses with HTTP 200 or 404 are billed: a blocked or timed-out request is free.
Which fields can I extract from Redfin?
With the extraction recipes on this page, validated on real Redfin pages through our API: search and listing pages: url, title, price, beds, baths, area, image; property pages: availability, currency, name, price, url, address, area, area_unit, beds, city, description, hoa_dues. Pass the recipe as extract_rules in a POST to /scrape and the API returns those fields as JSON.
Is it allowed to scrape Redfin?
Its robots.txt allows generic crawlers on the page types in this guide. Collect public pages only, read Redfin's terms of service, keep your request rate modest and do not collect personal data you have no basis to process. This is not legal advice.
How fresh is this page?
The status and settings come from our own health checks of redfin.com, which run around the clock. Last check: 2026-11-22 20:02:10 UTC; last pass: 2026-11-22 13:33:49 UTC.