Open data: car boot sales

Get the data

JSON: GET https://staging.eventris.app/open-data/v1/car-boots.json
XML: GET https://staging.eventris.app/open-data/v1/car-boots.xml (the same document; lists become repeated elements: listings/listing, dates/date, entry_prices/price)
iCal per listing: GET https://staging.eventris.app/open-data/v1/car-boots/{slug}.ics

The /v1/ URLs are stable: a change that could break a reader gets a new version, and the old one keeps running alongside it. The unversioned URLs (/open-data/car-boots.json) always serve the current version.

Licence and attribution

Creative Commons Attribution 4.0 International (CC BY 4.0). Wherever you show the data, credit it as:

Source: Eventris

with a link to this page (https://staging.eventris.app/open-data) or to the listing's own url where you show a single listing. Please also show cancellations: a reader who drives to a rained-off car boot blames whoever told them it was on.

Personal data

None. The feed carries only what each organiser chose to publish as their business contact. Never use it to send marketing to an organiser who has not agreed to it.

Updates, caching and limits

Live: organisers change their listings at any time, and a cancellation shows within 5 minutes.
Responses carry ETag and Last-Modified. Send If-None-Match / If-Modified-Since and you get 304 Not Modified when nothing changed.
Please fetch at most every 15 minutes. Each address may make 60 requests a minute across all open data URLs; beyond that the answer is 429.
CORS is open (Access-Control-Allow-Origin: *), so you can fetch it from a web page.
Only dates from today onwards are included.

Document

Top level: version ("1"), type, generated_at, last_modified, licence {name, title, url, attribution, attribution_url}, publisher {name, url}, documentation, count, listings[]. Each listing:

Field	Type	Meaning
id	string	Stable identifier of the listing (UUID). Use it to de-duplicate.
slug	string	The listing's path segment; stable once published.
type	string	"car_boot". More community event types will follow under their own feeds.
name, description	string	As the organiser wrote them.
url	url	The listing's public page. Link to it when you show the listing.
ical_url	url	The listing's dates as an iCalendar file.
book_pitch_url	url\|null	Where sellers book and pay for a pitch online, when the organiser sells pitches through Eventris.
organiser	object	name, website, phone, email, facebook: the organiser's BUSINESS contact, only what they chose to publish. Any may be null.
venue	object	name, address, town, county, postcode, region (UK nation or English region), country, latitude, longitude (WGS84).
timezone	string	IANA timezone of the times below (Europe/London).
opening_times	object	sellers_from, public_from, closes: local times "HH:MM", or null when not published.
schedule	object	weekday, season_starts, season_ends: the usual pattern, for information. The dates list is authoritative.
entry_prices	array	Visitor prices: code (adult, child, early_entry), label, price_pence (integer, minor unit), price (decimal string, major unit), currency (ISO 4217), free (boolean). Absent = not published.
pitch_prices	array	Seller pitch prices, same shape plus bookable (true when bookable online). Codes car, van, large, or the organiser's own tier names when sold online.
facilities	object	toilets, refreshments, parking, dogs_allowed, accessible: true / false. A missing key means not stated.
surface	string\|null	field, hard_standing, mixed or indoor.
dates	array	Upcoming dates: date (YYYY-MM-DD), status (scheduled \| cancelled), cancellation_reason (weather \| ground_conditions \| other \| null), note, starts_at and ends_at (ISO 8601 with offset).
dates_confirmed_at	datetime\|null	When the organiser last confirmed the season's dates.
updated_at	datetime	When the listing last changed, including a date's status.

Run a car boot?

List it once, free, and it appears here, in the feed, in Google's event search and everywhere that reuses the data.

List your car boot