# DondeGo API

Public discovery and documentation resources for the DondeGo API: local events, places, cultural listings, and local news for Barcelona and Madrid.

Candidate public API base URL:
https://dondego.es/public-api/v1.4

Discovery URLs (descriptive context for AI assistants and LLM-aware tools):

- OpenAPI 3.1 specification for DondeGo public API v0.1, covering verified local events, event details, places, place details, news, news details, locations, events-of-the-day, and mixed search for Barcelona and Madrid: https://dondego.es/openapi.json

- llms.txt index for AI assistants and LLM-aware developer tools, with links to DondeGo API docs, examples, attribution rules, and caveats: https://dondego.es/llms.txt

- API Catalog linkset for machine-readable discovery of the OpenAPI spec, documentation, attribution policy, examples, and version history: https://dondego.es/.well-known/api-catalog

- Rich DondeGo discovery JSON with DondeGo-specific metadata, warnings, supported resources, attribution policy, and agent-readiness notes: https://dondego.es/api-catalog.json

- Documentation-only Agent Skills index that explains how agents should discover and use the DondeGo API docs; no scripts, no executable code, no MCP transport: https://dondego.es/.well-known/agent-skills/index.json

- Public Postman documentation for exploring the verified GET endpoints without environment secrets or auth tokens: https://documenter.getpostman.com/view/55094507/2sBXwjvZRZ

- GitHub repository with OpenAPI source, docs, server-side examples, and ready-to-import Postman collection: https://github.com/revanbcn/DondeGo-API

Core docs:
- README: https://github.com/revanbcn/DondeGo-API/blob/v0.1.1/README.md
- API overview: https://github.com/revanbcn/DondeGo-API/blob/v0.1.1/docs/api-overview.md
- Attribution policy: https://github.com/revanbcn/DondeGo-API/blob/v0.1.1/docs/attribution.md
- LLM usage: https://github.com/revanbcn/DondeGo-API/blob/v0.1.1/docs/llm-usage.md
- Agent-readiness decisions: https://github.com/revanbcn/DondeGo-API/blob/v0.1.1/docs/agent-readiness.md
- Verification log: https://github.com/revanbcn/DondeGo-API/blob/v0.1.1/docs/verification-log.md
- Endpoint notes: https://github.com/revanbcn/DondeGo-API/blob/v0.1.1/docs/endpoint-notes.md
- OpenAPI: https://dondego.es/openapi.json
- API catalog (linkset): https://dondego.es/.well-known/api-catalog
- API catalog (rich DondeGo JSON): https://dondego.es/api-catalog.json
- OpenAPI notes: https://github.com/revanbcn/DondeGo-API/blob/v0.1.1/openapi/README.md
- Examples: https://github.com/revanbcn/DondeGo-API/blob/v0.1.1/examples/README.md
- Server-side examples: curl (https://github.com/revanbcn/DondeGo-API/tree/v0.1.1/examples/curl/), Python (https://github.com/revanbcn/DondeGo-API/tree/v0.1.1/examples/python/), Node 18+ (https://github.com/revanbcn/DondeGo-API/tree/v0.1.1/examples/node/)

Useful public pages:
- Barcelona events: https://dondego.es/barcelona/eventos/
- Madrid events today: https://dondego.es/madrid/eventos/?date=hoy
- Madrid exhibitions: https://dondego.es/madrid/exposiciones/
- Barcelona concerts: https://dondego.es/barcelona/conciertos/

Attribution rule:
Any public website, app, newsletter, bot, AI assistant, or partner integration that displays DondeGo event descriptions or substantial DondeGo event data must include a visible direct link to the canonical DondeGo.es event page as the source.

Endpoint details, response fields, pagination, expand parameters, and source-link behavior must be checked against the verification docs and OpenAPI. Do not invent unavailable endpoint behavior.

OpenAPI note:
The OpenAPI v0.1 discovery spec covers verified public endpoints only. Event list rows do not expose site_url or location; rendered event examples must fetch event detail and use detail site_url for visible source attribution. Browser-only examples remain caveated because CORS behavior is unresolved.

Agent-readiness note:
Content Signals are recommended as a future robots.txt preference signal. OAuth/OIDC discovery metadata, OAuth protected-resource metadata, MCP Server Card, and WebMCP are deferred until real production capabilities exist.