# Zillow Agent Sold Homes

<p>Get the homes an agent or team sold, newest first. Each card has the address, sale price, sale date, bedrooms, bathrooms, living area, whether the agent represented the buyer or the seller, the brokerage and a link to the home.</p><h2>Paging</h2><p>Ask for up to 50 cards per page. <code>has_more</code> is false when a page holds fewer cards than requested. A page past the end returns an empty list.</p><h2>Sold home search</h2><p>To search sold homes by area instead of by agent, use the <a href="/docs/zillow-api/zillow_search">Zillow Property Search</a> endpoint with the recentlySold status.</p><p>Costs 1 credit per request.</p>

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

## 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 |
| --- | --- | --- | --- |
| `encoded_zuid` | string | Yes | The encoded_zuid of the agent, from the agent search or agent profile. |
| `page` | integer | No | Page number, 1-based. |
| `page_size` | integer | No | Cards per page, 1 to 50. Default 10. |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/zillow/agent-sold?encoded_zuid=X1-ZUwfyvmb7rwtmx_8b74a&page=1&page_size=10"
```

## Example response

```json
{
    "data": {
        "encoded_zuid": "X1-ZUwfyvmb7rwtmx_8b74a",
        "page": 1,
        "page_size": 10,
        "count": 10,
        "has_more": true,
        "properties": [
            {
                "zpid": 58665326,
                "address": "206 202nd Street SE, Bothell, WA 98012",
                "price_text": "$740,000",
                "sold_date": "10/30/2026",
                "bedrooms": "4",
                "bathrooms": "3",
                "badges": [
                    "Buyer"
                ]
            }
        ]
    }
}
```

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