Build with HousingFeed.

Start with the product you use. Display Feed delivery and Data API access have different setup instructions and usage rights.

Quickstart

The Data API is delivered as an Apify actor. You send one POST request with your filters as JSON and get an array of listing rows back synchronously. No SDK, no proxies, no infrastructure on your side.

# 2-bed listings in Austin, TX under $2,500 a month
curl -X POST "https://api.apify.com/v2/acts/housingfeed~rental-listings-api/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"country":"US","state":"TX","city":"Austin","minBeds":2,"maxRent":2500,"maxItems":200}'

To request CSV from the endpoint above, append &format=csv after the token parameter.

Authentication

Every request needs your Apify API token, passed as a query-string parameter. You find it in your Apify account under Settings, Integrations. Keep it secret and treat it like a password.

Endpoint

run-sync-get-dataset-items runs the actor and returns the dataset in one blocking call, which suits direct queries. For large or scheduled pulls, use the standard async Apify run endpoints and read the dataset when the run finishes.

Input parameters

All fields are optional. Send an empty body {} to get the freshest rows across all sources and countries. This table is generated from the actor's input schema.

Response schema

The API returns a JSON array of listing rows. Every row has the same 35 fields in the same order whatever the source or country. Any field can be null. The coverage column marks fields whose fill rate depends on what the source publishes; an unmarked field is not a completeness guarantee. Inspect your sample for actual field availability. This table is generated from the API's public field list.

Freshness fields

Three timestamps tell you how current each row is, so you can judge freshness yourself instead of trusting a label.

• first_seen_at: the first time HousingFeed saw this listing. newSinceDays filters on it, which selects new records only, not changes or removals.
• last_seen_at: the last time the listing was verified live at its source. A listing whose source stops publishing it is marked delisted and no longer returned.
• scraped_at: the collection run that produced the row. freshDays filters on it; by default rows last collected more than 30 days ago are excluded.

Delisted rows are excluded from responses. An ID missing from a filtered or capped query is not proof of removal. Reconcile only against a complete agreed snapshot or an explicit removal set; never delete records because a request failed.

Example response

One real row from the sample endpoint, rendered in schema order. The build refreshes it; the images list is shortened to three URLs for display.

[
  {
    "id": "hf_46a5e765a1db8b36d537",
    "source_type": "manager_direct",
    "listing_id": "2720698-D-4203",
    "url": "https://www.camdenliving.com/apartments/dallas-tx/camden-belmont/available-apartments?unit=4203",
    "address": "2500 Bennett Ave #4203, Dallas, TX 75206",
    "street": "2500 Bennett Ave",
    "city": "Dallas",
    "canonical_city": null,
    "state": "TX",
    "zip": "75206",
    "country": "US",
    "lat": 32.813148,
    "lng": -96.782188,
    "rent_min": 2379,
    "rent_max": 2379,
    "currency": "USD",
    "rent_usd": 2379,
    "rent_per_sqft": 1.8,
    "rent_per_sqm": 19.38,
    "beds": 2,
    "baths": 2,
    "sqft_min": 1325,
    "sqft_max": 1325,
    "property_type": "apartment",
    "furnished": null,
    "available": "2026-10-23",
    "units_available": null,
    "granularity": "unit",
    "image": "https://images.ctfassets.net/pg6xj64qk0kh/1RKAhV2BvxWt7rp1ik1ZMk/d953ab013c6ff5e0aa4fe65895231b29/camden-belmont-apartments-dallas-texas-floor-plan-Mulberry_3.jpg",
    "images": [
      "https://images.ctfassets.net/pg6xj64qk0kh/1RKAhV2BvxWt7rp1ik1ZMk/d953ab013c6ff5e0aa4fe65895231b29/camden-belmont-apartments-dallas-texas-floor-plan-Mulberry_3.jpg"
    ],
    "description": "Camden Belmont features one, two and three-bedroom apartments and two-bedroom townhomes centrally located in the vibrant Knox-Henderson district near Greenville",
    "amenities": [
      "Parking",
      "Balcony / patio",
      "Pool",
      "Fitness center",
      "Fireplace"
    ],
    "first_seen_at": "2026-09-08T18:10:09+00:00",
    "last_seen_at": "2026-09-27T05:22:29+00:00",
    "scraped_at": "2026-09-27T05:22:29+00:00"
  }
]

Query examples

These examples use the input parameters documented above. Source filters do not grant display rights or guarantee that every matching row qualifies for the Display Feed.

New listings: first seen this week

Select rows first seen in the last seven days and deduplicate by id. This does not return changed or removed records. Results are capped by maxItems; a capped query is not a complete sync.

{ "country": "US", "state": "NY", "newSinceDays": 7, "maxItems": 1000 }

Manager-direct sources only

Restrict the query to listings published by property managers and owners on their own software or websites rather than portals. Each row's source_type says which kind it is.

{ "managerDirectOnly": true, "state": "FL", "maxItems": 2000 }

Bounding box

Pass a map box and get the geocoded rows inside it, all sources, one schema. Downtown Miami:

{ "minLat": 25.70, "maxLat": 25.86, "minLng": -80.32, "maxLng": -80.10, "maxItems": 500 }

Freshness & cadence

Sources are not all on the same clock, and the API does not pretend they are.

Display Feed sources are checked weekly. Data API sources have different collection schedules; the dated source list below describes the saved coverage snapshot. Check each returned record’s timestamps. A scheduled refresh does not guarantee a successful verification of all records.

Every row carries first_seen_at, last_seen_at and scraped_at, and freshDays (default 30 days) keeps old snapshot rows out unless you ask for them. Confirm source scope and freshness when requesting your sample.

Display Feed sources are checked weekly. Data API source schedules vary; inspect returned timestamps and confirm freshness in your sample.

Limits & pricing

Check the Data API on Apify for current pricing. Each run returns at most 5,000 rows. This actor input has no cursor or offset parameter: narrow your filters or contact us for a complete export.

Versioning, rate limits and errors on housingfeed.com

The keyless sample lives at /api/v1/sample (/api/sample is an alias). Every response carries X-API-Version: 1 and the RFC RateLimit fields (RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset; about 30 requests per 10 minutes per IP), with Retry-After on a 429. Errors are JSON with a stable code (RATE_LIMITED, UPSTREAM_UNAVAILABLE, NOT_FOUND) and a hint. Treat this endpoint as a preview. A partial response means some sources failed; complete describes request completion, not a complete inventory export. Results remain capped at 10 records. The full contract, including the Data API actor's input schema, is openapi.json.

Rights

The Data API grants internal use only: research, analytics, internal tools and model evaluation within the general terms. Public display requires the Display Feed licence. See the Display Feed and the Display Feed terms.