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.

Updated

The files

AddressFormatWhat it is
/data/countries/index.jsonJSONThe countries, their key figures and the address of every country file.
/data/countries/<country>.jsonJSONKey facts, dated sentences, buying rules with sources and every home of the country (price, size, bedrooms, score, place, coordinates, description).
/data/countries/<country>.mdMarkdownThe same as clean text: each home with its full description. Spanish copy: <country>.es.md
/data/countries/<country>.pdfPDFA one-page fact sheet with the sources, ready to download or attach. Spanish copy: <country>.es.pdf
/research/homes.csvCSVEvery home, one row each, to recompute any figure.
/research/monthly-series.csvCSVOne reading per month since November 2026: homes, countries and medians.
/research/property-portals.csvCSVThe directory of property portals by country.
/data/homes.jsonlJSON LinesEvery 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 · .csvJSON, CSVThe log of homes taken off the site or whose advert went offline, and of price changes, with dates.
/data/realhunt-homes.geojsonGeoJSONEvery home with coordinates, for a map.
/data/realhunt-best-homes.kmlKMLThe ten best-scored homes of each country; opens in Google Earth and imports into Google My Maps.
/openapi.jsonOpenAPI 3.1What each file is, its fields and its address, in the format assistants and developer tools read.
/llms.txtTextShort index of the site for AI assistants. Spanish: /es/llms.txt. Long form: /llms-full.txt
/feed.xml · /feed.atom · /feed.jsonFeedsThe 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

FieldMeaning
homes.urlThe page of the home on RealHunt. Link to it when you quote the home.
homes.price_eurAsking price in euros from the original listing on the day the home was added. Not a sale price.
homes.size_sqm, homes.bedroomsAs stated in the listing; empty when the listing does not say.
homes.scoreThe 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.lngWhere the home is. Coordinates are those of the listing or of its town.
homes.addedThe day a person approved the home for the site.
homes.listed_onThe website of the original listing.
homes.summaryWhy the home made the list, in one paragraph.

Licence: quote it, with a link

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.

More data from RealHunt