Developers
MCP available

Data model: places and geography

Hierarchy

text
Country
└── Regions / CountryRegions / SubRegions / Destinations
    └── Cities
        └── Neighbourhoods
            └── Venues (Restaurants, Bars, Shopping, Attractions, Landmarks)

The hierarchy is not a promise that every location has every intermediate level. Some containers have different nesting; use IDs and parent/descendant relationships, not hardcoded assumptions about the number of levels.

Geographic container node types

Country, Regions, SubRegions, CountryRegions, Destinations, Cities, Neighbourhoods.

Venue node types

Restaurants, Bars, Shopping, Attractions, Landmarks.

Identity and navigation

  • id is a stable Evendo record identifier returned as a string.
  • slug_id is a human-readable geographic path, for example spain/madrid/attraction/museo-nacional-del-prado.
  • parent_id links a record to a parent; child_count may help identify immediate child records.
  • location { lat lon } provides geographic coordinates where available.
  • country_code is an ISO 3166-1 alpha-2 code.

Common fields

Category Example fields Notes
Identity id, slug_id, parent_id, node_type, title Core place identity
Text tagline, short_description, description Long description may contain HTML
Classification category, additional_categories, location_type Values are data-dependent
Location address, address_city, address_region, address_borough, address_zip, country_code, location Not every field is present
Reviews rating, rating_votes Review rating uses a different 0–5 scale
Evendo ranking place_score 0–100, higher is better
Media / external main_image, total_photos, phone, url Optional; external links are not booking actions
Attributes price_level, environment, audience, amenities, ambience, access, experience, sustainability, weather_suitability, style_* Vary across nodes

Dataset snapshot

A recent inventory snapshot (not live totals) reports 1,764,385 nodes, including Restaurants 346,458; Bars 262,126; Shopping 316,334; Attractions 422,059; Landmarks 335,494. The same snapshot lists 253 countries, 3,225 cities and 3,011 neighbourhoods. Coverage evolves; use nodeCount for current global GraphQL counts.

Data semantics

Search uses the place hierarchy. Returned address_city can differ from the resolved container name for venues in the surrounding hierarchy. Where different capitalization appears between filter enum input (such as Indoor) and returned display data (such as indoor), use the documented filter vocabulary rather than echoing record values directly.

Read MCP filters, GraphQL fields and Place Score.