# Redfin Agent Search

<p>Search the Redfin agents of a region. Every agent has name, slug, brokerage, rating, review count, deals in the past year (and in the region), lifetime deals and volume, average deal price, languages, service areas, property types and whether the agent serves buyers and sellers. Filter by minimum rating, minimum deals, language and buy or sell, sort by deals, rating or reviews, and page through the result: page 2 is real page 2. Agent email addresses and phone numbers are not returned. The data is US only. Use the slug with <strong>Redfin Agent Profile</strong>.</p><p><strong>Cost:</strong> 1 credit per successful request. Failed requests are not charged.</p>

- **Documentation:** [https://scrappa.co/docs/redfin-api/redfin_agents](https://scrappa.co/docs/redfin-api/redfin_agents)
- **API group:** Redfin API
- **Endpoint:** `GET https://scrappa.co/api/redfin/agents`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `region_id` | string | Yes | <p>Region identifier from /api/redfin/locations.</p> |
| `region_type` | string | Yes | <p>Region type: 1=neighborhood, 2=ZIP, 6=city.</p> |
| `min_rating` | string | No | <p>Only agents with at least this star rating (0-5). Agents without a rating are excluded.</p> |
| `min_deals` | string | No | <p>Only agents with at least this many deals in the past year.</p> |
| `language` | string | No | <p>Only agents who speak this language (for example Spanish).</p> |
| `serves` | string | No | <p>buy (agents who work with buyers) or sell (agents who work with sellers).</p> |
| `sort` | string | No | <p>deals (default), rating or reviews. Highest first.</p> |
| `page` | string | No | <p>Page number. Default 1.</p> |
| `per_page` | string | No | <p>Agents per page (1-50). Default 20.</p> |

## Example response

```json
{
    "page": 1,
    "count": 1,
    "total": 75,
    "agents": [
        {
            "name": "Matthew Smith",
            "slug": "matthew-smith",
            "rating": 5,
            "agent_id": 63855,
            "languages": [],
            "profile_url": "https://www.redfin.com/real-estate-agents/matthew-smith",
            "review_count": 9,
            "serves_buyers": true,
            "avg_deal_price": 828748,
            "deals_lifetime": 218,
            "serves_sellers": true,
            "deals_past_year": 23,
            "deals_past_year_in_region": 20
        }
    ],
    "has_more": true,
    "per_page": 20
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 400 | Invalid characters in parameter | The request contains null bytes or unsupported control characters. |
| 422 | The request validation failed | One or more Redfin request parameters failed validation. |
| 404 | Region not found | Region not found |
| 500 | Failed to fetch data from Redfin after multiple attempts. | The upstream service is temporarily unavailable. Please retry shortly. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)