DarakPlatform
Use casesDocsGuidesPricing
DocsGuides
Guides

Start here

  • Quickstart
  • Authentication

AI & MCP

  • Connect an AI assistant
  • Build with Darak and AI

About the data

  • What a listing is
  • Coverage and freshness

Building with it

  • Searching and filtering
  • Webhooks
  • Keeping a copy in sync

Operating

  • Limits and quotas
  • Pagination
  • Retrying safely
  • Errors
  • Versioning

Policies

  • Terms in practice

API reference →

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 and link to the original ad (source.url).