What a listing is

Prices. price.yearly_sar is the comparable number: rentals posted monthly, weekly or daily are converted to a yearly amount, and sales are the total price. price.as_posted keeps the advertiser's original amount and period.
One listing per property. When the same property is posted on several sources, Darak keeps one listing and lists the others in also_listed_on.
Quality filtering. Search and counts exclude listings with implausible prices or sizes, the same filter darak.app uses. GET /listings/{id} and /listings/batch skip that filter, so they return listings search won't.
Photos are a condition of being served. A listing is only available once Darak has copied its photos to its own CDN — a newly scraped listing appears a little later, and one that never gets photos never appears at all. Land is exempt, since land is routinely advertised without any. This applies to detail and batch lookups too: a photo-less apartment is a 404, and comes back in missing_ids.
Freshness. first_seen_at is when Darak first saw a listing. updated_at is its last update at the source, or the last time Darak saw it if the source doesn't publish update times. last_seen_at is when Darak last confirmed it is live.
Asking prices. Listings are asking prices, not transaction prices. Data comes from third-party sources and may be incomplete or out of date.
Attribution. Where you show listings to your users, credit Darak, link the listing's url, and credit its source by name (source.name). On paid plans source.url is a darak.app link that forwards to the original ad; on Free it and source.listing_id are null.

What a listing is

Prices. price.yearly_sar is the comparable number: rentals posted monthly, weekly or daily are converted to a yearly amount, and sales are the total price. price.as_posted keeps the advertiser's original amount and period.
One listing per property. When the same property is posted on several sources, Darak keeps one listing and lists the others in also_listed_on.
Quality filtering. Search and counts exclude listings with implausible prices or sizes, the same filter darak.app uses. GET /listings/{id} and /listings/batch skip that filter, so they return listings search won't.
Photos are a condition of being served. A listing is only available once Darak has copied its photos to its own CDN — a newly scraped listing appears a little later, and one that never gets photos never appears at all. Land is exempt, since land is routinely advertised without any. This applies to detail and batch lookups too: a photo-less apartment is a 404, and comes back in missing_ids.
Freshness. first_seen_at is when Darak first saw a listing. updated_at is its last update at the source, or the last time Darak saw it if the source doesn't publish update times. last_seen_at is when Darak last confirmed it is live.
Asking prices. Listings are asking prices, not transaction prices. Data comes from third-party sources and may be incomplete or out of date.
Attribution. Where you show listings to your users, credit Darak, link the listing's url, and credit its source by name (source.name). On paid plans source.url is a darak.app link that forwards to the original ad; on Free it and source.listing_id are null.