Name: Zumper API: US Apartments and Houses for Rent as JSON
Brand: benthepythondev
SKU: api-benthepythondev-zumper-rentals
Availability: InStock
Author: API Market

## Overview

The Zumper Rentals API returns apartments and houses for rent in any US city as JSON. One endpoint takes Zumper city slugs such as `austin-tx` with optional rent, bedroom and property type filters, and returns each listing's address, ZIP and neighbourhood, rent range, beds and baths, amenities, pet policy, leasing phone, agent and brokerage, rating, coordinates and a 0 to 100 lead score.

It is built for rental market analysts building rent comps, property managers watching competing listings, apartment search apps and real estate lead generation. Labels are plain words instead of internal codes, and each row carries the leasing contact.

Turn on `onlyChanges` with your own `monitorId` and the same request becomes a rent-change watch: each later call returns only listings that are new or whose rent or details changed, with the previous rent and the change in dollars and percent. Call it on a schedule and you get rent-drop and new-listing alerts without storing and comparing answers yourself.

More US rentals from this seller: [HotPads Rentals API](https://api.market/store/benthepythondev/hotpads-rentals), [PadMapper Rentals API](https://api.market/store/benthepythondev/padmapper-rentals) and [Craigslist Real Estate API](https://api.market/store/benthepythondev/craigslist-real-estate).

## Features

*   **1 endpoint**: search Zumper by city or read listing links.
*   **Listing data**: rent range, beds, baths, amenities, pet policy and rating.
*   **Contacts**: leasing phone, agent and brokerage.
*   **Lead score**: a 0 to 100 score for each listing.
*   **Rent-change watch**: `onlyChanges` returns only new listings and rent or detail changes since your last call.
*   **Filters**: rent, bedrooms, property type and Airbnb-friendly.
*   **Rate limit**: up to 10 requests per second.

## Use Cases

*   **Rent comps**: compare asking rents in a city.
*   **Apartment search apps**: show listings with contacts.
*   **Lead generation**: rank listings by lead score.
*   **Market research**: track US rents and supply.
*   **Rent-drop alerts**: a scheduled watch per city and budget that reports price cuts and new listings.

## API Documentation

### Base URL

All requests go through the API.market gateway at this base URL:

```
https://prod.api.market/api/v1/benthepythondev/zumper-rentals
```

### Authentication

Every request needs your API.market key in the `x-api-market-key` header:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. Search rentals

Zumper API for apartments and houses for rent by US city: address, rent range, beds, baths, amenities, pet policy, phone, agent and brokerage, coordinates and a 0-100 lead score. Up to 10 listings per request, as JSON.

**Method:** `POST`

**Endpoint:** `/`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| mode | body | Choose whether to search listings or scrape specific URLs | string | No | search | - |
| locations | body | One or more Zumper city slugs to search, city then state (e.g. 'san-francisco-ca', 'new-york-ny', 'austin-tx'). Each is searched on its own with the filters below, and Maximum Listings applies per location. | array of string | No | - | - |
| location | body | One city slug, e.g. 'san-francisco-ca'. Kept so saved inputs keep working; it is searched together with Locations. | string | No | - | - |
| propertyType | body | Type of property to search | string | No | apartments-for-rent | - |
| minPrice | body | Include properties with an available unit at or above this monthly rent | integer | No | - | - |
| maxPrice | body | Include properties with an available unit at or below this monthly rent in USD. | integer | No | - | 100000 |
| minBeds | body | Lowest accepted bedroom count (0 includes studios) | integer | No | - | 5 |
| maxBeds | body | Highest accepted bedroom count | integer | No | - | 5 |
| airbnbFriendly | body | Use Zumper's verified Airbnb-friendly feature filter | boolean | No | false | - |
| listingUrls | body | Direct Zumper listing URLs to scrape (for direct_urls mode) | array of string | No | - | - |
| maxListings | body | Listings to return. A request returns 10 listings at most. | integer | No | 10 | 10 |
| maxPages | body | Result pages to read. Zumper serves 10 listings per result page. | integer | No | 20 | 1000 |
| includePhotos | body | Include Zumper photo IDs and photo count for each listing | boolean | No | true | - |
| onlyChanges | body | Rent-change watch: return only listings that are new or whose rent or details changed since the last request with the same `monitorId`. Unchanged listings are left out. | boolean | No | false | - |
| monitorId | body | Name of your watch, up to 80 characters. Watches are kept by this name across all callers of this API, so use a long random name only you know, and one name per search. | string | No | - | - |
| firstRunMode | body | First request of a new watch: `emitAll` returns the current listings as new, `seedOnly` only stores them as the starting point and returns an empty list. | string | No | emitAll | - |
| resetState | body | Start this watch again from the current listings. Send it once, then leave it out. | boolean | No | false | - |

**Example Request:**

```bash
curl -X POST 'https://prod.api.market/api/v1/benthepythondev/zumper-rentals/' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"location": "san-francisco-ca", "propertyType": "apartments-for-rent", "maxListings": 5}'
```

**Example Response (201 Created, trimmed):**

Long lists are cut to their first items and long text is shortened.

```json
[
  {
    "source": "zumper.com",
    "scraped_at": "2026-10-27T07:27:58.057112+00:00",
    "listing_id": 58574957,
    "url": "https://www.zumper.com/apartment-buildings/1717500/blueground-san-francisco-soma-san-francisco-ca",
    "name": "Blueground San Francisco",
    "address": "149 San Francisco New Montgomery St #1163, San Francisco, CA 94105",
    "street": "149 San Francisco New Montgomery St #1163",
    "city": "San Francisco",
    "state": "CA",
    "zipcode": "94105",
    "neighborhood": "SOMA",
    "latitude": 37.78714246632131,
    "longitude": -122.39963719035394,
    "price_min": 2840,
    "price_max": 10210,
    "beds_min": 0,
    "beds_max": 3,
    "baths_min": 1,
    "baths_max": 2,
    "rating": 9.9,
    "property_type": "Apartment",
    "amenities": [
      "Google Home",
      "Rooftop"
    ],
    "pets_allowed": [
      "Cats",
      "Dogs"
    ],
    "phone": "(415) 964-3025",
    "agent_name": "Blueground Us",
    "brokerage_name": "BLUEGROUND",
    "feed_name": "blueground_cities",
    "date_available": null,
    "has_fees": false,
    "image_ids": [
      761884337,
      761884338
    ],
    "image_count": 10,
    "lead_score": 81
  },
  {
    "source": "zumper.com",
    "scraped_at": "2026-10-27T07:27:58.057136+00:00",
    "listing_id": 65615391,
    "url": "https://www.zumper.com/apartment-buildings/p1156552/10-lyon-street-1190-haight-street-303rc-haight-ashbury-san-francisco-ca",
    "name": "153-159 Clayton St (Jer Properties)",
    "address": "153 153 -159 Clayton St, San Francisco, CA 94117",
    "street": "153 153 -159 Clayton St",
    "city": "San Francisco",
    "state": "CA",
    "zipcode": "94117",
    "neighborhood": "Haight Ashbury",
    "latitude": 37.7706,
    "longitude": -122.4435,
    "price_min": 6495,
    "price_max": 6495,
    "beds_min": 2,
    "beds_max": 2,
    "baths_min": 1,
    "baths_max": 1,
    "rating": 8.1,
    "property_type": "Apartment",
    "amenities": [],
    "pets_allowed": [],
    "phone": null,
    "agent_name": "153-159 Clayton St (Jer Properties)",
    "brokerage_name": "Andersen, Jung & Co.",
    "feed_name": "appfolio_mits",
    "date_available": null,
    "has_fees": false,
    "image_ids": [
      932884918,
      932884919
    ],
    "image_count": 10,
    "lead_score": 47
  }
]
```

### Rent-change watch

Send the same search with `onlyChanges` and a `monitorId` that only you know, for example from `openssl rand -hex 12`:

```bash
curl -X POST 'https://prod.api.market/api/v1/benthepythondev/zumper-rentals/' \
  -H 'x-api-market-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"locations": ["austin-tx"], "maxPrice": 1500, "minBeds": 1, "maxListings": 10, "onlyChanges": true, "monitorId": "austin-1bd-k3v9q2x7m4p8"}'
```

The first call returns the current listings with `change_type: "new"` (or nothing with `"firstRunMode": "seedOnly"`) and stores them as the starting point. Each later call returns only rows whose `change_type` is:

*   `new`: a listing the watch has not seen before.
*   `price_changed`: the minimum or maximum asking rent moved. The row carries `previous_price_min`, `previous_price_max`, `price_change_amount` and `price_change_percent` (both on the minimum rent).
*   `details_changed`: beds, baths, move-in date or listing link changed.

An empty list means nothing changed. Every change row also has `monitor_id`, `first_seen_at` and `detected_at`. For a rent-drop alert, keep the rows with `price_changed` and a negative `price_change_amount`.

Good to know: a watch covers the listings one request reads (up to 10), so narrow it with rent, bedroom and property-type filters and use one watch per search. It remembers listings seen in the last 90 days, up to 5,000. It does not report listings that were taken down, because a listing missing from one search is not proof that it was rented. In a test on October 28, 2026 the first call for Austin 1-bedroom rentals under $1,500 returned 5 new listings and the next call returned an empty list.

## Status Codes

| Code | Status | Description |
|---|---|---|
| 201 | Created | The request ran and the body holds the results. |
| 400 | Bad Request | The body is not valid JSON or a filter value is out of range. |
| 401 | Unauthorized | The `x-api-market-key` header is missing, invalid or expired. |
| 403 | Forbidden | Your subscription does not include this endpoint. |
| 404 | Not Found | The path, or the item you asked for, does not exist. |
| 429 | Too Many Requests | You sent more than 10 requests per second, or you used all 50 calls of the Free trial plan. |
| 500 | Internal Server Error | Something failed on the provider side. Retry after a short delay. |
| 503 | Service Unavailable | The service or its data source is temporarily unavailable. Retry with backoff. |

## Rate Limits

You can send up to 10 requests per second. Free includes 50 calls (a 7-day trial), Basic includes 1,500 calls a month for $9.99, Pro includes 12,000 calls a month for $29.99 and Mega includes 50,000 calls a month for $99.99. Requests above the limit return `429 Too Many Requests`; throttle your requests, back off before retrying, and honour the `Retry-After` header when it is present.

## FAQ

*   **What format do locations use?**
    Zumper city slugs such as `san-francisco-ca`.

*   **What does `airbnbFriendly` do?**
    It applies Zumper's verified Airbnb-friendly filter.

*   **What is `lead_score`?**
    A 0 to 100 score based on how complete and contactable the listing is.

*   **How do I get an alert when a rent drops?**
    Call the same search on a schedule with `onlyChanges: true` and a fixed `monitorId`, then keep rows with `change_type` `price_changed` and a negative `price_change_amount`.

*   **Can someone else see or reset my watch?**
    Only someone who sends the same `monitorId`. Use a long random name and keep it private.

*   **Does a call that finds no changes count against my plan?**
    Yes, a watch call is one call on your plan whether it returns changes or an empty list.

**Related US rental APIs from this seller:** [HotPads Rentals API](https://api.market/store/benthepythondev/hotpads-rentals), [PadMapper Rentals API](https://api.market/store/benthepythondev/padmapper-rentals), [Craigslist Real Estate API](https://api.market/store/benthepythondev/craigslist-real-estate)

## Contact Us

If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.


Live US rental listings from Zumper by city: rent range, beds, baths, amenities, pet policy, leasing phone and brokerage. JSON over one POST request.

Zumper API: US Apartments and Houses for Rent as JSON

Free