Technical Concepts

Attribution

Every response tells you where the data came from.

Chora is a consolidation layer over public data. The upstreams have licenses that require attribution when you display their data downstream. We make it easy by returning a sources[] array on every response.

The sources array

{
  "location": { "lat": 51.38, "lng": -2.36 },
  "applicable": true,
  "restaurants": [ ... ],
  "sources": [
    { "provider": "MICHELIN Guide", "url": "https://guide.michelin.com", "license": "Fact data (name, coord, tier); editorial content excluded" },
    { "provider": "Wikipedia", "url": "https://en.wikipedia.org/", "license": "CC BY-SA 4.0 (facts and public photos)" }
  ],
  "meta": { "..." }
}

Display these sources near the rendered data. A small “Data from…” line is fine. Provide clickable links where the URL is included.

What each source powers

SourceLicensePowers
Open-MeteoCC BY 4.0Weather forecast, climatology, sunrise/sunset, marine, snow
Ticketmaster DiscoveryTicketmaster Developer TermsTicketed events during the stay
Headout Affiliate APIHeadout Affiliate TermsBookable tours and attractions
Foursquare PlacesFoursquare Developer TermsRestaurants (Foursquare-rated)
MICHELIN GuideFact-only republishing (no editorial/images)Star-rated + Bib + Selected restaurants
WikipediaCC BY-SA 4.0UK MICHELIN restaurant facts + thumbnails, wildlife article links
OpenStreetMap (via Overpass)ODbLNearby amenities (pubs, shops, ATMs, pharmacies)
OurAirportsPublic DomainAirport locations for transport tile
iNaturalistPer-observation licensesSeasonal wildlife signal
Nager.Date + curated cataloguePublic / internalIconic annual festivals
Google Maps EmbedGoogle Maps TermsDirections embed inside transport tile
Royal Horticultural SocietyRHS Partner Garden facts (name, coord, opening info); editorial content excludedRHS Partner Gardens tile
UNESCO World Heritage CentreOfficial UNESCO World Heritage List dataWorld Heritage Sites tile
DarkSky InternationalDarkSky International Dark Sky Places facts (name, coord, category, year); editorial content excludedDark Sky Places tile
National TrustProperty + trail facts (name, coord, description, distance, category); editorial content excludedNational Trust + NT Walks tiles

Rendering attribution

Minimum acceptable pattern. A small footer line near the widget:

Data from Open-Meteo, MICHELIN Guide, Ticketmaster.

Better. Link each provider to its site:

Data from Open-Meteo, MICHELIN Guide, Ticketmaster.

Attribution in the embedded widget

The pre-composed HTML widget (/v1/pulse) renders an attribution footer automatically. You don’t need to add anything else on the host page — the widget is self-contained.

If you’re composing JSON sections yourself, you own the attribution footer. Collect the sources[] arrays across responses, dedupe by provider, and render them once near the widget.