100 free credits. No credit card required.Start building
Logo
Redfin logoRedfin API

Get Redfin listing and sale history data with one API

Fetch Redfin homes for sale and recently sold, with each home's price history and tax history, as structured JSON with one SocialCrawl API key. Reads are priced in credits.

Redfin logo
/v1/redfin

2 active endpoints. Search and property.

  • GET /v1/redfin/search
  • GET /v1/redfin/property

What Redfin endpoints does SocialCrawl ship?

Two read endpoints for public Redfin data. Search an area for homes for sale or recently sold, and read one home with its price history and tax history.

Home search

1 credit
/v1/redfin/search

Homes for sale or recently sold for a Redfin search link, a place name, a Redfin region or a map box, up to limit homes in one response (100 by default, at most 350). Each home has its Redfin property id, address, coordinates, photos, price, status, beds, baths, square feet, lot size, year built and monthly HOA fee. Sold homes filter by how many days ago they sold. Standard tier (1 credit).

url, location, region_id, region_type, map_bounds, status, sold_within_days, property_type, sort, price_min, price_max, beds_min, beds_max, baths_min, sqft_min, sqft_max, limit

/v1/redfin/property

One home in full by its Redfin link. Adds the description and the price history, which runs back decades through public records. Each event has its date, the price where Redfin shows one, what happened (for example Listed or Sold (Public Records)) and its source. The yearly tax history carries the tax and, where it is published, the assessed value. Standard tier (1 credit).

url

Redfin API2 endpoints supported
View docs
Listings

Returns up to 350 Redfin homes for sale or recently sold in one call for a search link, region, map box or place name.

Use it to pull a whole area's listings or recent sales at once; narrow the area when a search reaches its limit.

1 credit

GET/v1/redfin/search?url=https%3A%2F%2Fwww.redfin.com%2Fcity%2F30818%2FTX%2FAustin&limit=50
$ curl https://www.socialcrawl.dev/v1/redfin/search?url=https%3A%2F%2Fwww.redfin.com%2Fcity%2F30818%2FTX%2FAustin&limit=50 \
    -H "x-api-key: sc_YOUR_API_KEY"
idle
// Running this live needs your own API key. Hit "Try it" to see an example response

How the Redfin API works

Redfin is a normal SocialCrawl data surface. You call GET /v1/redfin/… with an API key, spend credits on live misses, and get a single JSON envelope back.

Authenticate every call

Send your key in the x-api-key header. No Redfin account or partner access is needed for public reads. The same key works across SocialCrawl platforms.

GET with query params

Search takes url, location, region_id with region_type, or map_bounds, plus status, sold_within_days and property type, price, beds, baths and square feet filters. Property takes url. Formats are validated before any charge.

Pay in credits, not seats

Both Redfin routes cost 1 credit. Cache hits cost 0.

Read one JSON envelope

Every response is the same shape: success, data, credits_used, credits_remaining, request_id, cached. Lists also carry pagination when the route pages.

The usual integration chain

Most products find an area's listings or recent sales first, then read only the homes that matter.

01Search homes for sale
GET /v1/redfin/search?url=…&limit=…

PlaceList of up to limit homes

A Redfin city, ZIP code or neighborhood link is the most precise way to name an area.

02Search recent sales
GET /v1/redfin/search?url=…&status=sold&sold_within_days=…

PlaceList of sold homes

status=sold with sold_within_days sets how far back to look.

03Read the home
GET /v1/redfin/property?url=…

Place with price history and tax history

Pass the home's Redfin link, which ends in /home/ and the property id.

request
GET /v1/redfin/search?url=https%3A%2F%2Fwww.redfin.com%2Fcity%2F30818%2FTX%2FAustin&status=sold&sold_within_days=30
Host: www.socialcrawl.dev
x-api-key: sc_your_api_key_here

GET /v1/redfin/property?url=https%3A%2F%2Fwww.redfin.com%2FTX%2FAustin%2F8023-Acton-Dr-78736%2Fhome%2F31709039
response envelope
{
  "success": true,
  "data": {
    "place": {
      "id": "31709039",
      "name": "8023 Acton Dr",
      "category": "house",
      "ext": {
        "listing": {
          "price": 585000,
          "currency": "USD",
          "beds": 4,
          "baths": 2,
          "sqft": 2625,
          "lot_sqft": 58370,
          "year_built": 1968,
          "tax_history": [
            {
              "year": 2026,
              "tax": 11239.56,
              "assessment": 710704
            }
          ]
        }
      }
    }
  },
  "credits_used": 1,
  "credits_remaining": 9999,
  "request_id": "req_…",
  "cached": false
}

What lands in data

Field names match the rest of SocialCrawl where archetypes align. Parse once, reuse across platforms.

PlaceListsearch

items[] with id (Redfin property id), name, address, coordinates, photos, ext.listing with price, status, beds, baths, sqft, lot_sqft, year_built, hoa_fee

Placeproperty

ext.listing adds the description, price_history[] and tax_history[]

Price and tax historyproperty

price_history[] with date, price, event, source; tax_history[] with year, tax, assessment

Inside the gateway

