Open data: the stays file

Download and licence

/data/stays.json

The file is published under the licence CC BY 4.0.

Credit it as The Puglia Edit (https://thepugliaedit.com/) and keep the link to this page.

It holds 169 stays, one record each. There is one file for all languages: area names appear in every language. Areas, collections and guides are not in the file.

How to read the values

• null means not verified: we found no primary source for that fact. It does not mean no. Show it as not confirmed.
• evidence lists, for each factual field, the value, the source URL, the fetch date and a verbatim excerpt of at most 25 words.
• editor_visit is not_visited unless the editors have stayed there. Nothing in the file implies a visit.
• needs_human_review true means an editor has not yet checked the record.
• Distances are straight-line kilometres and are published only when the position is precise (building or street). Otherwise lat, lng and distances are null.
• The file was last updated on October 27, 2026. Each record carries its own last_verified and updated_at dates.

Price bands

price_band is a number from 1 to 5, a double room in high season per night. price_band_estimated true means the stay publishes no rate we could read and the band is our estimate from its positioning. price_band_scale in the file repeats these ranges.

1. 1 Under €250 a night
2. 2 €250 to €450 a night
3. 3 €450 to €750 a night
4. 4 €750 to €1,200 a night
5. 5 Over €1,200 a night

Fields

At the top of the file:

dataset

Name of the dataset.

license

Licence name (CC BY 4.0).

license_url

Link to the licence text.

attribution

The credit to give when you reuse the data.

documentation

This page.

updated

Date of the most recently updated record.

notes

The reading rules above, in one sentence each.

price_band_scale

The five price bands with their euro ranges and the basis (double room, high season, per night).

count

Number of stays in the file.

stays

The records, one per stay.

In each record of stays:

edit_number

Running number of the stay in the Edit.

name

Name as the property writes it.

slug

Stable identifier, the same in every language.

url

Page of the stay on this site.

type

masseria, boutique hotel, palazzo, trullo retreat, resort, villa or hotel.

area

Area slug and its name in each language.

comune

Municipality.

localita

Locality or hamlet, when the source names one.

lat

Latitude, only when the position is precise, otherwise null.

lng

Longitude, only when the position is precise, otherwise null.

position_precision

How exact the position is: building, street, locality or comune.

editor_visit

not_visited unless the editors have stayed there.

needs_human_review

true until an editor has checked the record.

price_band

Band from 1 to 5 (see Price bands).

price_band_estimated

true when the band is our estimate because no rate is published.

rooms

Number of rooms, or null.

suites

Number of suites, or null.

adults_only

true if the stay takes adults only, null if not verified.

min_age

Minimum age of guests, or null.

open_season

Months open (1 to 12), year-round, or null.

distances_km

Straight-line kilometres to the sea and to the airports, null when the position is not precise.

amenities

Pool, spa, restaurant and other amenities, each true, false or null.

pets

allowed, on request, not allowed, or null.

families

kids_welcome and family_rooms, each true, false or null.

weddings

hosts_weddings, max_guests, exclusive_use, ceremony_on_site and the source URL.

awards

Awards with name, year, issuer and source URL.

star_category

Official hotel category from the Regione Puglia register (stars, luxury flag, source URL, year), or null.

official_url

The property's official website.

sources

Source URLs the record is based on.

last_verified

Date the facts were last checked.

updated_at

Date the record last changed.

evidence

Value, source URL, fetch date and verbatim excerpt for each factual field.