Spreaker

Spreaker is a podcast hosting, distribution, and monetization platform owned by iHeartMedia (acquired via parent company Voxnest in 2020). It lets creators record, host, and publish podcasts, auto-distribute to Apple Podcasts, Spotify, and iHeartRadio, and monetize through programmatic ads, listener subscriptions, and a Supporters Club. Spreaker exposes a documented public REST API (v2) over HTTPS at api.spreaker.com, authenticated with OAuth2, covering users, shows, episodes, playback and messaging, analytics/statistics, search and discovery, and advertising campaign management.

6 APIs 0 Features
PodcastingPodcast HostingAudioMediaMonetizationAnalytics

APIs

Spreaker Users API

Retrieve and update Spreaker user profiles, resolve the authenticated user via /me, and manage the social graph - followers, followings, and blocked users.

Spreaker Shows API

Create, retrieve, update, and delete podcast shows, list a user's shows, manage favorite shows, and read supporting reference data such as show categories and languages.

Spreaker Episodes API

Upload, update, and delete episodes, create drafts, stream and download audio, and manage engagement and enrichment - likes, bookmarks, listener messages, chapters, and ad cuepo...

Spreaker Statistics API

Read playback, likes, followers, source, device, OS, and geographic analytics at the user, show, and episode level, plus rolled-up totals across a user's shows and episodes.

Spreaker Search and Discovery API

Search shows and episodes globally or scoped to an author or show, browse explore categories, list latest episodes by tag, and embed players via the oEmbed provider.

Spreaker Advertising Campaigns API

Manage the direct ad-sales stack available on the Publisher plan - advertisers, campaigns, and targeted line items - including country targeting for campaign delivery.

Collections

Spreaker API

OPEN

Pricing Plans

Spreaker Plans Pricing

4 plans

PLANS

Rate Limits

Spreaker Rate Limits

3 limits

RATE LIMITS

FinOps

Spreaker Finops

FINOPS

Resources

🔗
VulnerabilityDisclosure
VulnerabilityDisclosure
🔗
DomainSecurity
DomainSecurity
🔑
Authentication
Authentication
🔑
OAuthScopes
OAuthScopes
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: Spreaker API
  version: '2.0'
request:
  auth:
    type: bearer
    token: '{{accessToken}}'
items:
- info:
    name: Users
    type: folder
  items:
  - info:
      name: Retrieve the authenticated user.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/me
    docs: Returns the user associated with the OAuth2 access token.
  - info:
      name: Retrieve a user.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/users/:user_id
      params:
      - name: user_id
        value: ''
        type: path
        description: The user ID.
    docs: Returns a single user's public profile.
  - info:
      name: Update a user.
      type: http
    http:
      method: POST
      url: https://api.spreaker.com/v2/users/:user_id
      params:
      - name: user_id
        value: ''
        type: path
        description: The user ID.
    docs: Updates the profile of the authenticated user.
  - info:
      name: Retrieve a user's followers.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/users/:user_id/followers
      params:
      - name: user_id
        value: ''
        type: path
        description: The user ID.
    docs: Returns a paginated list of the user's followers.
  - info:
      name: Follow a user.
      type: http
    http:
      method: PUT
      url: https://api.spreaker.com/v2/users/:user_id/followings/:following_id
      params:
      - name: user_id
        value: ''
        type: path
        description: The following user's ID.
      - name: following_id
        value: ''
        type: path
        description: The ID of the user to follow.
    docs: Follows another user.
  - info:
      name: Unfollow a user.
      type: http
    http:
      method: DELETE
      url: https://api.spreaker.com/v2/users/:user_id/followings/:following_id
      params:
      - name: user_id
        value: ''
        type: path
        description: The following user's ID.
      - name: following_id
        value: ''
        type: path
        description: The ID of the user to unfollow.
    docs: Unfollows a user.
- info:
    name: Shows
    type: folder
  items:
  - info:
      name: Create a show.
      type: http
    http:
      method: POST
      url: https://api.spreaker.com/v2/shows
      body:
        type: form
        data: title=
    docs: Creates a new podcast show for the authenticated user.
  - info:
      name: Retrieve a show.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/shows/:show_id
      params:
      - name: show_id
        value: ''
        type: path
        description: The show ID.
    docs: Returns a single show.
  - info:
      name: Update a show.
      type: http
    http:
      method: POST
      url: https://api.spreaker.com/v2/shows/:show_id
      params:
      - name: show_id
        value: ''
        type: path
        description: The show ID.
    docs: Updates an existing show.
  - info:
      name: Delete a show.
      type: http
    http:
      method: DELETE
      url: https://api.spreaker.com/v2/shows/:show_id
      params:
      - name: show_id
        value: ''
        type: path
        description: The show ID.
    docs: Deletes a show.
  - info:
      name: Retrieve a user's shows.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/users/:user_id/shows
      params:
      - name: user_id
        value: ''
        type: path
        description: The user ID.
    docs: Returns a paginated list of the user's shows.
  - info:
      name: List show categories.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/show-categories
    docs: Returns the list of show categories.
  - info:
      name: List show languages.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/show-languages
    docs: Returns the list of supported languages.
