Real-estate market statistics
Median and average price, price per m², area and listing counts across residential and commercial listings — addressed either by H3 cell or by a place name this API resolves for you.
Start here
Quickstart
From no token to your first market figure, in five minutes.
Authentication
How tokens work, and what each refusal means.
API Reference
Every endpoint, every parameter, with a live playground.
Current stats GET
Jump straight to /stats/current in the reference.
What you can build
The API answers four kinds of question.
Market figures. /stats/current returns
median and average price, price per m², area and listing count for every H3 cell in a
territory. Name that territory in one of three ways: by cell, by place, or by a circle
around a point.
Places. You have a name; the API has ids.
/geo/search turns "Valencia" into a geo_id
you can query. /geo walks the tree when you do not
have a name yet, and /geo/lookup answers the
reverse question: what is this cell called?
Coverage. /coverage says which countries
this API can answer for and how current each market's inventory is — before you spend a
metered call finding out.
Spend. /usage reports what this token has
spent and what is left, per endpoint group. It costs nothing to ask.
Discovery is free, on purpose
Everything above except /stats/current is uncounted. Read Quota for why
that is a design decision rather than an oversight.
Before you cite a number
Three rules decide whether a figure means what you think it means. Each has its own section in Data, and all three are worth reading before the first integration goes out.
- A figure describes one complete period, not today.
as_ofcan be up to 34 days old. - A row with
estimated: truecarries borrowed figures, pooled from neighbouring cells. - Price filters are always USD, whatever display
currencyyou asked for.