API reference
A resource-oriented JSON API over HTTPS. Every response carries a Request-Id; every error is typed. Version 2026-10-14.
Base URL
https://api.listener.comAuthenticate
Authorization: Bearer lsk_…New here? Start with the Quickstart, then read Authentication and Errors. The machine-readable spec lives at /v1/openapi.json.
Meta3
API root, the OpenAPI document and the calling credential's workspace.
Workspace & shows11
The workspace (network, subnetwork or solo show), its shows, plan, team, integrations and public profiles.
Episodes8
Episodes per show, search, transcripts, tags, goals and Substack download figures.
- GET/v1/shows/{show_id}/episodes
- GET/v1/shows/{show_id}/episodes/{episode_id}
- GET/v1/shows/{show_id}/episodes/{episode_id}/transcript
- GET/v1/episodes/search
- POST/v1/shows/{show_id}/episodes/tags
- PUT/v1/shows/{show_id}/episode-goals
- PUT/v1/shows/{show_id}/substack/downloads
- POST/v1/shows/{show_id}/substack/imports
Analytics11
Account-level reach, timelines, rankings, platform stats and recent content. These endpoints cost 2 rate-limit tokens.
Clusters21
Episode clusters (an episode plus its clips and posts), cluster reports and timelines, and the AI cluster builder.
- GET/v1/clusters
- GET/v1/clusters/report
- POST/v1/shows/{show_id}/clusters
- POST/v1/shows/{show_id}/clusters/merge
- GET/v1/shows/{show_id}/clusters/{cluster_id}
- PATCH/v1/shows/{show_id}/clusters/{cluster_id}
- DEL/v1/shows/{show_id}/clusters/{cluster_id}
- GET/v1/shows/{show_id}/clusters/{cluster_id}/timeline
- POST/v1/shows/{show_id}/episodes/{episode_id}/posts
- POST/v1/shows/{show_id}/clusters/{cluster_id}/nodes/remove
- POST/v1/shows/{show_id}/clusters/{cluster_id}/nodes/tags
- POST/v1/shows/{show_id}/clusters/{cluster_id}/refresh
- GET/v1/shows/{show_id}/cluster-sources
- PATCH/v1/shows/{show_id}/cluster-sources
- GET/v1/shows/{show_id}/cluster-candidates
- GET/v1/shows/{show_id}/episodes/{episode_id}/content-candidates
- POST/v1/cluster-builds
- GET/v1/cluster-builds/latest
- GET/v1/cluster-builds/{job_id}
- GET/v1/shows/{show_id}/cluster-suggestions
- POST/v1/shows/{show_id}/cluster-suggestions/{episode_id}/review
Campaigns16
Sponsorship campaigns, slots, cluster links, brand profiles and air checks.
- GET/v1/campaigns
- POST/v1/campaigns
- GET/v1/campaigns/{campaign_id}
- PATCH/v1/campaigns/{campaign_id}
- DEL/v1/campaigns/{campaign_id}
- GET/v1/campaigns/{campaign_id}/timeline
- GET/v1/campaigns/{campaign_id}/cpm-insights
- POST/v1/campaigns/{campaign_id}/status
- POST/v1/campaigns/{campaign_id}/slots
- PATCH/v1/campaigns/{campaign_id}/slots/{slot_id}
- PUT/v1/campaigns/{campaign_id}/slots/{slot_id}/cluster
- DEL/v1/campaigns/{campaign_id}/slots/{slot_id}/cluster
- GET/v1/brands
- GET/v1/brands/{brand_slug}
- PUT/v1/brands/{brand_slug}
- GET/v1/air-checks
Reports8
Shared reports, report templates and report automations.
Sponsors3
Sponsor matching, network bundle opportunities and sponsorship packages.
Library & research5
Workspace library files, web research, podcast search and insertion-order parsing.
Refresh2
Metered actions: platform refreshes and Spotify / Apple data requests.
Partner integrations11
For hosting and ad-tech partners: discover and connect a show's accounts, set its podcast identity, look up episodes by your own ids, control auto-build, and record ad-server delivery on campaigns.
- GET/v1/shows/{show_id}/account-discovery
- POST/v1/shows/{show_id}/account-discovery
- PUT/v1/shows/{show_id}/integrations/{platform}
- DEL/v1/shows/{show_id}/integrations/{platform}
- PUT/v1/shows/{show_id}/podcast
- GET/v1/shows/{show_id}/episodes/lookup
- GET/v1/shows/{show_id}/auto-build
- PUT/v1/shows/{show_id}/auto-build
- GET/v1/campaigns/{campaign_id}/external-delivery
- POST/v1/campaigns/{campaign_id}/external-delivery
- DEL/v1/campaigns/{campaign_id}/external-delivery/{row_id}
Webhooks & events13
Webhook endpoints, deliveries and the Events API.
- GET/v1/webhook-endpoints
- POST/v1/webhook-endpoints
- GET/v1/webhook-endpoints/{endpoint_id}
- PATCH/v1/webhook-endpoints/{endpoint_id}
- DEL/v1/webhook-endpoints/{endpoint_id}
- POST/v1/webhook-endpoints/{endpoint_id}/roll-secret
- GET/v1/webhook-endpoints/{endpoint_id}/secret
- POST/v1/webhook-endpoints/{endpoint_id}/test
- GET/v1/webhook-endpoints/{endpoint_id}/deliveries
- POST/v1/webhook-deliveries/{delivery_id}/retry
- GET/v1/events
- GET/v1/events/{event_id}
- GET/v1/event-types