# Zumper API: Search rentals

> Searches Zumper apartments and homes for rent in a city or neighborhood. You can filter by price, bedrooms, pet policy and property type.

Unofficial. Not affiliated with or endorsed by Zumper.

- Page: https://fous.com/methods/zumper.com/search-rentals
- Method: `zumper.com/search_rentals`, version 1
- Website: zumper.com
- Returns: name, address, rent, beds, baths, square feet, availability, pets, photo, link
- 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 3, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `pets` | string | no | `"dogs_allowed"` | Pet policy to include. Example: dogs_allowed. One of "any", "dogs_allowed", "cats_allowed". Default "any". |
| `location` | string | yes | `"Chicago, IL"` | City and state or province, or a neighborhood and city. Example: Chicago, IL. |
| `max_rent` | number | no | `2500` | Highest monthly rent in USD, or CAD for a Canadian location. Example: 2500. |
| `min_beds` | integer | no | `1` | Minimum bedrooms; 0 includes studios. Example: 2. Default 0. |
| `max_results` | integer | no | `10` | Most listings to return. Example: 20. Default 20. |
| `property_type` | string | no | `"apartment"` | Kind of rental. Example: apartment. One of "any", "apartment", "house", "condo", "room". Default "any". |

## Output

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

```json
{
  "pets": "dogs_allowed",
  "location": "Chicago, IL",
  "max_rent": 2500,
  "min_beds": 1,
  "max_results": 10,
  "property_type": "apartment"
}
```

Its output:

```json
{
  "rentals": [
    {
      "beds": "1–2",
      "name": "The Blackwood",
      "baths": "1–2",
      "address": "5200 S Blackstone Ave, Chicago, IL 60615",
      "currency": "USD",
      "photo_link": "https://img.zumpercdn.com/894277268/1280x960",
      "square_feet": "450–900",
      "listing_link": "https://www.zumper.com/apartment-buildings/p16277/the-blackwood-hyde-park-chicago-il",
      "monthly_rent": "$1,550–$1,995",
      "pets_allowed": "Cats and dogs allowed",
      "available_date": null,
      "zumper_listing_id": "64196674",
      "lowest_monthly_rent": 1550
    },
    {
      "beds": "1–2",
      "name": "Woodlawn Terrace",
      "baths": "1",
      "address": "4726 S Woodlawn Ave, Chicago, IL 60615",
      "currency": "USD",
      "photo_link": "https://img.zumpercdn.com/894278305/1280x960",
      "square_feet": "565–793",
      "listing_link": "https://www.zumper.com/apartment-buildings/p14979/woodlawn-terrace-kenwood-chicago-il",
      "monthly_rent": "$1,495–$1,799",
      "pets_allowed": "Cats and dogs allowed",
      "available_date": null,
      "zumper_listing_id": "64196808",
      "lowest_monthly_rent": 1495
    },
    {
      "beds": "1–2",
      "name": "Regents Park",
      "baths": "1–2",
      "address": "5035 S East End Ave, Chicago, IL 60615",
      "currency": "USD",
      "photo_link": "https://img.zumpercdn.com/894287412/1280x960",
      "square_feet": "715–1,135",
      "listing_link": "https://www.zumper.com/apartment-buildings/p289649/regents-park-kenwood-chicago-il",
      "monthly_rent": "$1,875–$2,899",
      "pets_allowed": "Cats and dogs allowed",
      "available_date": null,
      "zumper_listing_id": "64197552",
      "lowest_monthly_rent": 1875
    }
  ]
}
```

## 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":"zumper.com/search_rentals","input":{"pets":"dogs_allowed","location":"Chicago, IL","max_rent":2500,"min_beds":1,"max_results":10,"property_type":"apartment"}}'
```

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 pet-friendly apartments for rent in Austin, TX under $1800 a month with at least 1 bedroom
- Show me houses for rent in Seattle, WA with 3 bedrooms and dogs allowed, max rent 3000
- I need condos in Toronto, ON under 2400 CAD with at least 2 beds, cats allowed
- Any studios or 1-bedroom places for rent in Brooklyn, NY under $2800, return up to 10 listings
- On zumper.com, look for rooms for rent in Denver, CO under $900 a month, pets any

## Input schema

```json
{
  "type": "object",
  "required": [
    "location"
  ],
  "properties": {
    "pets": {
      "enum": [
        "any",
        "dogs_allowed",
        "cats_allowed"
      ],
      "type": "string",
      "default": "any",
      "description": "Pet policy to include. Example: dogs_allowed."
    },
    "location": {
      "type": "string",
      "minLength": 2,
      "description": "City and state or province, or a neighborhood and city. Example: Chicago, IL."
    },
    "max_rent": {
      "type": "number",
      "minimum": 0,
      "description": "Highest monthly rent in USD, or CAD for a Canadian location. Example: 2500."
    },
    "min_beds": {
      "type": "integer",
      "default": 0,
      "minimum": 0,
      "description": "Minimum bedrooms; 0 includes studios. Example: 2."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 50,
      "minimum": 1,
      "description": "Most listings to return. Example: 20."
    },
    "property_type": {
      "enum": [
        "any",
        "apartment",
        "house",
        "condo",
        "room"
      ],
      "type": "string",
      "default": "any",
      "description": "Kind of rental. Example: apartment."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "rentals"
  ],
  "properties": {
    "rentals": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "beds": {
            "type": [
              "string",
              "null"
            ]
          },
          "name": {
            "type": [
              "string",
              "null"
            ]
          },
          "baths": {
            "type": [
              "string",
              "null"
            ]
          },
          "address": {
            "type": [
              "string",
              "null"
            ]
          },
          "currency": {
            "type": "string"
          },
          "photo_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "square_feet": {
            "type": [
              "string",
              "null"
            ]
          },
          "listing_link": {
            "type": [
              "string",
              "null"
            ]
          },
          "monthly_rent": {
            "type": [
              "string",
              "null"
            ]
          },
          "pets_allowed": {
            "type": [
              "string",
              "null"
            ]
          },
          "available_date": {
            "type": [
              "string",
              "null"
            ]
          },
          "zumper_listing_id": {
            "type": [
              "string",
              "null"
            ]
          },
          "lowest_monthly_rent": {
            "type": [
              "number",
              "null"
            ]
          }
        }
      }
    }
  }
}
```

## See more

- [Zumper API: Get average rents by city](https://fous.com/methods/zumper.com/get-average-rents.md): Gets Zumper's current median monthly rents for studio through three-bedroom homes in a city, with monthly and yearly percentage changes. National rank is included only when the same-month U.S. national report ranks the city.
- [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.
- [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).
- [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.
- [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: Get housing market](https://fous.com/methods/zillow.com/get-housing-market.md): Looks up Zillow housing market figures for a city and state or five-digit ZIP code: typical home value, one-year change, list and sale prices, inventory and listing activity.
- [All Zumper methods](https://fous.com/methods/zumper.com.md)