# Realtor.com API: Search agents by location

> Finds real estate agents working in a city and state or ZIP code on Realtor.com, in Realtor.com's relevance order, with ratings, sales figures, price range, languages and phone number when published.

Unofficial. Not affiliated with or endorsed by Realtor.com.

- Page: https://fous.com/methods/realtor.com/search-agents
- Method: `realtor.com/search_agents`, version 1
- Website: realtor.com
- Returns: agent name, brokerage, star rating, review count, homes sold, price range, languages, phone, photo, profile link, agent id
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `location` | string | yes | `"Denver, CO"` | City and state or ZIP code, for example Denver, CO. |
| `max_results` | integer | no | `20` | Maximum agents to return, for example 20. Default 20. |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "location": "Denver, CO",
  "max_results": 20
}
```

Its output:

```json
{
  "agents": [
    {
      "agent_id": "58c0f1d62f2c38001052f3c3",
      "brokerage": "SERHANT",
      "agent_name": "Felix Luck",
      "photo_link": "https://ap.rdcpix.com/d99582af3d70c23c15554b674059f24cr-c1579029028rd-w144_h144.jpg",
      "star_rating": 5,
      "phone_number": "(720) 404-0001",
      "profile_link": "https://www.realtor.com/realestateagents/58c0f1d62f2c38001052f3c3",
      "review_count": 72,
      "languages_spoken": [
        "Turkish",
        "English"
      ],
      "total_homes_sold": 38,
      "price_range_of_sales": "$0 - $0",
      "homes_sold_last_12_months": 19
    },
    {
      "agent_id": "5cb46a61497f450012d7bc63",
      "brokerage": "Real Broker, Westminster CO - Broker",
      "agent_name": "Juan Munoz",
      "photo_link": "https://ap.rdcpix.com/d96c459fffeb886a5f69dfac04dedc71a-e156285030rd-w144_h144.jpg",
      "star_rating": 5,
      "phone_number": "(720) 926-0204",
      "profile_link": "https://www.realtor.com/realestateagents/5cb46a61497f450012d7bc63",
      "review_count": 141,
      "languages_spoken": [
        "Spanish"
      ],
      "total_homes_sold": 58,
      "price_range_of_sales": "$163.646k - $1.25m",
      "homes_sold_last_12_months": 30
    },
    {
      "agent_id": "651b0d7fe8299b1809d76e11",
      "brokerage": "Serhant Colorado",
      "agent_name": "Brett Reasoner Founding Agent Serhant Colorado Team Lead The Cornerstone Group",
      "photo_link": "https://ap.rdcpix.com/6e5c1599d107e4774aa0aec5d4654dd9a-e1298920777rd-w144_h144.jpg",
      "star_rating": 5,
      "phone_number": null,
      "profile_link": "https://www.realtor.com/realestateagents/651b0d7fe8299b1809d76e11",
      "review_count": 23,
      "languages_spoken": [],
      "total_homes_sold": 48,
      "price_range_of_sales": "$280k - $1.899m",
      "homes_sold_last_12_months": 38
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"realtor.com/search_agents","input":{"location":"Denver, CO","max_results":20}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Find me the top real estate agents in Austin, TX with the most homes sold and their phone numbers
- I need a list of 10 agents working in 80202 with their star ratings and review counts
- Which agents on realtor.com serve Tampa, FL and what languages do they speak?
- Show me agents in Portland, OR with price ranges they typically handle, limited to 25 results
- Give me agent names, brokerages, and profile links for realtors covering ZIP 30309 in Atlanta

## Input schema

```json
{
  "type": "object",
  "required": [
    "location"
  ],
  "properties": {
    "location": {
      "type": "string",
      "description": "City and state or ZIP code, for example Denver, CO."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum agents to return, for example 20.",
      "x-fous-developer": true
    }
  },
  "additionalProperties": false
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "agents"
  ],
  "properties": {
    "agents": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "agent_name",
          "brokerage",
          "star_rating",
          "review_count",
          "homes_sold_last_12_months",
          "total_homes_sold",
          "price_range_of_sales",
          "languages_spoken",
          "phone_number",
          "photo_link",
          "profile_link",
          "agent_id"
        ],
        "properties": {
          "agent_id": {
            "type": "string",
            "x-fous-developer": true
          },
          "brokerage": {
            "type": [
              "string",
              "null"
            ]
          },
          "agent_name": {
            "type": "string"
          },
          "photo_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "star_rating": {
            "type": [
              "number",
              "null"
            ]
          },
          "phone_number": {
            "type": [
              "string",
              "null"
            ]
          },
          "profile_link": {
            "type": "string"
          },
          "review_count": {
            "type": [
              "integer",
              "null"
            ]
          },
          "languages_spoken": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "total_homes_sold": {
            "type": [
              "integer",
              "null"
            ]
          },
          "price_range_of_sales": {
            "type": [
              "string",
              "null"
            ]
          },
          "homes_sold_last_12_months": {
            "type": [
              "integer",
              "null"
            ]
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [Realtor.com API: Search homes](https://fous.com/methods/realtor.com/search-homes.md): Searches Realtor.com homes for sale, for rent, or recently sold in a city, neighborhood or ZIP code, with optional price, bedroom, bathroom and home type filters and sort order. Rentals with price ranges use the lowest advertised rent; withheld sold prices are blank.
- [Realtor.com API: Get home details](https://fous.com/methods/realtor.com/get-home.md): Gets a home's details from Realtor.com by street address or Realtor.com property link: status, list price, value estimate, beds, baths, size, year built, HOA fee, property and tax history, nearby schools, flood risk and photos.
- [Homes.com API: Search homes for sale](https://fous.com/methods/homes.com/search-homes.md): Searches Homes.com homes for sale in a US city, neighborhood, or ZIP code, with optional price, bedroom, bathroom and home type filters. Returns listings in site order; days on market is null when not shown.
- [Zillow API: Search homes for sale](https://fous.com/methods/zillow.com/search-homes.md): Searches Zillow homes for sale in a city and state, neighborhood or ZIP code, with optional price, bedroom, bathroom and property type filters and sort order, from Zillow's public search pages (up to 100 listings).
- [Redfin API: Search homes for sale](https://fous.com/methods/redfin.com/search-homes.md): Searches Redfin homes for sale in a city, neighborhood or ZIP code, with price, home type, bed and bath filters and a sort order, returning each listing's price, size, status, photo and links.
- [Zillow API: Search rentals](https://fous.com/methods/zillow.com/search-rentals.md): Searches Zillow rentals in a city, neighborhood, or ZIP code, with optional rent, bedroom, pet, and home-type filters. Listing details that Zillow does not show are null.
- [Apartments.com API: Search apartments](https://fous.com/methods/apartments.com/search-apartments.md): Searches Apartments.com rentals by city, neighborhood, or ZIP code, with optional rent, bedroom, pet, and page filters. Rent and availability wording is returned when displayed; missing details are null.
- [Zoopla API: Search properties](https://fous.com/methods/zoopla.co.uk/search-properties.md): Searches Zoopla homes for sale or to rent in a UK town, area or postcode, with price, bedroom, property type and sort options. Prices are in GBP; rents are monthly.
- [All Realtor.com methods](https://fous.com/methods/realtor.com.md)
