> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Zillow Agents API

> Zillow real estate agents with name, profile URL, brokerage, title and team. Search by location, language or specialty.

`POST /v1/data/zillow/agents/run`

**Pricing:** $0.003 per agent ($3.00 per 1,000).

## Request

Send the inputs under `params`. Only the keys below are accepted; any other key returns `422 invalid_params`.

**location** `string` *required*

Location.

**maxResults** `integer` (default: 100)

How many agents to return in total. Defaults to 100; use 0 for all.

**languages** `string[]`

Only agents who speak one of these languages. Leave empty for any.

Allowed values: `american-sign-language` (American Sign Language), `arabic` (Arabic), `bengali` (Bengali), `cantonese` (Cantonese), `farsi` (Farsi), `french` (French), `german` (German), `greek` (Greek), `haitian-creole` (Haitian Creole), `hebrew` (Hebrew), `hindi` (Hindi), `hungarian` (Hungarian), `italian` (Italian), `japanese` (Japanese), `korean` (Korean), `mandarin` (Mandarin), `polish` (Polish), `portuguese` (Portuguese), `russian` (Russian), `spanish` (Spanish), `filipino` (Filipino), `thai` (Thai), `turkish` (Turkish), `ukrainian` (Ukrainian), `vietnamese` (Vietnamese).

**specialtys** `string[]`

Only agents with one of these specialties. Leave empty for any.

Allowed values: `first-time-home-buyers` (First-time home buyers), `investment-properties` (Investment properties), `rentals` (Rentals), `military-or-veterans` (Military / veterans), `luxury-homes` (Luxury homes), `new-construction` (New construction), `property-management` (Property management), `senior-communities` (Senior communities), `relocation` (Relocation), `foreclosure` (Foreclosure), `lot-or-land` (Lot / land), `vacation-short-term-rentals` (Vacation / short-term rentals).

## Example

```bash cURL theme={null}
curl -X POST "https://api.mindcase.co/v1/data/zillow/agents/run?wait=true" \
  -H "Authorization: Bearer $MINDCASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "params": {
    "location": "Austin, TX",
    "maxResults": 10
  }
}'
```

```python Python theme={null}
import os, requests

r = requests.post(
    "https://api.mindcase.co/v1/data/zillow/agents/run",
    params={"wait": "true"},
    headers={"Authorization": f"Bearer {os.environ['MINDCASE_API_KEY']}"},
    json={"params": {
    "location": "Austin, TX",
    "maxResults": 10
}},
)
job = r.json()
rows = job.get("data", [])  # if job["status"] == "running", poll /v1/jobs/{job_id}/results
```

```javascript Node.js theme={null}
const r = await fetch("https://api.mindcase.co/v1/data/zillow/agents/run?wait=true", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.MINDCASE_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ params: {
  "location": "Austin, TX",
  "maxResults": 10
} }),
});
const job = await r.json();
const rows = job.data ?? []; // if job.status === "running", poll /v1/jobs/{job_id}/results
```

## Response fields

Each row in `data` is one agent, keyed by these fields.

| Field | Name | Type |
| - | - | - |
| `agentId` | Agent ID | text |
| `agentName` | Agent Name | text |
| `username` | Username | text |
| `profileUrl` | Profile URL | url |
| `brokerage` | Brokerage | text |
| `title` | Title | text |
| `teamName` | Team Name | text |
| `phone` | Phone | phone |
| `businessPhone` | Business Phone | phone |
| `email` | Email | email |
| `website` | Website | url |
| `socials` | Socials | object |
| `rating` | Rating | rating |
| `reviews` | Reviews | number |
| `salesLast12Months` | Sales Last 12 Months | number |
| `totalSales` | Total Sales | number |
| `priceRange` | Price Range | text |
| `minSalePrice` | Min Sale Price | number |
| `maxSalePrice` | Max Sale Price | number |
| `averageSalePrice` | Average Sale Price | number |
| `activeListingsCount` | Active Listings Count | number |
| `activeRentalsCount` | Active Rentals Count | number |
| `isTopAgent` | Is Top Agent | boolean |
| `isPremierAgent` | Is Premier Agent | boolean |
| `yearsInIndustry` | Years In Industry | number |
| `memberSince` | Member Since | date |
| `specialties` | Specialties | array |
| `languages` | Languages | array |
| `serviceAreas` | Service Areas | array |
| `licenses` | Licenses | object\_array |
| `description` | Description | text |
| `photoUrl` | Photo URL | image |
| `address` | Address | text |
| `city` | City | text |
| `state` | State | text |
| `postalCode` | Postal Code | text |
| `teamMemberCount` | Team Member Count | number |
| `reviewsSummary` | Reviews Summary | object |
| `pastSales` | Past Sales | object\_array |
| `activeListings` | Active Listings | object\_array |
| `rentalListings` | Rental Listings | object\_array |
| `videoUrl` | Video URL | url |

## Example response

Abridged: long text and lists are shortened.