- info:
    name: Episodes
    type: folder
  items:
  - info:
      name: Upload an episode.
      type: http
    http:
      method: POST
      url: https://api.spreaker.com/v2/shows/:show_id/episodes
      params:
      - name: show_id
        value: ''
        type: path
        description: The show ID.
      body:
        type: multipart
        data: ''
    docs: Uploads a new episode (multipart/form-data with the audio file) to a show.
  - info:
      name: Retrieve a show's episodes.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/shows/:show_id/episodes
      params:
      - name: show_id
        value: ''
        type: path
        description: The show ID.
    docs: Returns a paginated list of a show's episodes.
  - info:
      name: Retrieve an episode.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/episodes/:episode_id
      params:
      - name: episode_id
        value: ''
        type: path
        description: The episode ID.
    docs: Returns a single episode.
  - info:
      name: Update an episode.
      type: http
    http:
      method: POST
      url: https://api.spreaker.com/v2/episodes/:episode_id
      params:
      - name: episode_id
        value: ''
        type: path
        description: The episode ID.
    docs: Updates an existing episode.
  - info:
      name: Delete an episode.
      type: http
    http:
      method: DELETE
      url: https://api.spreaker.com/v2/episodes/:episode_id
      params:
      - name: episode_id
        value: ''
        type: path
        description: The episode ID.
    docs: Deletes an episode.
  - info:
      name: Stream an episode.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/episodes/:episode_id/play
      params:
      - name: episode_id
        value: ''
        type: path
        description: The episode ID.
    docs: Returns the audio stream for an episode over HTTPS.
  - info:
      name: Download an episode.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/episodes/:episode_id/download
      params:
      - name: episode_id
        value: ''
        type: path
        description: The episode ID.
    docs: Downloads the episode audio file.
  - info:
      name: Retrieve episode messages.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/episodes/:episode_id/messages
      params:
      - name: episode_id
        value: ''
        type: path
        description: The episode ID.
    docs: Returns a paginated list of listener messages on an episode.
  - info:
      name: Retrieve episode chapters.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/episodes/:episode_id/chapters
      params:
      - name: episode_id
        value: ''
        type: path
        description: The episode ID.
    docs: Returns the chapters for an episode.
  - info:
      name: Retrieve episode cuepoints.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/episodes/:episode_id/cuepoints
      params:
      - name: episode_id
        value: ''
        type: path
        description: The episode ID.
    docs: Returns the ad cuepoints for an episode.
- info:
    name: Statistics
    type: folder
  items:
  - info:
      name: Retrieve overall user statistics.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/users/:user_id/statistics
      params:
      - name: user_id
        value: ''
        type: path
        description: The user ID.
    docs: Returns aggregated statistics for a user.
  - info:
      name: Retrieve user play statistics.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/users/:user_id/statistics/plays
      params:
      - name: user_id
        value: ''
        type: path
        description: The user ID.
    docs: Returns play statistics for a user.
  - info:
      name: Retrieve show play statistics.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/shows/:show_id/statistics/plays
      params:
      - name: show_id
        value: ''
        type: path
        description: The show ID.
    docs: Returns play statistics for a show.
  - info:
      name: Retrieve episode play statistics.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/episodes/:episode_id/statistics/plays
      params:
      - name: episode_id
        value: ''
        type: path
        description: The episode ID.
    docs: Returns play statistics for an episode.
- info:
    name: Search and Discovery
    type: folder
  items:
  - info:
      name: Search shows or episodes.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/search?type=shows
      params:
      - name: q
        value: ''
        type: query
        description: The search query.
      - name: type
        value: shows
        type: query
        description: Whether to search shows or episodes.
    docs: Searches shows or episodes.
  - info:
      name: Retrieve explore category items.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/explore/categories/:category_id/items
      params:
      - name: category_id
        value: ''
        type: path
        description: The explore category ID.
    docs: Returns the items in an explore category.
  - info:
      name: Retrieve latest episodes by tag.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/tags/:tag_name/episodes
      params:
      - name: tag_name
        value: ''
        type: path
        description: The tag name.
    docs: Returns the latest episodes tagged with a given tag.
- info:
    name: Advertising
    type: folder
  items:
  - info:
      name: Retrieve advertisers.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/advertisers
    docs: Returns the list of advertisers.
  - info:
      name: Create an advertiser.
      type: http
    http:
      method: POST
      url: https://api.spreaker.com/v2/advertisers
      body:
        type: form
        data: ''
    docs: Creates a new advertiser.
  - info:
      name: Retrieve campaigns.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/campaigns
    docs: Returns the list of campaigns.
  - info:
      name: Create a campaign.
      type: http
    http:
      method: POST
      url: https://api.spreaker.com/v2/campaigns
      body:
        type: form
        data: ''
    docs: Creates a new campaign.
  - info:
      name: Retrieve line items.
      type: http
    http:
      method: GET
      url: https://api.spreaker.com/v2/lineitems
    docs: Returns the list of line items.
  - info:
      name: Create a line item.
      type: http
    http:
      method: POST
      url: https://api.spreaker.com/v2/lineitems
      body:
        type: form
        data: ''
    docs: Creates a new line item.
bundled: true