Discovery needs no key. Ratings and market analysis are Pro.
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.
openapi: 3.2.0
info:
title: Acast Publishing Shows API
description: The Acast Publishing API lets you programmatically query data about your shows and episodes, and create, update, and delete episodes straight from the command line or an existing CMS.
version: '1.0'
contact:
name: Acast
url: https://developers.acast.com/
servers:
- url: https://api.acast.com
description: Acast Publishing API
security:
- apiKeyAuth: []
tags:
- name: Shows
description: Read podcast show metadata assigned to the API key's user.
paths:
/shows:
get:
operationId: listShows
tags:
- Shows
summary: List shows
description: Lists all shows in the network that are assigned to the authenticated user. Path modeled; resource and method confirmed from documentation.
responses:
'200':
description: A list of shows.
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
$ref: '#/components/schemas/Show'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
/shows/{showId}:
parameters:
- $ref: '#/components/parameters/ShowId'
get:
operationId: getShow
tags:
- Shows
summary: Get a show
description: Fetches details for a specific show, including its episode listing and RSS feed. Path modeled; resource and method confirmed from documentation.
responses:
'200':
description: The requested show.
content:
application/json:
schema:
$ref: '#/components/schemas/Show'
'401':
$ref: '#/components/responses/Unauthorized'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimited'
components:
responses:
NotFound:
description: The requested resource does not exist or is not assigned to this user.
RateLimited:
description: Rate limit exceeded (60 requests/minute).
Unauthorized:
description: Missing or invalid X-API-Key.
schemas:
Show:
type: object
description: A podcast show hosted on Acast.
properties:
id:
type: string
title:
type: string
description:
type: string
rssFeedUrl:
type: string
format: uri
imageUrl:
type: string
format: uri
parameters:
ShowId:
name: showId
in: path
required: true
description: The unique identifier of the show.
schema:
type: string
securitySchemes:
apiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: User-scoped API key issued by Acast customer success to Ace plan and Creator Network accounts. Sent on every request in the X-API-Key header.
x-endpointsModeled: true