{"apiVersion":"2026-07-26","resource":"dataset","generatedAt":"2026-08-08T09:39:35.949Z","source":"HappyKava public API","name":"HappyKava Open Kava Bar Dataset","description":"Public, attribution-required HappyKava dataset resources for kava bar discovery, city aggregates, and aggregate menu price facts.","docs":"https://happykava.app/kava-data/open-dataset","openapi":"https://happykava.app/api/public/v1/openapi.json","license":{"name":"Attribution required","attribution":"Source: HappyKava public API v1","usage":"Public-use dataset resources may be cited, indexed, and analyzed with visible attribution to HappyKava."},"refreshPolicy":{"apiCache":"Public resources use short edge cache windows with stale-while-revalidate.","snapshotCadence":"Dataset consumers should treat these as live resources suitable for monthly snapshots."},"privacyBoundaries":["Exports include public directory, city aggregate, and aggregate menu price data only.","Exports do not include private owner settings, user profiles, check-ins, staff records, employment requests, payment data, or unpublished owner data.","Brand results remain query-based structured-menu matches until a canonical public brand catalog exists.","Strain rows are catalog and discovery data, not medical guidance, diagnosis, treatment, or dosing advice.","Review exports contain public display fields only. They never include user ids, email addresses, moderation notes, or private check-in data."],"resources":[{"name":"openapi_json","href":"https://happykava.app/api/public/v1/openapi.json","format":"application/json","description":"Machine-readable OpenAPI contract for HappyKava public API v1."},{"name":"bars_csv","href":"https://happykava.app/api/public/v1/bars.csv","format":"text/csv","description":"Public kava bar directory rows with canonical HappyKava profile URLs."},{"name":"cities_csv","href":"https://happykava.app/api/public/v1/cities.csv","format":"text/csv","description":"City/state aggregate counts for public kava bar directory hubs."},{"name":"prices_csv","href":"https://happykava.app/api/public/v1/prices.csv","format":"text/csv","description":"Aggregate structured menu price summaries by category and geography."},{"name":"bars_json","href":"https://happykava.app/api/public/v1/bars","format":"application/json","description":"Paginated public kava bar directory rows."},{"name":"bar_detail_json","href":"https://happykava.app/api/public/v1/bars/{barId}","format":"application/json","description":"One public bar with posted hours, public menu data, and recent published reviews."},{"name":"reviews_json","href":"https://happykava.app/api/public/v1/reviews","format":"application/json","description":"Paginated published reviews with privacy-safe bar and verification context."},{"name":"open_now_json","href":"https://happykava.app/api/public/v1/open-now","format":"application/json","description":"Paginated public kava bars that appear open now from posted hours."},{"name":"cities_json","href":"https://happykava.app/api/public/v1/cities","format":"application/json","description":"Paginated city/state aggregate rows."},{"name":"prices_json","href":"https://happykava.app/api/public/v1/prices","format":"application/json","description":"Structured public menu price samples and aggregate summaries."},{"name":"events_json","href":"https://happykava.app/api/public/v1/events","format":"application/json","description":"Current or recent public event discovery rows."},{"name":"deals_json","href":"https://happykava.app/api/public/v1/deals","format":"application/json","description":"Current or scheduled public deal discovery rows."},{"name":"brands_json","href":"https://happykava.app/api/public/v1/brands","format":"application/json","description":"Query-based structured menu matches for brand and product discovery."},{"name":"strains_json","href":"https://happykava.app/api/public/v1/strains","format":"application/json","description":"Public noble kava strain catalog records and discovery metadata."}],"preferredCitation":"For machine-readable facts, cite the matching HappyKava public API v1 resource and include the generatedAt timestamp from the response when available."}