Megaphone

Megaphone (Megaphone by Spotify) is an enterprise podcast hosting, distribution, and advertising-monetization platform, owned by Spotify since its 2020 acquisition. Its REST API (base https://cms.megaphone.fm/api) lets podcast producers and partners programmatically manage networks, podcasts, and episodes, run dynamic ad insertion, and operate direct-sales advertising - campaigns, orders, advertisements, advertisers, and targeting - plus pull metrics and impressions via export services. API documentation is public, but an API token requires a paid Megaphone account (Professional from $99/month, or Enterprise).

6 APIs 0 Features
PodcastingPodcast HostingAdvertisingAd MonetizationDynamic Ad InsertionMediaSpotify

APIs

Megaphone Networks API

Read a network (the top-level account container) and list the podcasts that belong to it. A network scopes access for a given API token and is the parent of all podcast and epis...

Megaphone Podcasts API

Create, list, retrieve, update, and delete podcasts within a network, including title, subtitle, author, artwork, categories, RSS/distribution settings, and monetization configu...

Megaphone Episodes API

Manage episodes under a podcast - create, list, retrieve, update, and delete episodes, upload or reference audio, set publish dates and draft state, and configure ad-insertion p...

Megaphone Campaigns and Orders API

Direct-sales advertising surface (v1) scoped to an organization - campaigns, campaign orders and promo orders, and the advertisements attached to each order. These legacy Direct...

Megaphone Direct Sales API v2

Enhanced REST API (v2) for managing direct-sales advertising - advertisers, campaigns, orders, assets, advertisements, and targeting. The v2 endpoints became available April 15,...

Megaphone Metrics and Impressions Export API

Bulk export surfaces - the Metrics Export Service and Impressions Export Service - for pulling download, listener, and ad-impression data for measurement and reporting. Endpoint...

Collections

Megaphone API

OPEN

Pricing Plans

Megaphone Plans Pricing

2 plans

PLANS

Rate Limits

Megaphone Rate Limits

3 limits

RATE LIMITS

FinOps

Megaphone Finops

FINOPS

Resources

🔗
VulnerabilityDisclosure
VulnerabilityDisclosure
🔗
DomainSecurity
DomainSecurity
🔑
Authentication
Authentication
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
🔗
APIReference
APIReference
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps
💰
Pricing
Pricing

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: Megaphone API
  version: '2.0'
request:
  auth:
    type: apikey
    apikey:
      key: Authorization
      value: Token token="{{apiToken}}"
      in: header
items:
- info:
    name: Networks
    type: folder
  items:
  - info:
      name: Retrieve a network.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/networks/:network_id
      params:
      - name: network_id
        value: ''
        type: path
        description: The network identifier.
    docs: Retrieves a single network (account container) by ID.
  - info:
      name: List podcasts in a network.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/networks/:network_id/podcasts
      params:
      - name: network_id
        value: ''
        type: path
        description: The network identifier.
    docs: Lists podcasts belonging to a network. Paginated via the Link header.
- info:
    name: Podcasts
    type: folder
  items:
  - info:
      name: Create a podcast.
      type: http
    http:
      method: POST
      url: https://cms.megaphone.fm/api/networks/:network_id/podcasts
      body:
        type: json
        data: '{"title": "", "subtitle": "", "author": ""}'
    docs: Creates a new podcast within a network.
  - info:
      name: Retrieve a podcast.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/networks/:network_id/podcasts/:podcast_id
    docs: Retrieves a single podcast by ID.
  - info:
      name: Update a podcast.
      type: http
    http:
      method: PUT
      url: https://cms.megaphone.fm/api/networks/:network_id/podcasts/:podcast_id
      body:
        type: json
        data: '{}'
    docs: Updates an existing podcast.
  - info:
      name: Delete a podcast.
      type: http
    http:
      method: DELETE
      url: https://cms.megaphone.fm/api/networks/:network_id/podcasts/:podcast_id
    docs: Deletes a podcast.
- info:
    name: Episodes
    type: folder
  items:
  - info:
      name: List episodes in a podcast.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/networks/:network_id/podcasts/:podcast_id/episodes
    docs: Lists episodes for a podcast. Set draft=true to include drafts.
  - info:
      name: Create an episode.
      type: http
    http:
      method: POST
      url: https://cms.megaphone.fm/api/networks/:network_id/podcasts/:podcast_id/episodes
      body:
        type: json
        data: '{"title": "", "pubdate": ""}'
    docs: Creates a new episode under a podcast.
  - info:
      name: Retrieve an episode.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/networks/:network_id/podcasts/:podcast_id/episodes/:episode_id
    docs: Retrieves a single episode by ID.
  - info:
      name: Update an episode.
      type: http
    http:
      method: PUT
      url: https://cms.megaphone.fm/api/networks/:network_id/podcasts/:podcast_id/episodes/:episode_id
      body:
        type: json
        data: '{}'
    docs: Updates an existing episode.
  - info:
      name: Delete an episode.
      type: http
    http:
      method: DELETE
      url: https://cms.megaphone.fm/api/networks/:network_id/podcasts/:podcast_id/episodes/:episode_id
    docs: Deletes an episode.
- info:
    name: Campaigns and Orders (legacy Direct Sales)
    type: folder
  items:
  - info:
      name: List campaigns.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/organizations/:organization_id/campaigns
    docs: Lists direct-sales campaigns for an organization (legacy v1).
  - info:
      name: List orders for a campaign.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/organizations/:organization_id/campaigns/:campaign_id/orders
    docs: Lists the orders attached to a campaign.
  - info:
      name: List advertisements for an order.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/orders/:order_id/advertisements
    docs: Lists the advertisements attached to an order.
- info:
    name: Direct Sales v2 (modeled)
    type: folder
  items:
  - info:
      name: List advertisers.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/v2/advertisers
    docs: Lists advertisers in the v2 Direct Sales API. Path modeled from documented resources.
  - info:
      name: List campaigns.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/v2/campaigns
    docs: Lists campaigns in the v2 Direct Sales API. Path modeled.
  - info:
      name: List orders.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/v2/orders
    docs: Lists orders in the v2 Direct Sales API. Path modeled.
  - info:
      name: List assets.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/v2/assets
    docs: Lists creative assets in the v2 Direct Sales API. Path modeled.
  - info:
      name: List targeting options.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/v2/targeting
    docs: Lists targeting reference data (geos, devices, Nielsen segments). Path modeled.
- info:
    name: Exports (modeled)
    type: folder
  items:
  - info:
      name: Export metrics.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/metrics_export
    docs: Pull-based bulk export of download and listener metrics. Path modeled.
  - info:
      name: Export impressions.
      type: http
    http:
      method: GET
      url: https://cms.megaphone.fm/api/impressions_export
    docs: Pull-based bulk export of ad-impression data. Path modeled.