Same request lifecycle as every other /v1 platform endpoint. Redfin is not a sidecar.

  1. 01

    Edge receives the call

    Next.js catch-all routes into the Hono social API. We mint a request_id, authenticate the key, then enforce rate limit (600/min) and concurrency (50 in flight per key).

  2. 02

    Validate, then debit

    Registry lookup finds the redfin route. Required params and format checks run first. Invalid input returns 400 with no charge. Valid calls debit the tier cost atomically before the read starts.

  3. 03

    Cache or fetch

    A deterministic cache key is built from platform + resource + params. Hit: return immediately, credits_used = 0. Miss: the public page is read live, with retries on 5xx or network errors and a circuit breaker if the source is unhealthy.

  4. 04

    Normalize and return

    Redfin data is mapped to the Place and PlaceList archetypes with the listing facts in place.ext.listing, validated, then wrapped in the success envelope and logged for billing audit.

Billing rules that matter in production

  • search and property: 1 credit
  • Cache hit: 0 credits
  • Empty / hard fail: auto-refund
  • Bad params: 400, never charged
  • No credits: 402, never charged
  • Search: up to limit homes in one response, at most 350
  • Sort follows Redfin's own order
  • Money in US dollars, areas in square feet
  • No agent contact, tour or offer tools

How SocialCrawl gets Redfin data

Redfin is public read data. We normalize it into the SocialCrawl schema so your code does not learn a second vendor SDK.

What Redfin is for this API

Public listing pages and search results for homes for sale and recently sold in the United States, with each home's price and tax history back through public records.

How SocialCrawl reaches it

Public pages are read on request and normalized server-side. You never run a Redfin login or partner integration.

What leaves our edge

PlaceList for searches and Place for one home. The listing facts sit in place.ext.listing, the same shape Zillow homes use.

What we do not ship live

No rental listings, agent contact, tour requests, offers or saved searches.

field map sketch
Redfin home→ place.*Redfin property id, street line, full address, coordinates
listing facts→ place.ext.listingprice, status, beds, baths, square feet, HOA fee
price and tax events→ place.ext.listing.price_history / tax_historydate, price, event and source; year, tax and assessment

What this API is used for

The jobs this API is most often used for.

2active Redfin endpoints in the registry
1credit per call on every Redfin route

Sold comparables, tax history and inventory by area

Callers search an area for listings or recent sales, then read the homes that matter for their price and tax history. Decades of price history from public records and the yearly tax history for one home, plus for-sale and sold search, from one key in the shared Place schema that Zillow homes also use.

Live misses read the public page on request. Repeat calls hit cache and cost 0 credits.

Use case examples

Common ways teams put this data to work, and the stack each one tends to run.

Sold comparables

Python, notebooks

search with status=sold and sold_within_days to pull recent sales near a subject home and compare price per square foot.

Tax and assessment history

Python, warehouse loads

property to read each home's yearly tax and assessed value alongside its sale history.

Inventory monitoring by area

Node, scheduled jobs

search on the same Redfin link on a schedule to see which homes were newly listed, changed price or no longer appear.

How to call the Redfin API

Both Redfin routes are 1 credit. Cache hits are free.

curl "https://www.socialcrawl.dev/v1/redfin/search?url=https%3A%2F%2Fwww.redfin.com%2Fcity%2F30818%2FTX%2FAustin&limit=50" \
  -H "x-api-key: sc_your_api_key_here"
curl "https://www.socialcrawl.dev/v1/redfin/property?url=https%3A%2F%2Fwww.redfin.com%2FTX%2FAustin%2F8023-Acton-Dr-78736%2Fhome%2F31709039" \
  -H "x-api-key: sc_your_api_key_here"
Redfin logoRedfin on SocialCrawl

Same key as the rest of the catalog

Endpoints

What data does the Redfin API return?

Every endpoint returns structured JSON in a unified envelope. Computed fields such as engagement rate and content category are included only where the endpoint supports them and the required source inputs are present.

FAQ

Have a question? We got answers

Find answers to frequently asked questions about SocialCrawl's API, pricing, and capabilities.

Contact us
What does the SocialCrawl Redfin API cover?
It covers 2 endpoints: Search and Property. They search homes for sale or recently sold and read one home with its price history and tax history, in the same unified JSON as the other 94 platforms.
Do I need a Redfin account or partner access?
No. You call SocialCrawl with one SocialCrawl API key, so there is no Redfin login, partner application or key to manage.
Can I get a Redfin home's sale history?
Yes. GET /v1/redfin/property returns place.ext.listing.price_history with each event's date, the price where Redfin shows one, what happened (for example Listed or Sold (Public Records)) and its source, back decades through public records.
How do I find recently sold homes on Redfin?
Search with status=sold and set sold_within_days to how far back to look. Sort follows Redfin's own order, so sort on your side when you need an exact order.
How much does the Redfin API cost?
Both Redfin routes cost 1 credit a call and cache hits are free. A new account gets 100 free credits with no card.
Is scraping Redfin data legal?
SocialCrawl returns publicly available Redfin data and does not access private or login-gated content. Whether scraping fits your project depends on your use case and jurisdiction. You are responsible for complying with Redfin's terms of service and applicable data-protection laws such as GDPR and CCPA. This is general information, not legal advice.
Redfin scraping API vs the official Redfin API: what's the difference?
With SocialCrawl there is no app review or approval queue. Sign up and call Redfin endpoints immediately with a single x-api-key. Responses share one unified schema with every other SocialCrawl platform, and credit-based pricing replaces per-platform quotas. Official APIs are still the right choice for posting and other write actions: SocialCrawl is read-only data.

Ask AI about SocialCrawl

Read the Redfin API reference in the docs

🤖 AI agent or LLM? Read this page as markdown