Search the public directory (opt-in venues only) by location, opening status, cuisine, dietary options, declared attributes, ordering channel, declared price level and menu language — whether a guest can pay online through Thmenu and, right now, a free table or an open waitlist (the restaurant graph's channel states). Neutral ranking (AI-K6): distance in 0.5 km bands when `near` is given → availability (open now first; unknown hours before closed; a venue in holiday mode counts as closed) → profile freshness (owner-verified within 90 days first) → name. Payment to Thmenu never affects order. Cuisine, dietary, price level and other attributes are owner declarations, not verified facts; venues without a declaration are excluded only when an attribute or price filter is used, and venues without coordinates only when `near` is used. Returns slug, name, city, country, distance_km, is_open_now (serve-time, in the venue's own timezone; null when hours are unknown; false while the venue is in holiday mode), channels (order · reservation · pickup · delivery), declared attributes, freshness and the menu URL. Paginated.
View input schema
{
"type": "object",
"properties": {
"near": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"description": "Search centre. Venues without coordinates are excluded when set."
},
"radius_km": {
"type": "number",
"minimum": 0.5,
"maximum": 100,
"default": 10
},
"open_now": {
"type": "boolean",
"default": false,
"description": "Only venues open right now in their own timezone; venues with unknown hours are excluded when true."
},
"cuisine": {
"type": "array",
"items": {
"type": "string",
"enum": [
"turkish",
"kebab",
"ottoman",
"anatolian",
"aegean",
"black_sea",
"mediterranean",
"middle_eastern",
"lebanese",
"persian",
"georgian",
"greek",
"balkan",
"romanian",
"polish",
"eastern_european",
"russian",
"italian",
"pizza",
"pasta",
"french",
"spanish",
"tapas",
"portuguese",
"german",
"austrian",
"british",
"irish",
"scandinavian",
"dutch",
"american",
"burger",
"steakhouse",
"bbq",
"tex_mex",
"mexican",
"latin_american",
"brazilian",
"peruvian",
"caribbean",
"japanese",
"sushi",
"ramen",
"chinese",
"korean",
"thai",
"vietnamese",
"indian",
"pakistani",
"indonesian",
"malaysian",
"filipino",
"african",
"ethiopian",
"moroccan",
"seafood",
"grill",
"vegetarian",
"vegan",
"healthy",
"cafe",
"coffee",
"tea_house",
"bakery",
"patisserie",
"dessert",
"ice_cream",
"breakfast_brunch",
"fast_food",
"street_food",
"fusion",
"international",
"fine_dining",
"bistro",
"pub",
"bar",
"wine_bar",
"cocktail_bar",
"juice_bar",
"food_court"
]
},
"description": "All listed cuisines must be declared by the venue."
},
"dietary": {
"type": "array",
"items": {
"type": "string",
"enum": [
"vegetarian_options",
"vegan_options",
"gluten_free_options",
"lactose_free_options",
"halal",
"kosher"
]
},
"description": "Owner declaration, not a certification."
},
"attributes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Any declared attribute token (meals, family, outdoor, accessibility, cuisine, dietary)."
},
"channel": {
"type": "string",
"enum": [
"order",
"reservation",
"pickup",
"delivery"
],
"description": "order = digital ordering at the table; reservation; pickup = takeaway; delivery = venue's own delivery."
},
"price_max": {
"type": "integer",
"minimum": 1,
"maximum": 4,
"description": "Owner-declared price level 1–4 (schema.org priceRange \"$\" … \"$$$$\"): venues at or below it. Venues that declared no level are excluded when set."
},
"menu_language": {
"type": "string",
"enum": [
"tr",
"en",
"de",
"fr",
"es",
"it",
"nl",
"pt",
"ru",
"ar",
"zh",
"ja",
"ko",
"pl",
"sv",
"da",
"fi",
"no",
"cs",
"hu",
"ro",
"bg",
"el",
"hr",
"sk",
"sl",
"lt",
"lv",
"he",
"fa",
"sw"
],
"description": "The menu can be read in this language: it is the menu's source language, or at least 90 % of the guest menu's dish names are translated into it (the restaurant graph's rule)."
},
"table_available": {
"type": "boolean",
"default": false,
"description": "Only venues open now with a table that staff marked ready on the live table board (TABLE_AVAILABLE). Venues not using the board are excluded: unknown is not \"available\"."
},
"waitlist": {
"type": "boolean",
"default": false,
"description": "Only venues whose waitlist is open now (WAITLIST_AVAILABLE): the reservations switch, which also opens the waitlist, and the venue open now — not in holiday mode."
},
"payment_available": {
"type": "boolean",
"default": false,
"description": "Only venues where a guest can pay online through Thmenu (PAYMENT_AVAILABLE): the venue's online-payment switch is on, online payment through Thmenu works in its country, and the payment provider has not reported the account unable to take payments."
},
"q": {
"type": "string",
"description": "Free text over name and description (min 2 chars)."
},
"city": {
"type": "string"
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2"
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"default": 20
},
"page": {
"type": "integer",
"minimum": 1,
"default": 1
}
}
}