API Reference
Playlists
- GET
/playlistsPlaylist listSearch and list public playlists. - GET
/playlists/:playlistIdPlaylist detailRetrieve a playlist's detail (items via a separate endpoint). - GET
/playlists/:playlistId/itemsPlaylist itemsRetrieve playlist items. `page` uses numbered pagination, `cursor` uses cursor pagination. groupByDate=true returns date-grouped results. - GET
/playlists/:playlistId/geojsonPlaylist map pinsReturns the 4S events in the playlist that have coordinates as a GeoJSON FeatureCollection. Not paginated; narrow the result with bbox. Filters have the same meaning as GET /playlists/:playlistId/items. - POST
/playlists/:playlistId/preview-externalPreview an external URL for submissionFetch title, description, image and schedules from an external URL's OG / JSON-LD for the submission form. Only available on playlists that accept submissions. - POST
/playlists/:playlistId/item-requestsSubmit an eventSubmit an event to a playlist. The item is created with status=PENDING and stays hidden until a community admin approves it. Approval and rejection are done through the /manage/playlists endpoints.