--- name: aggregators-api-service description: "Aggregators API Service API skill. Use when working with Aggregators API Service for podcast-bot, api, stats. Covers 51 endpoints." version: 1.0.0 generator: lapsh --- # Aggregators API Service API version: 0.77-dadb296 ## Auth ApiKey x-zeno-api-key in header | Bearer basic ## Base URL https://api.zeno.fm ## Setup 1. Set Authorization header with Bearer token 2. GET /podcast-bot/podcasts/list -- list podcasts 3. POST /stats/mounts/{mount}/auth-cache/reload -- create first reload ## Endpoints 51 endpoints across 4 groups. See references/api-spec.lap for full details. ### Podcast-bot | Method | Path | Description | |--------|------|-------------| | GET | /podcast-bot/podcasts/{podcastKey} | Get podcast | | PUT | /podcast-bot/podcasts/{podcastKey} | Update podcast info | | DELETE | /podcast-bot/podcasts/{podcastKey} | Delete podcast | | PUT | /podcast-bot/podcasts/{podcastKey}/recordingConfig | Update podcast recording configuration | | PUT | /podcast-bot/podcasts/{podcastKey}/processingPresets | Update podcast processing presets | | PUT | /podcast-bot/podcasts/{podcastKey}/interviewPresets | Update podcast interview extraction presets | | PUT | /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey}/unpublish | Unpublish podcast episode | | PUT | /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey}/publish | Publish podcast episode | | PUT | /podcast-bot/podcasts/{podcastKey}/aiAdsPresets | Update podcast AI Ads presets | | POST | /podcast-bot/workflows/process-file | Process file | | POST | /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey}/reprocess | Reprocess episode | | POST | /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey}/reprocess/custom | Reprocess episode with custom presets | | POST | /podcast-bot/podcasts/recording/create | Create recording podcast | | GET | /podcast-bot/workflows/{workflowId}/details | Get workflow details | | GET | /podcast-bot/podcasts/{podcastKey}/episodes | Get podcast episodes | | GET | /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey} | Get podcast episode | | DELETE | /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey} | Delete podcast episode | | GET | /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey}/metadata | Get metadata for a podcast episode | | GET | /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey}/adsMarkers | Get Ads markers info for a podcast episode | | GET | /podcast-bot/podcasts/{podcastKey}/episodes/interviews | Get podcast interviews | | GET | /podcast-bot/podcasts/list | List podcasts | | GET | /podcast-bot/jobs/podcasts/{podcastKey} | Get all processing jobs for a podcast | | GET | /podcast-bot/jobs/podcasts/{podcastKey}/episodes/{episodeKey} | Get processing jobs for a podcast episode | ### Api | Method | Path | Description | |--------|------|-------------| | GET | /api/v2/podcasts/{podcastKey} | Get podcast | | PUT | /api/v2/podcasts/{podcastKey} | Update podcast | | DELETE | /api/v2/podcasts/{podcastKey} | Delete podcast | | GET | /api/v2/podcasts/{podcastKey}/episodes/{episodeKey} | Get podcast episode | | PUT | /api/v2/podcasts/{podcastKey}/episodes/{episodeKey} | Update podcast episode | | DELETE | /api/v2/podcasts/{podcastKey}/episodes/{episodeKey} | Delete podcast episode | | POST | /api/v2/stations/search | Search stations | | POST | /api/v2/stations/listener/location | Get top stations by listener location | | POST | /api/v2/podcasts/{podcastKey}/episodes/create | Create podcast episode | | POST | /api/v2/podcasts/search | Search podcasts | | POST | /api/v2/podcasts/create | Create podcast | | GET | /api/v2/stations/{stationKey} | Get station | | GET | /api/v2/stations/list | List stations | | GET | /api/v2/stations/languages | Get the list of Languages that can be used to filter stations in the search stations request | | GET | /api/v2/stations/genres | Get the list of Genres that can be used to filter stations in the search stations request | | GET | /api/v2/stations/countries | Get the list of Countries that can be used to filter stations in the search stations request | | GET | /api/v2/stations/browse | Browse all stations | | GET | /api/v2/podcasts/{podcastKey}/episodes | Get podcast episodes | | GET | /api/v2/podcasts/languages | Get the list of Languages that can be used to filter podcasts in the search podcasts request | | GET | /api/v2/podcasts/countries | Get the list of Countries that can be used to filter podcasts in the search podcasts request | | GET | /api/v2/podcasts/categories | Get the list of Categories that can be used to filter podcasts in the search podcasts request | ### Stats | Method | Path | Description | |--------|------|-------------| | POST | /stats/mounts/{mount}/auth-cache/reload | Retrieve total numer of live stats for a specific mount | | POST | /stats/mounts/{mount}/auth-cache/reload/all | Retrieve total numer of live stats for a specific mount | | GET | /stats/mounts/{mount}/live/total | Retrieve total numer of live stats for a specific mount | ### Partners | Method | Path | Description | |--------|------|-------------| | POST | /partners/streams | Get the partner information for a list of streams. | | GET | /partners/{partnerId}/ads/stats | Retrieve partner stats | | GET | /partners/streams/{streamId} | Get the stream partner information. | | GET | /partners/streams/{streamId}/tracks | Get the stream partner information. | ## Common Questions Match user requests to endpoints in references/api-spec.lap. Key patterns: - "Get podcast details?" -> GET /podcast-bot/podcasts/{podcastKey} - "Update a podcast?" -> PUT /podcast-bot/podcasts/{podcastKey} - "Delete a podcast?" -> DELETE /podcast-bot/podcasts/{podcastKey} - "Get episode details?" -> GET /api/v2/podcasts/{podcastKey}/episodes/{episodeKey} - "Update a episode?" -> PUT /api/v2/podcasts/{podcastKey}/episodes/{episodeKey} - "Delete a episode?" -> DELETE /api/v2/podcasts/{podcastKey}/episodes/{episodeKey} - "Create a reload?" -> POST /stats/mounts/{mount}/auth-cache/reload - "Create a all?" -> POST /stats/mounts/{mount}/auth-cache/reload/all - "Create a process-file?" -> POST /podcast-bot/workflows/process-file - "Create a reprocess?" -> POST /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey}/reprocess - "Create a custom?" -> POST /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey}/reprocess/custom - "Create a create?" -> POST /podcast-bot/podcasts/recording/create - "Create a stream?" -> POST /partners/streams - "Create a search?" -> POST /api/v2/stations/search - "Create a location?" -> POST /api/v2/stations/listener/location - "List all total?" -> GET /stats/mounts/{mount}/live/total - "List all details?" -> GET /podcast-bot/workflows/{workflowId}/details - "List all episodes?" -> GET /podcast-bot/podcasts/{podcastKey}/episodes - "List all metadata?" -> GET /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey}/metadata - "List all adsMarkers?" -> GET /podcast-bot/podcasts/{podcastKey}/episodes/{episodeKey}/adsMarkers - "List all interviews?" -> GET /podcast-bot/podcasts/{podcastKey}/episodes/interviews - "List all list?" -> GET /podcast-bot/podcasts/list - "List all stats?" -> GET /partners/{partnerId}/ads/stats - "Get stream details?" -> GET /partners/streams/{streamId} - "List all tracks?" -> GET /partners/streams/{streamId}/tracks - "Get station details?" -> GET /api/v2/stations/{stationKey} - "List all languages?" -> GET /api/v2/stations/languages - "List all genres?" -> GET /api/v2/stations/genres - "List all countries?" -> GET /api/v2/stations/countries - "List all browse?" -> GET /api/v2/stations/browse - "List all categories?" -> GET /api/v2/podcasts/categories - "How to authenticate?" -> See Auth section above ## Response Tips - Check response schemas in references/api-spec.lap for field details - Paginated endpoints accept limit/offset or cursor parameters - Create/update endpoints return the modified resource on success ## References - Full spec: See references/api-spec.lap for complete endpoint details, parameter tables, and response schemas > Generated from the official API spec by [LAP](https://lap.sh)