Sending listings

How listings are matched

Which listing a delivery creates or updates, and what happens when the same property is sent more than once.

Agency, then your reference

A listing is the agency's ListStream ID plus your own listing reference (uniqueID in REAXML, or the ID in the API path). Send changes with the same reference and the same listing updates; the newest modTime / modifiedAt wins.

Agents belong to agencies

Listings are always published under the agency. Agents are the people named on a listing: up to 5 in JSON, the lead agent first (listingAgent id="1" in REAXML).

One current listing per address, per agency

If an agency already has a current listing at the same address under another reference, a new one is skipped with a message naming the existing reference. A listing that came from a hand upload in the dashboard is replaced by yours instead. Units at the same street address are different properties; listings with a withheld street address aren't matched by address.

Several campaigns per property

Another agency's listing, or a later campaign after a sale, is kept as a separate listing. An old page links to the current one; a current page lists past campaigns, with other agencies' shown as facts only. You never see another agency's listings through the API.