# Zillow Agent Profile

<p>Get the public profile of a real estate agent or team: name, brokerage with address and website, rating and review count, licenses, service areas, specialties, languages, the about text and team members.</p><h2>Sales and listings</h2><p>The profile carries sales figures (last 12 months, total sales, price range, average price), recent past sales, current listings for sale and for rent, and the first page of reviews with an AI summary and the common keywords. For a team lead the sales figures cover the whole team and <code>is_team</code> is true. Use the agent reviews, sold and listings endpoints for further pages.</p><h2>Contact data</h2><p>The brokerage phone and websites are included. The agent personal phone number and email address are not part of the response.</p><p>Costs 1 credit per request.</p>

- **Documentation:** [https://scrappa.co/docs/zillow-api/zillow_agent](https://scrappa.co/docs/zillow-api/zillow_agent)
- **API group:** Zillow API
- **Endpoint:** `GET https://scrappa.co/api/zillow/agent`

## 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 |
| --- | --- | --- | --- |
| `screen_name` | string | Yes | The last part of the agent profile URL, for example McConnellGroup. The agent search returns it as screen_name. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/zillow/agent?screen_name=McConnellGroup"
```

## Example response

```json
{
    "data": {
        "agent": {
            "encoded_zuid": "X1-ZUwfyvmb7rwtmx_8b74a",
            "screen_name": "McConnellGroup",
            "name": "Sean McConnell",
            "is_team": true,
            "rating": 5,
            "review_count": 723,
            "sales_stats": {
                "sales_last_12_months": "413",
                "total_sales": "2,107",
                "price_range": "$125K-$13M",
                "average_price": "$925K"
            }
        }
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 400 | The request validation failed | A query parameter is missing, malformed, or outside its documented range. This is the only Zillow response that carries no error code: the body has a message and a field list and nothing else, so match it on the 400 status. |
| 422 | No research dataset matches that family and geography | The requested research file does not exist for the combination given. |
| 422 | More than one research dataset matches | The family, geography and variant given do not identify a single research file. |
| 422 | No accuracy figures are published for that region | The named state or metropolitan area publishes no estimate-accuracy data. |
| 422 | The upstream rejected the request | Zillow answered with a deterministic 4xx. |
| 422 | The building returned does not match the requested address | The decoded building token resolved to a building at a different address than the slug names. |
| 503 | The listing source answered with a block or rate-limit page | The request reached the source, but what came back was a challenge or rate-limit page rather than the data. |
| 503 | The listing source returned a server error | The request was served and answered with a 5xx. |
| 503 | The listing source did not answer in time | The request was sent and no answer came back before the deadline. |
| 503 | The request could not be sent | No approved exit could be reached, so the request never reached the listing source. |
| 503 | No approved exit is available | There was no usable approved exit to send the request through. |
| 503 | The upstream returned a document this integration cannot read | The publisher changed the shape of a response or served a document that is not the expected file. |

## 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)