```json theme={null}
{
  "job_id": "7f3a1c2e-0b9d-4c55-9a51-3f2e8d1b6a40",
  "agent": "zillow/agents",
  "status": "completed",
  "row_count": 1,
  "truncated": false,
  "data": [
    {
      "licenses": null,
      "agentName": "Realty Austin Compass",
      "reviewsSummary": {
        "aiSummary": "The team demonstrates a strong track record of delivering excellent market results by accurately pricing properties and negotiating effectively. Clients cons...",
        "highlights": [
          "Achieving strong market outcomes through expert pricing, negotiation, and comprehensive client support defines the team's approach to buying, selling, and re...",
          "Experienced in Austin and surrounding cities including Georgetown, Leander, Round Rock, Pflugerville, and Cedar Park.",
          "Primarily helps buyers and sellers with single-family homes."
        ],
        "keywords": [
          {
            "label": "Knowledgeable",
            "count": 1982
          },
          {
            "label": "Attentive",
            "count": 1905
          },
          {
            "label": "Responsive",
            "count": 1108
          }
        ],
        "breakdown": [
          {
            "label": "All reviews",
            "count": 3140
          },
          {
            "label": "Helped me buy",
            "count": 1912
          },
          {
            "label": "Helped me sell",
            "count": 681
          }
        ]
      },
      "email": "kathryn@realtyaustin.com",
      "yearsInIndustry": 23,
      "pastSales": [
        {
          "zpid": "13867123",
          "address": "1309 Patton St, Fort Collins, CO, 80524",
          "streetAddress": "1309 Patton St",
          "city": "Fort Collins",
          "state": "CO",
          "postalCode": "80524",
          "price": 760000,
          "priceText": null,
          "status": null,
          "homeType": null,
          "bedrooms": 4,
          "bathrooms": 3,
          "livingArea": 2272,
          "latitude": 40.56967,
          "longitude": -105.05501,
          "brokerageName": null,
          "badges": [],
          "soldDate": "2026-10-26",
          "represented": [
            "Buyer"
          ],
          "url": "https://www.zillow.com/homedetails/1309-Patton-St-Fort-Collins-CO-80524/13867123_zpid/",
          "photoUrl": "https://photos.zillowstatic.com/fp/72987d42d6c65fd9d149d4924803d50d-p_d.jpg"
        },
        {
          "zpid": "463409344",
          "address": "312 Joyful Ln, San Marcos, TX, 78666",
          "streetAddress": "312 Joyful Ln",
          "city": "San Marcos",
          "state": "TX",
          "postalCode": "78666",
          "price": null,
          "priceText": null,
          "status": null,
          "homeType": null,
          "bedrooms": null,
          "bathrooms": null,
          "livingArea": null,
          "latitude": 29.836655,
          "longitude": -97.92698,
          "brokerageName": null,
          "badges": [],
          "soldDate": "2026-10-23",
          "represented": [
            "Buyer"
          ],
          "url": "https://www.zillow.com/homedetails/312-Joyful-Ln-San-Marcos-TX-78666/463409344_zpid/",
          "photoUrl": "https://maps.googleapis.com/maps/api/streetview?location=312+Joyful+Ln%2C+San+Marcos%2C+TX+78666&size=400x300&key=AIzaSyARFMLB1na-BBWf7_R3-5YOQQaHqEJf6RQ&sou..."
        }
      ],
      "serviceAreas": [
        "Westlake, TX",
        "Leander, TX"
      ],
      "teamMemberCount": 165,
      "title": null,
      "maxSalePrice": 4900000,
      "averageSalePrice": 584000,
      "activeListings": [
        {
          "zpid": "83825975",
          "address": "17900 Misty Harbor Dr, Pflugerville, TX 78660",
          "streetAddress": "17900 Misty Harbor Dr",
          "city": "Pflugerville",
          "state": "TX",
          "postalCode": "78660",
          "price": 675000,
          "priceText": null,
          "status": "active",
          "homeType": "singleFamily",
          "bedrooms": 5,
          "bathrooms": 5,
          "livingArea": null,
          "latitude": 30.444136,
          "longitude": -97.574486,
          "brokerageName": "Compass RE Texas, LLC",
          "badges": [],
          "soldDate": null,
          "represented": [],
          "url": "https://www.zillow.com/homedetails/17900-Misty-Harbor-Dr-Pflugerville-TX-78660/83825975_zpid/",
          "photoUrl": "https://photos.zillowstatic.com/fp/9f3f0a8007910c192fdd22369b53190e-a_a.jpg"
        },
        {
          "zpid": "29468245",
          "address": "5404 China Berry Rd, Austin, TX 78744",
          "streetAddress": "5404 China Berry Rd",
          "city": "Austin",
          "state": "TX",
          "postalCode": "78744",
          "price": 275000,
          "priceText": null,
          "status": "active",
          "homeType": "singleFamily",
          "bedrooms": 3,
          "bathrooms": 2,
          "livingArea": null,
          "latitude": 30.192871,
          "longitude": -97.736565,
          "brokerageName": "Compass RE Texas, LLC",
          "badges": [],
          "soldDate": null,
          "represented": [],
          "url": "https://www.zillow.com/homedetails/5404-China-Berry-Rd-Austin-TX-78744/29468245_zpid/",
          "photoUrl": "https://photos.zillowstatic.com/fp/b60e24911c905e91de5960ac98fceb5f-a_a.jpg"
        }
      ],
      "priceRange": "$17K-$4.9M",
      "username": "Realty Austin",
      "activeRentalsCount": 44,
      "totalSales": 24292,
      "memberSince": "2008-09-19",
      "website": "https://www.realtyaustin.com",
      "postalCode": "78717",
      "address": "14010 N US-183, Suite 400, Austin, TX 78717",
      "socials": {
        "facebook": "https://www.facebook.com/realtyaustincompass",
        "instagram": "https://www.instagram.com/realtyaustincompass",
        "youtube": "https://www.youtube.com/@RealtyAustinCompass",
        "linkedin": "https://www.linkedin.com/company/realty-austin-compass"
      },
      "reviews": 3139,
      "specialties": [
        "Buyer's Agent",
        "Listing Agent"
      ],
      "businessPhone": "(512) 600-1800",
      "salesLast12Months": 269
    }
  ]
}
```

## Related APIs

For property listings use [`zillow/listings`](https://docs.mindcase.co/apis/zillow/listings).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.