Vibes
Rank venues by atmosphere, such as calm, candlelit, rustic or a hidden gem, and read each venue's vibes.
vibes describes what a place is like to be in: how loud it is, how dressed-up it feels, the decor, the light and the crowd. Venues with more of the requested vibes get a higher matchScore and appear higher in the results.
"preferences": {
"vibes": ["candlelit", "intimate", "hidden_gem"]
}By default this is a ranking preference. To only return venues with at least one of the vibes, add "vibes" to nonCompromise:
"preferences": {
"vibes": ["calm", "quiet"],
"nonCompromise": ["vibes"]
}Each venue in a response has a vibes list, strongest first, or [] when its atmosphere isn't known. There is no fixed number: a venue can be cosy, candlelit, romantic and rustic at once.
Vibes describe the experience of being there, not the food or the price. A cheap café can be romantic, and an expensive restaurant can be casual.
How vibes fit together
Some vibes sit at opposite ends of a scale, so a venue never has both. A venue is never calm and lively, or casual and upscale.
| Scale | Low | High |
|---|---|---|
| Energy | calm, quiet, serene, subdued, chilled | lively, loud, bustling, vibrant, electric, pumping, fast_paced, spirited, party |
| Formality | casual, laid_back, unassuming, no_frills | upscale, swanky, opulent, luxurious, posh, glamorous |
| Trendiness | traditional, old_school | trendy |
| Fame | hidden_gem | iconic, institution |
| Brightness | subterranean | airy |
| Showiness | discreet | performative |
minimalist and opulent, and quiet and pumping, are never set together either.
Some vibes come with a broader one: a farmhouse venue is also rustic; opulent, luxurious and posh venues are also upscale; serene and subdued venues are also calm; and bustling, vibrant, electric, pumping and party venues are also lively.
Seeing it as a shape
Put a venue's vibes on the scales and you get its shape. The further out on a spoke, the more of that quality; the middle ring means neither end. Here are two made-up venues:
- Cellar bar:
subterranean,moody,candlelit,discreet,hidden_gem,upscale,calm - Brunch café:
lively,casual,friendly,trendy,airy,local
The two shapes barely overlap: someone after a quiet, tucked-away, dressed-up evening and someone after a bright, busy brunch want very different places.
Values
Values are lowercase snake_case. The words under "Also accepted" mean the same vibe: you can send them, and responses always use the main name. Case, spaces and hyphens are forgiven ("Laid-back" is read as laid_back). Values not in this list are ignored.
Energy
| Vibe | Also accepted | Means |
|---|---|---|
| calm | peaceful | Easy to hold a conversation. |
| quiet | Low noise, few people talking loudly. | |
| serene | tranquil | A soothing, restful setting. |
| subdued | Muted, hushed, low-key lighting and sound. | |
| chilled | low_key | Relaxed pace, nobody in a hurry. |
| lively | Plenty going on, a cheerful buzz. | |
| loud | Music or chatter you have to talk over. | |
| bustling | Busy, packed, people coming and going. | |
| vibrant | buzzy | Energetic, colourful, full of life. |
| electric | A charged, exciting atmosphere. | |
| pumping | high_octane | Loud music, high energy, often a DJ. |
| fast_paced | Quick service, high turnover, in and out. | |
| spirited | Enthusiastic, high-spirited crowd and staff. | |
| party | DJs, dancing or late-night celebrations. |
Formality
| Vibe | Also accepted | Means |
|---|---|---|
| casual | No fuss, come as you are. | |
| laid_back | easy_going | Relaxed service and dress. |
| unassuming | down_to_earth | Modest, no pretence. |
| no_frills | Basic setting, the food or drink is the point. | |
| charming | Endearing, characterful, pleasing details. | |
| refined | Polished, elegant, carefully done. | |
| upscale | high_end | Special-occasion, polished service. |
| swanky | swish | Fashionable and expensive-looking. |
| opulent | lavish | Rich, ornate decor, chandeliers, velvet, gilt. |
| luxurious | Luxury materials, service and experience. | |
| posh | Grand, upper-class, white tablecloths. | |
| glamorous | Dazzling, dressed-up, a place to be seen. |
Mood
| Vibe | Also accepted | Means |
|---|---|---|
| romantic | Made for a date, couples' tables. | |
| intimate | Few tables, close and private-feeling. | |
| candlelit | Candles on the tables, soft light. | |
| moody | Dark interior, low dramatic lighting. | |
| mysterious | Secretive, intriguing, unmarked. | |
| speakeasy | A hidden bar behind an unmarked door or password. | |
| cosy | cozy, snug | Warm, comfortable, tucked-in. |
| small | Only a handful of tables or a tiny room. | |
| warm | Warm lighting, colours and hospitality. | |
| homely | Like eating in someone's home. | |
| welcoming | Guests are made to feel at home. | |
| friendly | Warm, chatty staff. |
Style
| Vibe | Also accepted | Means |
|---|---|---|
| rustic | Reclaimed wood, simple and earthy. | |
| farmhouse | Country kitchen, long tables, farm setting. | |
| industrial | Exposed brick, steel, pipes, warehouse or railway arch. | |
| bohemian | Mismatched furniture, plants, free-spirited. | |
| artistic | Art on the walls, galleries, creative crowd. | |
| minimalist | stripped_back | Clean lines, little decoration. |
| sleek | Smooth, modern, polished design. | |
| retro | vintage | Decor from a past decade. |
| nostalgic | Evokes the past, old favourites. | |
| camp | Theatrical, over the top, knowingly kitsch. | |
| airy | Light, high ceilings, big windows. | |
| subterranean | A basement, cellar or vault. | |
| scenic | Notable views, rooftop, riverside, waterside or garden setting. |
Crowd
| Vibe | Also accepted | Means |
|---|---|---|
| boozy | Drinking is the main event. | |
| performative | Theatrical service, open kitchen shows, tableside theatre. | |
| discreet | Private, out of the public eye, unobtrusive service. | |
| local | neighbourhood, neighborhood | Regulars, serves the people who live nearby. |
| community | Community-run or a gathering place, events for locals. | |
| business | corporate | Suits, expense-account lunches. |
| professional | Efficient, well-drilled service. | |
| late_night | Comes alive late, a late-night haunt. | |
| trendy | Fashionable, the place of the moment. | |
| edgy | Daring, unconventional, provocative. | |
| gritty | Raw, urban, unpolished on purpose. | |
| alternative | Counter-culture crowd and music. | |
| quirky | Unusual decor or concept. | |
| eccentric | Odd and idiosyncratic, a one-off. |
Character
| Vibe | Also accepted | Means |
|---|---|---|
| authentic | True to a cuisine or place, not a theme. | |
| traditional | Customs, decor and dishes kept as they were. | |
| old_school | Unchanged for decades, classic service. | |
| timeless | Classic design that does not date. | |
| institution | Long-established, part of the area's life. | |
| historic | A historic building or long history. | |
| iconic | Famous, widely known. | |
| hidden_gem | Little known, tucked away, a find. |
Dress codes are separate: see dressCode.
Examples
{
"locations": [{ "lat": 51.5136, "lon": -0.1365 }],
"mode": { "mode": "POINT", "maxDistance": 800 },
"preferences": {
"vibes": ["calm", "cosy", "welcoming"],
"nonCompromise": ["vibes"]
}
}{
"locations": [{ "lat": 51.5246, "lon": -0.0784 }],
"mode": { "mode": "POINT", "maxDistance": 1000 },
"preferences": {
"vibes": ["electric", "party", "late_night"],
"establishmentFilters": ["serves_cocktails"]
}
}{
"locations": [{ "lat": 51.5099, "lon": -0.1462 }],
"mode": { "mode": "POINT", "maxDistance": 1500 },
"preferences": {
"vibes": ["romantic", "candlelit", "refined", "scenic"],
"establishmentFilters": ["serves_dinner"]
}
}