Ready-to-import Postman collection for the DondeGo public API discovery contract (OpenAPI 3.1, info.version 0.1.0).
\nThis collection mirrors the verified public endpoint families covered by the DondeGo API discovery pack. All requests are unauthenticated GETs against the verified public base URL https://dondego.es/public-api/v1.4. No tokens, cookies, or environments are required.
Live discovery surfaces:
\nMandatory attribution rule:\nAny 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.
\nDetail-first event rendering rule:\nEvent list rows do not expose site_url or location. Public rendered event examples should fetch GET /events/{id}/ and use EventDetail.site_url as the visible DondeGo source link. events-of-the-day/ returns wrapper rows, not full event objects, so the same detail-first pattern applies before rendering substantial event data.
Caveats (v0.1):
\nlimit query parameter is not recommended; use page_size if pagination is needed.search/ returns mixed-result rows. search result item_url is not equivalent to EventDetail.site_url for attribution and must not be treated as the canonical event link.bcn@dondego.es to discuss integration use cases and attribution.Variables:
\nbaseUrl (https://dondego.es/public-api/v1.4) — verified public base.eventId, placeId, newsId — example placeholder IDs only. Replace with IDs returned by the corresponding list endpoint before running detail requests; the example values are not guaranteed to remain valid over time.This collection is documentation-only. It does not configure Postman environments, monitors, mock servers, or secrets.
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"55094507","collectionId":"515dcee3-317c-4f51-925c-57cc0df6cd3b","publishedId":"2sBXwjvZRZ","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-05-21T21:46:47.000Z"},"item":[{"name":"Locations","item":[{"name":"List locations","id":"e70a0eca-14be-4eb8-b71a-22e688377377","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://dondego.es/public-api/v1.4/locations/","description":"Returns the catalogue of supported locations. Use the returned slugs as the location value for the events, places, news, events-of-the-day, and search endpoints.
City and location reference data. Use the returned slugs (for example barcelona, madrid) as the location query value for other endpoints in this collection.
List events for a given location. Event list rows do not expose site_url or location — fetch event detail before rendering substantial event data so the canonical DondeGo.es link can be cited.
Location slug from /locations/ (for example barcelona, madrid).
Page size for pagination. limit is not recommended.
Use EventDetail.site_url for visible source attribution when rendering substantial event data. Replace 206967 with an id returned by the list endpoint; the example value is a placeholder and is not guaranteed to remain valid.
Verified expand keys for event detail.
\n","type":"text/plain"},"key":"expand","value":"place,images,dates,categories,tags,participants"}],"variable":[]}},"response":[],"_postman_id":"3db0605b-7a8e-4df1-8e64-47700f9de2e3"}],"id":"1b5de104-6c99-46a4-806a-45bd6f2f3031","description":"List and detail endpoints for events. Detail requests expose EventDetail.site_url, which is the verified canonical link required by the DondeGo attribution rule.
List places for a given location. Fetch the corresponding detail endpoint when rendering substantial place data.
\n","urlObject":{"path":["places",""],"host":["https://dondego.es/public-api/v1.4"],"query":[{"description":{"content":"Location slug from /locations/.
Replace 1 with an id returned by the list endpoint; the example value is a placeholder and is not guaranteed to remain valid.
Verified expand keys for place detail.
\n","type":"text/plain"},"key":"expand","value":"images,categories"}],"variable":[]}},"response":[],"_postman_id":"eed15bf9-8afb-4c1f-b4de-490bd9c213c0"}],"id":"09c5f5a4-76d7-4526-9101-b961c0f77310","description":"List and detail endpoints for places (venues and points of interest). Detail-first rendering is recommended when displaying substantial place data.
\n","_postman_id":"09c5f5a4-76d7-4526-9101-b961c0f77310"},{"name":"News","item":[{"name":"List news","id":"81a62f06-7cf8-43f3-a53e-9fd3db4d0da5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://dondego.es/public-api/v1.4/news/?location=barcelona","description":"List news for a given location.
\n","urlObject":{"path":["news",""],"host":["https://dondego.es/public-api/v1.4"],"query":[{"description":{"content":"Location slug from /locations/.
Replace 1 with an id returned by the list endpoint; the example value is a placeholder and is not guaranteed to remain valid.
Verified expand keys for news detail.
\n","type":"text/plain"},"key":"expand","value":"images,categories"}],"variable":[]}},"response":[],"_postman_id":"3d18a8e3-7022-4c7e-8449-39c8f25d20c9"}],"id":"e866a1fb-683d-4773-ad26-7442b0df366c","description":"List and detail endpoints for local news / editorial content.
\n","_postman_id":"e866a1fb-683d-4773-ad26-7442b0df366c"},{"name":"Events of the day","item":[{"name":"List events of the day","id":"9d228536-d3d9-4fbf-bde1-d2d8157f5fcc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://dondego.es/public-api/v1.4/events-of-the-day/?location=barcelona","description":"Returns wrapper rows; resolve object.id via GET /events/{id}/ before rendering substantial event data. Use the resolved EventDetail.site_url as the visible DondeGo source link.
Location slug from /locations/.
Wrapper rows for events scheduled for the current day. The endpoint does not return full event objects, so detail-first rendering is mandatory before displaying substantial event data.
\n","_postman_id":"4fb053ce-a917-41c1-a9a9-bd5fbb17d5d3"},{"name":"Search","item":[{"name":"Search","id":"f6b046a7-0d12-4930-b5b5-073ed6bbe179","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://dondego.es/public-api/v1.4/search/?q=concierto&location=barcelona&page_size=5","description":"Mixed-result discovery endpoint; do not treat item_url as event attribution unless resolving event detail first via GET /events/{id}/ and using EventDetail.site_url.
Free-text query.
\n","type":"text/plain"},"key":"q","value":"concierto"},{"description":{"content":"Location slug from /locations/.
Page size for pagination. limit is not recommended.
Experimental mixed-result discovery endpoint. Results include ctype and item_url. item_url is not equivalent to EventDetail.site_url for attribution; resolve event detail before treating any row as a canonical event link.