Making a Local Events API Discoverable to Developers and AI Assistants

Local cultural data should not only live as web pages.

That is the idea behind the public discovery layer we just shipped for the DondeGo API.

DondeGo is a local discovery platform for Barcelona and Madrid, focused on events, places, cultural life, and local news. We are building it as a media and discovery product, but we also want the data surface to be understandable by developers, API clients, documentation tools, and AI assistants.

So instead of only publishing a human-readable API page, we built a small discovery package around the API.

It includes OpenAPI, llms.txt, an API Catalog linkset, Postman documentation, examples, and a documentation-only Agent Skills index.

The goal is simple:

make the API easier to discover, understand, cite, and use without pretending to support capabilities that do not exist yet.

What is live

Here are the main public entry points.

OpenAPI 3.1:



API Catalog linkset:



Documentation-only Agent Skills index:



GitHub repository:



And a ready-to-import Postman Collection:

List supported locations:

curl -s https://dondego.es/public-api/v1.4/locations/ | jq

List a few Barcelona event summaries:

curl -s "https://dondego.es/public-api/v1.4/events/?location=barcelona&page_size=3" | jq

Fetch event details:

curl -s "https://dondego.es/public-api/v1.4/events/{id}/?expand=place,images,dates,categories,tags,participants" | jq

More complete examples are available here:

This file is a short LLM-oriented index.

It points to the most important resources:

• what DondeGo is


• what the public API covers


• where the OpenAPI spec lives


• where the API Catalog lives


• where examples live


• what attribution rule must be followed


• what is not supported yet

It does not magically make every model use the API.

But it gives AI systems and developer tools a clear, stable, crawlable reference.

API Catalog linkset

We also publish:

This split is intentional.

The .well-known/api-catalog route is a compact machine-readable linkset. The /api-catalog.json route carries richer DondeGo-specific context.

Documentation-only Agent Skills

We also publish a documentation-only Agent Skills index:

The repository also includes a ready-to-import Postman Collection v2.1:

Live OpenAPI:

llms.txt:

If you are building a local guide, AI assistant, cultural newsletter, events app, map product, or city discovery experience for Barcelona or Madrid, I would be happy to talk.

Partner access and integration discussions:

[email protected]