Donde Onde Where API and MCP Documentation

Query the monthly Hot Lists of independent restaurants, pubs and bars in the UK, Portugal and Spain from your own code or from an AI assistant.

Two ways in

  • REST API. One read-only endpoint that returns ranked venues. It needs an API key sent in the x-api-key header.
  • MCP server. An open Model Context Protocol server for AI assistants. It needs no credentials.

Machine-readable descriptions: the OpenAPI description and llms.txt.

REST API

Base URL: https://www.donde-onde-where.com

Authentication

Send your key in the x-api-key request header. A request without a valid key receives 401. The API is not keyless. To request a key, email [email protected], the contact published in our plugin manifest. Tell us who you are and what you are building. The key is stable per integration.

Endpoint

GET /api/hot-venues returns independent restaurants, pubs and bars ranked by recent written review activity, not star ratings. Each venue carries an editorial profile (verdict, who it suits, who should skip it, best-for tags) and reviewer quotes.

Query parameters (all optional)
NameTypeMeaning
citystringCity name, lowercase, for example porto, manchester, seville, bilbao or edinburgh.
zonestringZone slug for neighbourhood-level results, for example ribeira, northern-quarter, triana or ensanche.
categorystringOne of all, restaurant or bar.
limitintegerMaximum number of venues to return, from 1 to 50.

Sample request

curl -H "x-api-key: YOUR_KEY" \
  "https://www.donde-onde-where.com/api/hot-venues?city=porto&zone=ribeira&category=restaurant&limit=10"

Responses

  • 200 ranked venues as JSON.
  • 401 the key is missing or not valid.
  • 429 too many requests. Slow down and retry later.
  • 500 server error.

Coverage: 34 cities across the UK, Portugal and Spain. London, Madrid and Barcelona are not covered. The full parameter and response schema is in the OpenAPI description.

MCP server

Donde Onde Where runs an open MCP server so an AI assistant can look up Hot Lists, zones and venues directly. It is read-only and needs no API key and no sign-in.

https://booteek.ai/api/mcp/dow/mcp

Add that URL as a remote MCP server in any client that supports the protocol. The REST API key does not apply here.

Questions

See how the Hot Score works, or use our contact page.