Can I use the HappyKava Open Kava Bar Dataset?

Yes. Public dataset resources may be cited, indexed, and analyzed with visible attribution to HappyKava and the matching public API v1 resource.

How fresh is the dataset?

Public API resources use short edge cache windows with stale-while-revalidate. Consumers should treat the live API and CSV exports as suitable sources for monthly snapshots.

HappyKava Data Desk

Open kava bar dataset for public research and products.

Use HappyKava public API v1 and CSV exports for kava bar directory rows, city aggregates, events, deals, prices, brands, strains, and attribution guidance.

OpenAPI JSON Dataset manifest

Dataset2026-06-11

Formats

API resources and exports

CSV + JSONHappyKava

Use

Visible source credit

AttributionHappyKava

Scope

No private account data

PublicHappyKava

2026-06-11API Version

13Resources

CSV + JSONFormats

PublicScope

Resources

Dataset resources

Use the public API for machine-readable reads or CSV endpoints for simple snapshots.

OpenAPI JSON

Machine-readable OpenAPI contract for HappyKava public API v1.

application/jsonnone

Bars CSV

Public kava bar directory rows with canonical HappyKava profile URLs.

text/csvstate, city, q

Cities CSV

City/state aggregate counts for public kava bar directory hubs.

text/csvstate, city, q

Prices CSV

Aggregate structured menu price summaries by category and geography.

text/csvstate, city

Bars JSON

Paginated public kava bar directory rows.

application/jsonstate, city, q, limit, offset

Open Now JSON

Paginated public kava bars that appear open now from posted hours.

application/jsonstate, city, q, limit, offset

Cities JSON

Paginated city/state aggregate rows.

application/jsonstate, city, q, limit, offset

Events JSON

Current or recent public event discovery rows with canonical event links.

application/jsonstate, city, q, limit, offset

Deals JSON

Current or scheduled public deal discovery rows.

application/jsonstate, city, q, limit, offset

Prices JSON

Structured public menu price samples and aggregate summaries.

application/jsonstate, city, q, limit, offset, max_bars

Brands JSON

Query-based structured menu item matches for brand and product discovery.

application/jsonq, state, city, limit, offset, max_bars

Strains JSON

Public noble kava strain catalog rows and discovery metadata.

application/jsonprofile, category, q, limit, offset

Dataset manifest

Attribution, refresh, resource, and privacy-boundary manifest.

application/jsonnone

Terms

Use the data with clear attribution.

Public-use dataset resources may be cited, analyzed, and used in products with visible attribution to HappyKava.

Attribution

Use visible source text such as: Source: HappyKava public API v1.

Refresh

Resources use short cache windows and are suitable for monthly snapshots.

Empty Results

Filtered reads return empty collections instead of invented counts.

Resource URL

Include the endpoint URL and generated timestamp when citing a response.

Privacy

The public boundary is explicit.

The dataset is intentionally limited to public discovery and aggregate fields.

boundary_1Exports include public directory, city aggregate, live public discovery, catalog, and aggregate menu price fields only.public-only

boundary_2Exports do not include private owner settings, user profiles, check-ins, staff records, employment requests, payment data, unpublished owner data, or private moderation fields.public-only

boundary_3Brand results remain query-based structured-menu matches until a canonical public brand catalog exists.public-only

boundary_4Strain rows are catalog and discovery data, not medical guidance, diagnosis, treatment, or dosing advice.public-only

Start with the contract

The OpenAPI contract and dataset manifest describe available resources, refresh expectations, and attribution guidance.

OpenAPI/api/public/v1/openapi.json

Manifest/api/public/v1/dataset

Index/api/public/v1