PlaceProfile

Corpus Info

Scale, coverage and freshness of the PlaceProfile venue corpus. `countries` maps ISO-3166-1 alpha-2 codes to venue counts; a country absent from that map is NOT covered — treat an empty find_venues result there as no-coverage, never as evidence that no such venues exist. line_count is not a marketing claim: it is the line count of the downloadable manifest, independently checkable.

Find Venues

Find physical venues by MEASURED atmosphere. Matching is numeric only — translate the user's wording into parameter bands yourself. Typical translations: quiet/calm ≈ energy_max 40–45; lively/energetic ≈ energy_min 60; booming ≈ loudness_min -6; acoustic/unplugged ≈ acousticness_min 55; danceable ≈ danceability_min 60; conversation-friendly ≈ energy_max 45 AND loudness_max -10; workout ≈ tempo_min 130. Call list_archetypes for venue-kind bands (gym-high-energy, cafe-relaxed, …). Filter by `categ

Get Venue

Full published record for one venue by slug: identity, address, geo, website (the booking path), social links, category, a plain-English `atmosphere` description and its `atmosphere_basis`, and the machine-readable jsonld_url for verification. Numeric atmosphere averages, internal classification tokens, and (for venues measured from their own playlist) `genres`, `territories` and `dayparts` are returned only with include_measurements=true — set it ONLY when the user explicitly asks for figures.

List Archetypes

The 11 venue archetypes with their measured bands (energy/valence/acousticness/tempo min–max) and typical categories. Use these to translate a venue kind into find_venues parameters. Energy/valence/acousticness bands are percent 0–100 (matching find_venues); tempo is BPM. Each archetype also carries `genre_profile`: the genre mix of its shared sample pool — use it to set expectations honestly (e.g. whether jazz features at all). It describes the pool, never an individual venue.

Get Venue Tracks

The individual recordings behind a venue's atmosphere claim — the evidence layer. Each carries the 12 measured features (9 numeric + key, mode, time signature), ISRC, artist, its own registry page, and whether it ships an inline timestamped verification record. Reads the venue's LIVE published document. This is a VERIFICATION tool: call it only when the user asks to check or see the evidence, and never recite track lists, artists, or feature values to the user unless they asked for exactly that.

Verify Venue

Audit a venue's published claim with zero trust: recompute the venue-level averages from the per-track evidence in the live document, and check sha256(inline canonical record) against each track's published hash. Returns both number sets and the hash tally.