# Redfin Search API (https://www.socialcrawl.dev/platforms/redfin/search) > Returns Redfin homes for sale or recently sold in one call: up to limit homes (100 by default, at most 350) for a Redfin search link (url, for example a city, ZIP code or neighborhood page), a Redfin region (region_id with region_type), a map box (map_bounds), or a place name (location). Each home is a Place: `place.id` is the Redfin property id, `place.name` the street line, `place.address` the full address, with coordinates, photos and the listing link; `place.ext.listing` carries the price, status, beds, baths, square feet, lot size, year built and monthly HOA fee. When a search reaches its limit, narrow the area or the filters to see more. Filter by property type, price, beds, baths, square feet and, for sold homes, how recently they sold. TL;DR: `GET /v1/redfin/search` costs 1 credit per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup. ## Parameters | Parameter | Required | Description | | --- | --- | --- | | `url` | no | A Redfin search link, for example https://www.redfin.com/city/30818/TX/Austin. | | `location` | no | A place name, for example Austin, TX. Answered by a source that returns up to 40 homes. | | `region_id` | no | Redfin region id; needs region_type. | | `region_type` | no | Region kind: 1 neighborhood, 2 ZIP code, 5 county, 6 city, 11 state. (1 \| 2 \| 5 \| 6 \| 11) | | `map_bounds` | no | A map box: north,east,south,west in decimal degrees. | | `status` | no | for_sale (default) or sold. (for_sale \| sold) | | `sold_within_days` | no | Sold in the last N days; with status=sold. Defaults to 180. | | `property_type` | no | One home type: house, condo, townhouse, multi_family, land, other, manufactured or co_op. (house \| condo \| townhouse \| multi_family \| land \| other \| manufactured \| co_op) | | `sort` | no | recommended (default), newest, price_asc, price_desc or sqft. The order is Redfin's own and is not strict: on sold homes a few rows can sit out of price order. (recommended \| newest \| price_asc \| price_desc \| sqft) | | `price_min` | no | Lowest price in US dollars. | | `price_max` | no | Highest price in US dollars. | | `beds_min` | no | Fewest bedrooms. | | `beds_max` | no | Most bedrooms. | | `baths_min` | no | Fewest bathrooms. | | `sqft_min` | no | Smallest interior area in square feet. | | `sqft_max` | no | Largest interior area in square feet. | | `limit` | no | Homes returned, 1 to 350. Defaults to 100. | ## Code example ```bash curl -G "https://www.socialcrawl.dev/v1/redfin/search" \ --data-urlencode "url=https://www.redfin.com/city/30818/TX/Austin" \ -H "x-api-key: sc_YOUR_API_KEY" ``` ## FAQ ### How do I search Redfin listings with an API? Send GET /v1/redfin/search with a Redfin search link as url, a place name as location, a Redfin region as region_id with region_type, or a map box as map_bounds. limit sets how many homes come back in the one response. ### Which filters does the Redfin Search API take? It takes status (for_sale or sold), sold_within_days, property_type, price_min and price_max, beds_min and beds_max, baths_min, and sqft_min and sqft_max. ### How many homes does one Redfin search return? Up to limit homes, 100 by default and at most 350. A search by place name returns fewer, up to 40. When a search reaches its limit, narrow the area or the filters to see the rest. ### Is the Redfin sort order strict? No. sort uses Redfin's own order, and on sold homes a few rows can sit out of price order. Sort on your side when you need an exact order. ### How much does the Redfin Search API cost? Each search costs 1 credit on the standard tier, and cache hits are free. A new account gets 100 free credits with no card. See the full Redfin API: https://www.socialcrawl.dev/platforms/redfin ## Pricing - Standard endpoints: 1 credit per call - Advanced endpoints: 5 credits per call - Premium endpoints: 10 credits per call - 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire. - Full pricing: https://www.socialcrawl.dev/pricing ## Explore with AI Questions this API answers, phrased for an AI assistant: - How do I search Redfin homes for sale with an API? - How do I get recently sold homes from Redfin as JSON? - Does SocialCrawl have a Redfin API for listings by ZIP code?