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).
Megaphone publishes 21 API contracts indexed on the APIs.io network, including Campaigns API, Direct Sales v2 API, Episodes API, and 18 more. Tagged areas include Podcasts, Podcast Hosting, Advertising, Ad Monetization, and Dynamic Ad Insertion.
The Megaphone catalog on APIs.io includes 1 Spectral governance ruleset.
Megaphone’s developer surface includes authentication, documentation, API reference, pricing, and 8 more developer resources.
Regulatory Posture applies to this provider. Its tags matched the
Horizontal (data, software, accessibility, platform) regime, so
Regulatory Posture carries 15 points of the composite.
If this regime is wrong for your business, say so on your
provider repo — the
applicability map is public and we will correct it.
Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it
carries 10 points of the composite. It is scored from the published contracts
themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already
holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in
front of it, and the first time that check is skipped a duplicate record is created.
Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet,
not penalised by it.
The six quality facets above are damped to 75 points between them,
because the conditional facet above carries the other
25. That is why each facet's contribution is shown against a damped
maximum: raising a quality facet moves the composite by 75% of its nominal
weight, not 100%. The full arithmetic is at apis.io/rating/.
Show this score on your site.
It updates itself when the score changes. Paste this where you link to your API docs:
<a href="https://apis.io/providers/megaphone/"><img src="https://apis.io/badge/megaphone/card.svg" alt="Megaphone on APIs.io — Kin Score by API Evangelist"></a>
Other styles, a README pill and a shields.io endpoint are on the badge page.
Raise your score.
Agent readiness — checks not met, largest first (exact, from this profile):
MCP Server+12 pts — deployment.mode + probe verdict on the mcp/ manifest, not the pointer; an unprobed slug falls back to authorship Ask about this →
Idempotency+9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented) Ask about this →
Stable Error Semantics+8 pts — OpenAPI $refs a shared error schema across 4xx/5xx responses (verified), else common[].type includes ErrorCatalog / ErrorCodes / DeclineCodes Ask about this →
Delegated User Identity+6 pts — a served discovery document listing authorization_code in grant_types_supported (served), else an oauth2 authorizationCode flow or openIdConnect declared in an OpenAPI (documented) Ask about this →
9 more unmet checks in the Agent Readiness table above.
Kin Score — facets with the most composite points still available (weight × headroom):
Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.
Not sure how this applies to your stack? Ask about any one item. Kin Lane reads every question, looks at your profile and your situation, and replies with what a fix would take — scoped to that one area, priced up front, yours whether you ship it or not. Ask a question →
The Kin Score Market layer reads a provider inside its market:
its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted:
not part of the Kin Score or agent readiness.
Registered MCP server and declares compatibility are report only — not weighted.
Undeclared means we found nothing we can read, so there is no number: we never infer integrations.
Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.
**⚠️ BREAKING CHANGE NOTICE ⚠️** These legacy endpoints will continue to work until **July 14, 2026 11:59:59 UTC**. v2 endpoints become available on **April 15, 2026**. Please m...
**⚠️ BREAKING CHANGE NOTICE ⚠️** These legacy endpoints will continue to work until **July 14, 2026 11:59:59 UTC**. v2 endpoints become available on **April 15, 2026**. Please m...
**⚠️ IMPORTANT: Sponsorship Cuepoints ⚠️** These endpoints manage **all cuepoints** on an episode, including: - **Ad Cuepoints**: Standard ad break markers (preroll, midroll, po...
**⚠️ AVAILABILITY ⚠️** The Direct Sales API v2 provides enhanced endpoints for managing advertisers, campaigns, orders, assets, and advertisements for Standard and Priority camp...
# Search Megaphone provides a top-level search endpoint for various objects in our database. By default, these endpoints will return every instance of the object accessible to t...
**⚠️ AVAILABILITY NOTICE ⚠️** These Sponsorship API endpoints will be available starting in late April. The Sponsorship API provides endpoints for managing sponsorships and spon...
# Targeting Megaphone provides a top-level endpoint for order targeting objects, including Device Targets, IAB Advertiser Categories, MTM Categories, Nielsen Segments, and Geota...
Not yet checked against Megaphone's own pricing page. Compiled by API Evangelist on 2026-07-05 from megaphone.spotify.com/pricing; confirm before you rely on a figure.
aid: megaphone
url: https://raw.githubusercontent.com/api-evangelist/megaphone/refs/heads/main/apis.yml
name: Megaphone
kind: company
description: 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).
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: true
label: Hosted service · you call their endpoint
confidence: high
source:
- openapi
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: paid
onboarding: unknown
trial: false
try_now: false
public: false
label: Paid
confidence: medium
source:
- plans
- authentication
- security
generated: '2026-11-13'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/megaphone.png
x-docs-platform: apiary
x-docs-platform-confidence: medium
x-docs-platform-checked: 2026-10-04
tags:
- Podcasts
- Podcast Hosting
- Advertising
- Ad Monetization
- Dynamic Ad Insertion
- Media
- Spotify
tags_raw:
- Podcasting
- Podcast Hosting
- Advertising
- Ad Monetization
- Dynamic Ad Insertion
- Media
- Spotify
created: '2026-07-05'
modified: '2026-07-05'
specificationVersion: '0.23'
apis:
- aid: megaphone:megaphone-campaigns-api
name: Megaphone Campaigns API
description: Legacy Direct Sales campaigns scoped to an organization.
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm/api
tags:
- Campaigns
properties:
- type: OpenAPI
url: openapi/megaphone-campaigns-api-openapi.yml
- type: Documentation
url: https://support.megaphone.fm/en/articles/2247461-megaphone-api
- type: APIReference
url: https://jsapi.apiary.io/apis/megaphoneapi/reference/podcasts.html
- type: Documentation
url: https://support.megaphone.fm/en/articles/9557628-order-management-systems-connected-to-megaphone
- aid: megaphone:megaphone-direct-sales-v2-api
name: Megaphone Direct Sales v2 API
description: v2 advertisers, campaigns, orders, assets, advertisements, and targeting (modeled).
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm/api
tags:
- Direct Sales v2
properties:
- type: OpenAPI
url: openapi/megaphone-direct-sales-v2-api-openapi.yml
- type: Documentation
url: https://support.megaphone.fm/en/articles/2247461-megaphone-api
- type: APIReference
url: https://jsapi.apiary.io/apis/megaphoneapi/reference/podcasts.html
- type: Documentation
url: https://support.megaphone.fm/en/articles/9557628-order-management-systems-connected-to-megaphone
- aid: megaphone:megaphone-episodes-api
name: Megaphone Episodes API
description: Episodes within a podcast, including dynamic ad insertion.
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm/api
tags:
- Episodes
properties:
- type: OpenAPI
url: openapi/megaphone-episodes-api-openapi.yml
- type: Documentation
url: https://support.megaphone.fm/en/articles/2247461-megaphone-api
- type: APIReference
url: https://jsapi.apiary.io/apis/megaphoneapi/reference/podcasts.html
- type: Documentation
url: https://support.megaphone.fm/en/articles/9557628-order-management-systems-connected-to-megaphone
- aid: megaphone:megaphone-exports-api
name: Megaphone Exports API
description: Metrics Export Service and Impressions Export Service (modeled).
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm/api
tags:
- Export
tags_raw:
- Exports
properties:
- type: OpenAPI
url: openapi/megaphone-exports-api-openapi.yml
- type: Documentation
url: https://support.megaphone.fm/en/articles/2247461-megaphone-api
- type: APIReference
url: https://jsapi.apiary.io/apis/megaphoneapi/reference/podcasts.html
- type: Documentation
url: https://support.megaphone.fm/en/articles/9557628-order-management-systems-connected-to-megaphone
- aid: megaphone:megaphone-networks-api
name: Megaphone Networks API
description: Top-level account containers that scope podcasts and episodes.
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm/api
tags:
- Networks
properties:
- type: OpenAPI
url: openapi/megaphone-networks-api-openapi.yml
- type: Documentation
url: https://support.megaphone.fm/en/articles/2247461-megaphone-api
- type: APIReference
url: https://jsapi.apiary.io/apis/megaphoneapi/reference/podcasts.html
- type: Documentation
url: https://support.megaphone.fm/en/articles/9557628-order-management-systems-connected-to-megaphone
- aid: megaphone:megaphone-orders-api
name: Megaphone Orders API
description: Legacy Direct Sales campaign and promo orders and their advertisements.
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm/api
tags:
- Order
tags_raw:
- Orders
properties:
- type: OpenAPI
url: openapi/megaphone-orders-api-openapi.yml
- type: Documentation
url: https://support.megaphone.fm/en/articles/2247461-megaphone-api
- type: APIReference
url: https://jsapi.apiary.io/apis/megaphoneapi/reference/podcasts.html
- type: Documentation
url: https://support.megaphone.fm/en/articles/9557628-order-management-systems-connected-to-megaphone
- aid: megaphone:megaphone-podcasts-api
name: Megaphone Podcasts API
description: Shows within a network, including feed and monetization settings.
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm/api
tags:
- Podcasts
properties:
- type: OpenAPI
url: openapi/megaphone-podcasts-api-openapi.yml
- type: Documentation
url: https://support.megaphone.fm/en/articles/2247461-megaphone-api
- type: APIReference
url: https://jsapi.apiary.io/apis/megaphoneapi/reference/podcasts.html
- type: Documentation
url: https://support.megaphone.fm/en/articles/9557628-order-management-systems-connected-to-megaphone
- aid: megaphone:megaphone-advertisements-api
name: Megaphone Advertisements API
description: The Advertisements API from Megaphone — 4 operation(s) for advertisements.
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Advertisements
properties:
- type: OpenAPI
url: openapi/megaphone-advertisements-api-openapi.yml
- aid: megaphone:megaphone-advertiser-categories-api
name: Megaphone Advertiser Categories API
description: 'Megaphone provides an endpoint for listing Advertiser Categories for Advertiser/Podcast
association.'
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Advertiser Categories
properties:
- type: OpenAPI
url: openapi/megaphone-advertiser-categories-api-openapi.yml
- aid: megaphone:megaphone-advertisers-api
name: Megaphone Advertisers API
description: '**⚠️ BREAKING CHANGE NOTICE ⚠️**
These legacy endpoints will continue to work until **July 14, 2026 11:59:59 UTC**.
v2 endpoints become available on **April 15, 2026**.
Please migrate to the v2 Advertisers API before the sunset date.'
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Advertisers
properties:
- type: OpenAPI
url: openapi/megaphone-advertisers-api-openapi.yml
- aid: megaphone:megaphone-agencies-api
name: Megaphone Agencies API
description: The Agencies API from Megaphone — 2 operation(s) for agencies.
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Agencies
properties:
- type: OpenAPI
url: openapi/megaphone-agencies-api-openapi.yml
- aid: megaphone:megaphone-campaign-orders-api
name: Megaphone Campaign Orders API
description: '**⚠️ BREAKING CHANGE NOTICE ⚠️**
These legacy endpoints will continue to work until **July 14, 2026 11:59:59 UTC**.
v2 endpoints become available on **April 15, 2026**.
Please migrate to the v2 Orders API before the sunset date.'
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Campaign Orders
properties:
- type: OpenAPI
url: openapi/megaphone-campaign-orders-api-openapi.yml
- aid: megaphone:megaphone-cuepoints-api
name: Megaphone Cuepoints API
description: '**⚠️ IMPORTANT: Sponsorship Cuepoints ⚠️**
These endpoints manage **all cuepoints** on an episode, including:
- **Ad Cuepoints**: Standard ad break markers (preroll, midroll, postroll)
- **Sponsorship Cuepoints**: Locations for sponsorship content (`cuepointType: "sponsorship"`)
**⚠️ When using the PUT endpoint to replace cuepoints, ALL existing cuepoints are deleted and replaced with the provided
array. This includes Sponsorship Cuepoints. If you do not include Sponsorship Cuepoints in your array, they will be permanently
deleted.**
Deleting a Sponsorship Cuepoint removes the target from any Sponsorship using it, potentially putting the Sponsorship
in `inactive` status. For Embedded Sponsorships, if the cuepoint is removed, the original content will play, but analytics
will not be tracked.'
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Cuepoints
properties:
- type: OpenAPI
url: openapi/megaphone-cuepoints-api-openapi.yml
- aid: megaphone:megaphone-direct-sales-api-v2-api
name: Megaphone Direct Sales API v2 API
description: '**⚠️ AVAILABILITY ⚠️**
The Direct Sales API v2 provides enhanced endpoints for managing advertisers, campaigns, orders, assets, and advertisements
for Standard and Priority campaign types.
**Base URL:** `https://cms.megaphone.fm/api/v2`
**Available From:** April 15, 2026 10:00:00 AM EST
**Migration Timeline:**
- **Before April 15, 2026:** v2 endpoints not yet available - use legacy endpoints
- **April 15 - July 14, 2026:** Both legacy and v2 endpoints work - migration period
- **After July 14, 2026:** Legacy endpoints removed
**Pagination Note (v2 Direct Sales)**
Paginated v2 list endpoints (advertisers, campaigns, orders, advertisements, assets, and geo targeting) cap `per_page`
at **50** (not 500 as stated in the global section) and follow the global pagination convention (see the Pagination section
above) with two additional exceptions:
- `X-Total` is **not** returned.
- The `Link` header does **not** include a `last` rel.
`X-Page`, `X-Per-Page`, and `Link` (`first`, `next`, `previous`) are returned as documented.
Episode Topics and Audience Interests return all records in a single response and do not support pagination.'
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Direct Sales API v2
properties:
- type: OpenAPI
url: openapi/megaphone-direct-sales-api-v2-api-openapi.yml
- aid: megaphone:megaphone-iab-advertiser-categories-api
name: Megaphone IAB Advertiser Categories API
description: 'Megaphone provides an endpoint for listing IAB Advertiser Categories used for Advertiser/Podcast
association.'
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- IAB Advertiser Categories
properties:
- type: OpenAPI
url: openapi/megaphone-iab-advertiser-categories-api-openapi.yml
- aid: megaphone:megaphone-organization-tags-api
name: Megaphone Organization Tags API
description: Megaphone provides an endpoint for listing Organization Tags.
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Organization Tags
properties:
- type: OpenAPI
url: openapi/megaphone-organization-tags-api-openapi.yml
- aid: megaphone:megaphone-promo-api-v2-api
name: Megaphone Promo API v2 API
description: '**⚠️ AVAILABILITY ⚠️**
The Promo API v2 provides endpoints for managing promos, promo advertisements, and promo assets.
- **Base URL:**`https://cms.megaphone.fm/api/v2`
- **Available From:** May 15, 2026 00:00:00 UTC
#### Migration Timeline
- **Before May 15, 2026:** v2 promo endpoints not yet available; use legacy endpoints.
- **May 15 - July 14, 2026:** Legacy endpoints and v2 promo endpoints work during the migration period.
- **After July 14, 2026 11:59:59 UTC:** Legacy promo endpoints are removed.
#### Key Differences from Orders API v2
- `promotedPodcastId` is a promo-level field and must be a Megaphone podcast UUID from the requested organization when
provided.
- Promo content targeting accepts Megaphone UUIDs under `shows` and `episodes`.
- `includeAudienceTargets` & `topics` are not supported for promos.
- Order-specific fields such as `impressionsCap`, `pacingType`, `cpmRate`, `adHash`, `copy`, and `dcmLineItemId` do not
exist on promos.
- DELETE is not supported. Archive a Promo, Promo Advertisement, or Promo Asset with `PATCH` and `status: "archived"`.'
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Promo API v2
properties:
- type: OpenAPI
url: openapi/megaphone-promo-api-v2-api-openapi.yml
- aid: megaphone:megaphone-promo-orders-api
name: Megaphone Promo Orders API
description: The Promo Orders API from Megaphone — 2 operation(s) for promo orders.
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Promo Orders
properties:
- type: OpenAPI
url: openapi/megaphone-promo-orders-api-openapi.yml
- aid: megaphone:megaphone-search-endpoints-api
name: Megaphone Search Endpoints API
description: '# Search
Megaphone provides a top-level search endpoint for various objects in our database. By default, these endpoints will return
every instance of the object accessible to the requesting user. Adding query params to the url will scope the response
but an array will always be returned.
**Note:** For all search endpoints, the `filterMax` parameter may be passed with or without a time value. When there is
no time value or when the time value is 0 (e.g. `2022-04-15` or `2022-04-15T00:00:00.0Z`), `filterMax` will be rounded
up to the end of the day, such that all values from that day are included.'
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Search Endpoints
properties:
- type: OpenAPI
url: openapi/megaphone-search-endpoints-api-openapi.yml
- aid: megaphone:megaphone-sponsorships-api
name: Megaphone Sponsorships API
description: '**⚠️ AVAILABILITY NOTICE ⚠️**
These Sponsorship API endpoints will be available starting in late April.
The Sponsorship API provides endpoints for managing sponsorships and sponsors, and for viewing bookable cuepoints for
podcast episodes.
**Base URL:** `https://cms.megaphone.fm/api/v2`
## Overview
**Standard Sponsorships**: Media file inserted. Can target multiple locations.
**Embedded Sponsorships**: Content already baked into episode audio. Created via Create Embedded Sponsorship.
**Ending a Sponsorship**: Set `endDate` or `status: "archived"` via Update. For embedded sponsorships, this stitches content
out and frees the cuepoint. Deleting the embedded cuepoint puts the sponsorship in `inactive` status and the original
content plays, but analytics will not be tracked.
**Note:** Existing Megaphone baked-in annotations will become Embedded Sponsorships without retroactive analytics.'
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Sponsorships
properties:
- type: OpenAPI
url: openapi/megaphone-sponsorships-api-openapi.yml
- aid: megaphone:megaphone-targeting-api
name: Megaphone Targeting API
description: '# Targeting
Megaphone provides a top-level endpoint for order targeting objects, including Device Targets, IAB Advertiser Categories,
MTM Categories, Nielsen Segments, and Geotargeting (Countries, Regions, and US DMAs) in our database.'
humanURL: https://developers.megaphone.fm/
baseURL: https://cms.megaphone.fm
tags:
- Targeting
properties:
- type: OpenAPI
url: openapi/megaphone-targeting-api-openapi.yml
common:
- type: AgenticAccess
url: agentic-access/megaphone-agentic-access.yml
- type: VulnerabilityDisclosure
url: security/megaphone-vulnerability-disclosure.yml
- type: DomainSecurity
url: security/megaphone-domain-security.yml
- type: Authentication
url: authentication/megaphone-authentication.yml
- type: LinkedIn
url: https://www.linkedin.com/company/megaphonepods
- type: Website
url: https://megaphone.spotify.com/
- type: Documentation
url: https://developers.megaphone.fm/
- type: APIReference
url: https://jsapi.apiary.io/apis/megaphoneapi/reference/podcasts.html
- type: Plans
url: plans/megaphone-plans-pricing.yml
- type: RateLimits
url: rate-limits/megaphone-rate-limits.yml
- type: FinOps
url: finops/megaphone-finops.yml
- type: Pricing
url: https://megaphone.spotify.com/pricing
maintainers:
- FN: Kin Lane
email: kin@apievangelist.com
Megaphone API — frequently asked questions
Does Megaphone have an API?
Yes. APIs.io lists 21 APIs from Megaphone, including Megaphone Campaigns API, Megaphone Direct Sales v2 API and Megaphone Episodes API, and 18 more.
Is there an OpenAPI specification for the Megaphone API?
Yes. APIs.io indexes 21 OpenAPI specifications for Megaphone, each linked for download from this page.
How do I authenticate with the Megaphone API?
Megaphone uses bearer-token authentication (apiKey · 1 scheme). The details are profiled on APIs.io as Megaphone Authentication.
How much does the Megaphone API cost?
APIs.io lists 2 pricing plans for Megaphone, with each plan's price, limits and inclusions under Pricing on this page.
Is the Megaphone API ready for AI agents?
Megaphone has a Kin Score of 33.6 out of 100 (thin) and an Agent Readiness score of 27.9 (agent-aware), scored by API Evangelist on 2026-11-13.
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
Kin Score
How this is scored →
It updates itself when the score changes. Paste this where you link to your API docs: