# Redfin Property endpoint reference

`redfin.property.get`

Get one home from its Redfin link: the address, price, rooms and photos, with the listing's own description.

- Platform: [Redfin Real Estate](https://docs.upscrape.com/docs/platforms/redfin)
- Endpoint ID: `redfin.property.get`
- Price: 1 credit per call; failed calls are free
- Runs for up to: 45 seconds
- Request: `POST /execute`
- MCP tool when pinned: `redfin__property__get`
- OpenAPI: `https://docs.upscrape.com/docs/platforms/redfin/redfin.property.get/openapi.json`

## Request

```bash
curl --request POST \
  --url https://data.upscrape.com/execute \
  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \
  --header "Content-Type: application/json" \
  --header "Prefer: wait=30" \
  --data '{
  "capability": "redfin.property.get",
  "input": {
    "property_url": "https://www.redfin.com/WA/Seattle/130-29th-Ave-98122/home/148583"
  }
}'
```

## Input

| Field | Type | Required | What it does | Example |
| --- | --- | --- | --- | --- |
| `property_url` | `string` | yes | The home's Redfin link, such as https://www.redfin.com/WA/Seattle/130-29th-Ave-98122/home/148583. | https://www.redfin.com/WA/Seattle/130-29th-Ave-… |

## Response

A finished call answers with HTTP `200`; the data is in `results[0].data`, and `billing.credits_charged` is what it cost. A call still running after the wait answers `202` with a `poll_url`.

This is `results[0].data` from a real run:

```json
{
  "title": "130 29th Ave, Seattle, WA 98122 - 4 beds/2 baths",
  "price": 1018000,
  "city": "Seattle",
  "address": "130 29th Ave, Seattle, WA 98122",
  "area_sqft": 3200,
  "baths": 2,
  "beds": 4,
  "canonical": "https://www.redfin.com/WA/Seattle/130-29th-Ave-98122/home/148583",
  "collected_at": "2026-10-19T18:58:22Z",
  "currency": "USD",
  "description": "(NWMLS as Distributed by MLS Grid) Sold: 4 beds, 2 baths, 3200 sq. ft. house located at 130 29th Ave, Seattle, WA 98122 sold for $1,018,000…",
  "property_id": "148583",
  "state": "WA",
  "updated_at": "2026-10-19T18:58:22Z",
  "url": "https://www.redfin.com/WA/Seattle/130-29th-Ave-98122/home/148583",
  "zip": "98122",
  "image_urls": [
    "https://ssl.cdn-redfin.com/photo/1/mbpaddedwide/332/genMid.2567332_1.jpg",
    "https://ssl.cdn-redfin.com/photo/1/mbpaddedwide/332/genMid.2567332_1_1.jpg"
  ]
}
```

### Fields

| Field | Type | What it is | Example |
| --- | --- | --- | --- |
| `address` | `string` | The home's full address. | 130 29th Ave, Seattle, WA 98122 |
| `price` | `integer` | The price Redfin shows: the asking price, or the sold price for a sold home, in US dollars. | 1,018,000 |
| `beds` | `integer` | Bedrooms. | 4 |
| `baths` | `integer` | Bathrooms. | 2 |
| `area_sqft` | `integer` | The home's size, in square feet. | 3200 |
| `zip` | `string` | The ZIP code. | 98122 |
| `title` | `string` | The page title: the address with beds and baths. | 130 29th Ave, Seattle, WA 98122 - 4 beds/2 baths |
| `city` | `string` | The city. | Seattle |
| `canonical` | `string` | The home's main Redfin address. | https://www.redfin.com/WA/Seattle/130-29th-Ave-98122/home/148583 |
| `collected_at` | `string` | When the data was read. | 2026-10-19T18:58:22Z |
| `currency` | `string` | The currency of the price. | USD |
| `description` | `string` | The listing description Redfin shows. | (NWMLS as Distributed by MLS Grid) Sold: 4 beds, 2 baths, 3200 … |
| `image_urls` | `array` | Photos of the home. | https://ssl.cdn-redfin.com/photo/1/mbpaddedwide/332/genMid.2567… |
| `property_id` | `string` | Redfin's ID for the home. | 148583 |
| `state` | `string` | The state. | WA |
| `updated_at` | `string` | When the data was read. | 2026-10-19T18:58:22Z |
| `url` | `string` | The home's page on Redfin. | https://www.redfin.com/WA/Seattle/130-29th-Ave-98122/home/148583 |

## If a call fails

A failed call costs nothing. Branch on `error.code`; https://docs.upscrape.com/docs/api/errors lists every code and which ones to retry.