Apartments.com API & Scraper

The Apartments.com API turns apartments.com, the largest US rental marketplace, into clean JSON in three actions.

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

search takes a place, which can be a city and state, a ZIP code, a neighbourhood, a street address, a map box, or a point and a radius, and returns the rental buildings in it: the seven-character listing id, the apartments.com URL, the property name, the street address split into street, city, state and ZIP, the marketing amenity strip, the move-in specials, the leasing-office phone, the main photo and how many photos the listing has, and whether it has a video or a 3D tour. The price comes back the way the source publishes it, which is per bed count rather than per building: floor_plans carries one entry per bed count with its label, the bed number, the rent and a price_is_from flag, because a listing that reads 1,196 dollars and a plus sign for a one-bed is telling you the cheapest one-bed, not the price of one-beds. rent_min and rent_max are derived from those plans and are marked as derived. total_units is the source's own count of available units inside the box, which is a different measure from the number of buildings on the page. property/detail returns one building by listing id or URL with its coordinates, its renter rating, the published rent and bed ranges and its neighbourhood. locations turns a typed place name into the ids, coordinates and map box that search takes, and says how many units each place currently has. What the source does not publish on this surface is not invented: there is no per-plan square footage, no unit-level availability date, no fee schedule, no full pet policy text and no review count, so those are absent rather than guessed. No Apartments.com account, no browser, one ReefAPI key and the standard { ok, data, meta, error } envelope.

{
  "method": "POST",
  "url": "https://api.reefapi.com/apartments/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "location": "Austin, TX",
    "limit": 40
  }
}

{
  "ok": true,
  "meta": {
    "api": "apartments",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 7153.2,
    "record_count": 0,
    "bytes": 199698,
    "cache_hit": false,
    "stop_reason": "empty_page",
    "pages_read": 1,
    "charged_credits": 2,
    "version": "1.0.0"
  },
  "data": {
    "results": [],
    "total_units": null,
    "new_unit_count": null,
    "location": {
      "location_id": "0hvrl11",
      "display": "Austin, TX",
      "type": "city",
      "type_id": 2,
      "city": "Austin",
      "state": "TX",
      "postal_code": null,
      "county": null,
      "market": "Austin",
      "latitude": 30.29612,
      "longitude": -97.73298,
      "bounding_box": {
        "lower_right": {
          "lat": 30.07558,
          "lng": -97.52759
        },
        "upper_left": {
          "lat": 30.51666,
          "lng": -97.93836
        }
      },
      "available_unit_count": 34986
    },
    "bounding_box": {
      "lower_right": {
        "lat": 30.07558,
        "lng": -97.52759
      },
      "upper_left": {
        "lat": 30.51666,
        "lng": -97.93836
      }
    },
    "page": 1,
    "limit": 40,
    "sort": "default",
    "filters_applied_by": null
  }
}

curl -X POST https://api.reefapi.com/apartments/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"location":"Austin, TX","limit":40}'

import requests

r = requests.post(
    "https://api.reefapi.com/apartments/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "location": "Austin, TX",
  "limit": 40
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/apartments/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "location": "Austin, TX",
  "limit": 40
}),
});
const { ok, data, meta, error } = await res.json();