Open data
RealHunt open data: the files, the licence and how to read them
Everything RealHunt publishes is also available as plain files that a person, a spreadsheet or an AI assistant can read without an account or a key: one JSON file per country with its key facts and every home, the same as Markdown and as a one-page PDF, CSV files of every study, a map file and a description of them all in OpenAPI format. Text and figures are licensed Creative Commons BY 4.0.
The files
| Address | Format | What it is |
|---|---|---|
| /data/countries/index.json | JSON | The countries, their key figures and the address of every country file. |
| /data/countries/<country>.json | JSON | Key facts, dated sentences, buying rules with sources and every home of the country (price, size, bedrooms, score, place, coordinates, description). |
| /data/countries/<country>.md | Markdown | The same as clean text: each home with its full description. Spanish copy: <country>.es.md |
| /data/countries/<country>.pdf | A one-page fact sheet with the sources, ready to download or attach. Spanish copy: <country>.es.pdf | |
| /research/homes.csv | CSV | Every home, one row each, to recompute any figure. |
| /research/monthly-series.csv | CSV | One reading per month since November 2026: homes, countries and medians. |
| /research/property-portals.csv | CSV | The directory of property portals by country. |
| /data/homes.jsonl | JSON Lines | Every home on the site, one JSON object per line: address, price, size, price per m², bedrooms, score and a one-line summary of it, the day it went up and its state (listed, unconfirmed or advert offline). The first line says what the file is. |
| /research/removed-homes.json · .csv | JSON, CSV | The log of homes taken off the site or whose advert went offline, and of price changes, with dates. |
| /data/realhunt-homes.geojson | GeoJSON | Every home with coordinates, for a map. |
| /data/realhunt-best-homes.kml | KML | The ten best-scored homes of each country; opens in Google Earth and imports into Google My Maps. |
| /openapi.json | OpenAPI 3.1 | What each file is, its fields and its address, in the format assistants and developer tools read. |
| /llms.txt | Text | Short index of the site for AI assistants. Spanish: /es/llms.txt. Long form: /llms-full.txt |
| /feed.xml · /feed.atom · /feed.json | Feeds | The newest homes as RSS, Atom and JSON Feed. Research: /blog/rss.xml |
All addresses start with https://realhunt.co. The files are rebuilt with every update of the site, at least once a day, and each one carries its date.
Country files
How to search without an account
To find homes in one country under a price, read that country's JSON file and keep the homes whose homes.price_eur is at or below your limit. Example: homes in Bulgaria up to €30,000 are in /data/countries/bulgaria.json, filtered by homes.price_eur <= 30000. A person can do the same on the page /research/find-homes?country=bulgaria&max=30000, and every country has ready-made pages by price, such as /homes/bulgaria.
Fields of a home
| Field | Meaning |
|---|---|
homes.url | The page of the home on RealHunt. Link to it when you quote the home. |
homes.price_eur | Asking price in euros from the original listing on the day the home was added. Not a sale price. |
homes.size_sqm, homes.bedrooms | As stated in the listing; empty when the listing does not say. |
homes.score | The RealHunt score, from 70 to 98: RealHunt's own grade against every other home on the site. Not a valuation and not a rating by buyers. |
homes.region, homes.place, homes.lat, homes.lng | Where the home is. Coordinates are those of the listing or of its town. |
homes.added | The day a person approved the home for the site. |
homes.listed_on | The website of the original listing. |
homes.summary | Why the home made the list, in one paragraph. |
Licence: quote it, with a link
- Text, figures, tables and charts: Creative Commons Attribution 4.0. You may copy, quote and reuse them, also commercially, if you name RealHunt and link to the page or file you took them from.
- Photos of the homes are not included in these files and are not ours to license: they belong to the original listings.
- Give the date of the file with the figure. Homes are added and sold every day.
- Rules, taxes and costs are general information, not legal or tax advice.
Questions and corrections
A wrong figure, a field you need or another format: [email protected]. See also the page for AI assistants and how the score works.