HousingFeed US Rental Listings

Live US rental listings for an area and budget, no key needed. Returns at most 10 listings per call (rent, beds, baths, size, address, coordinates, photo, source link, days listed). Use a state code and a city for one market; add rent and bedroom limits to narrow it. For complete results a HousingFeed key is needed.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter US state code, e.g. NY."
    },
    "city": {
      "type": "string",
      "description": "City name, partial match, e.g. Brooklyn."
    },
    "min_rent": {
      "type": "number",
      "description": "Minimum monthly rent in USD."
    },
    "max_rent": {
      "type": "number",
      "description": "Maximum monthly rent in USD."
    },
    "min_beds": {
      "type": "number",
      "description": "Minimum bedrooms; 0 = studio."
    },
    "max_beds": {
      "type": "number",
      "description": "Maximum bedrooms. Same as min_beds for exactly N."
    },
    "min_lat": {
      "type": "number",
      "description": "South edge of a map box."
    },
    "max_lat": {
      "type": "number",
      "description": "North edge of a map box."
    },
    "min_lng": {
      "type": "number",
      "description": "West edge of a map box."
    },
    "max_lng": {
      "type": "number",
      "description": "East edge of a map box."
    },
    "new_since_days": {
      "type": "number",
      "description": "Only listings first seen in the last N days (new listings land weekly, Sunday to Tuesday UTC)."
    },
    "sort": {
      "type": "string",
      "enum": [
        "best",
        "newest",
        "cheapest",
        "rent_desc"
      ],
      "description": "best (default): photo and coordinates first, freshest, mixed sources."
    }
  },
  "additionalProperties": false
}

What rent costs right now in one US city or ZIP, no key needed: number of listings and the median, 25th and 75th percentile monthly asking rent, overall and by bedroom count (studio, 1, 2, 3, 4+). Based on listings verified at the source in the last 30 days. Give a state and a city or a ZIP.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter US state code, e.g. TX."
    },
    "city": {
      "type": "string",
      "description": "Full city name, e.g. Austin or New York (New York includes its five boroughs). Not a partial match."
    },
    "zip": {
      "type": "string",
      "description": "Exact 5-digit ZIP code; use instead of or with city."
    },
    "beds": {
      "type": "integer",
      "minimum": 0,
      "maximum": 4,
      "description": "Only this bedroom count: 0 = studio, 4 = four or more."
    },
    "include_rooms": {
      "type": "boolean",
      "description": "true = include rooms in shared homes (excluded by default)."
    }
  },
  "required": [
    "state"
  ],
  "additionalProperties": false
}

Requires a HousingFeed key. The current version of your licensed feed: listing count, when it was published, when the next weekly update is due, and how many listings were added, changed and removed.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Requires a HousingFeed key. Search the listings in your licensed feed by city, ZIP, rent, bedrooms or map box. Returns up to 50 per call with a total; page with offset.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter US state code."
    },
    "city": {
      "type": "string",
      "description": "City name, partial match."
    },
    "zip": {
      "type": "string",
      "description": "Exact ZIP code."
    },
    "min_rent": {
      "type": "number",
      "description": "Minimum monthly rent in USD."
    },
    "max_rent": {
      "type": "number",
      "description": "Maximum monthly rent in USD."
    },
    "min_beds": {
      "type": "number",
      "description": "Minimum bedrooms; 0 = studio."
    },
    "max_beds": {
      "type": "number",
      "description": "Maximum bedrooms. Same as min_beds for exactly N."
    },
    "min_lat": {
      "type": "number",
      "description": "South edge of a map box."
    },
    "max_lat": {
      "type": "number",
      "description": "North edge of a map box."
    },
    "min_lng": {
      "type": "number",
      "description": "West edge of a map box."
    },
    "max_lng": {
      "type": "number",
      "description": "East edge of a map box."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Listings to return (default 10)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Skip this many matches (for paging)."
    },
    "full": {
      "type": "boolean",
      "description": "true = every field of each listing, including description and photos."
    }
  },
  "additionalProperties": false
}

Requires a HousingFeed key. Listings added, changed or removed in the latest weekly update of your feed.

{
  "type": "object",
  "properties": {
    "change": {
      "type": "string",
      "enum": [
        "added",
        "changed",
        "removed"
      ],
      "description": "Only this kind of change."
    },
    "since": {
      "type": "string",
      "description": "Changes since this earlier version (one of feed_status's changes_from) instead of since the previous week; for a client that missed a week."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Changes to return (default 20)."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Skip this many changes (for paging)."
    }
  },
  "additionalProperties": false
}