Docs · Feed API

Feed API: weekly changes

GET /api/v1/feed/changes returns the rental listings added, changed and removed since the previous weekly version, so an app stays in sync without re-reading its whole file.

Request

curl -H "Authorization: Bearer $HOUSINGFEED_KEY" "https://housingfeed.com/api/v1/feed/changes?page=1"

Parameter	Meaning
`version`	Optional. Defaults to the current version.
`since`	Optional. An older version listed in `changes_from` on status, to catch up after a missed week. Without it, changes since the previous version.
`page`	Optional, from 1. Follow `next`.

Response

{
  "version": "2026-10-19",
  "since_version": "2026-10-12",
  "page": 1,
  "pages": 7,
  "changes": [
    {
      "change": "added",
      "uid": "hf_...",
      "listing": "{ listing }"
    },
    {
      "change": "changed",
      "uid": "hf_...",
      "fields": [
        "rent_min",
        "available"
      ],
      "listing": "{ listing }"
    },
    {
      "change": "removed",
      "uid": "hf_..."
    }
  ],
  "next": "/api/v1/feed/changes?version=2026-10-19&page=2"
}

change	What to do
`added`	Insert the listing.
`changed`	Replace the listing by `uid`; `fields` names what changed.
`removed`	The source stopped publishing it. Take it off display.

Changes are computed between two complete weekly versions, so a removal is a confirmed removal, never the result of a failed or partial read.

Want the full file for your market?

Tell us your cities and what you are building. You get a sample in the production format and the listing count for your markets, usually within one business day.

Request a sample