Simplecast Episodes API
Episodes and their authors, keywords, markers, and audio.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/simplecast-episodes-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"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.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Simplecast Episodes API
description: The Simplecast API lets you manage and read your podcasting data on the Simplecast platform - podcasts (shows), episodes, audience analytics, and distribution channels.
version: '1.0'
contact:
name: Simplecast
url: https://www.simplecast.com
servers:
- url: https://api.simplecast.com
description: Simplecast production API
security:
- bearerAuth: []
tags:
- name: Episodes
description: Episodes and their authors, keywords, markers, and audio.
paths:
/episodes/{episode_id}:
get:
operationId: getEpisode
tags:
- Episodes
summary: Retrieve an episode
parameters:
- $ref: '#/components/parameters/EpisodeId'
responses:
'200':
description: The requested episode.
content:
application/json:
schema:
$ref: '#/components/schemas/Episode'
'401':
$ref: '#/components/responses/Unauthorized'
/episodes/{episode_id}/authors:
get:
operationId: listEpisodeAuthors
tags:
- Episodes
summary: List authors for an episode
parameters:
- $ref: '#/components/parameters/EpisodeId'
responses:
'200':
description: A collection of authors.
content:
application/json:
schema:
$ref: '#/components/schemas/Collection'
'401':
$ref: '#/components/responses/Unauthorized'
/episodes/{episode_id}/keywords:
get:
operationId: listEpisodeKeywords
tags:
- Episodes
summary: List keywords for an episode
parameters:
- $ref: '#/components/parameters/EpisodeId'
responses:
'200':
description: A collection of keywords.
content:
application/json:
schema:
$ref: '#/components/schemas/Collection'
'401':
$ref: '#/components/responses/Unauthorized'
/episodes/{episode_id}/keywords/{keyword_id}:
get:
operationId: getEpisodeKeyword
tags:
- Episodes
summary: Retrieve an episode keyword
parameters:
- $ref: '#/components/parameters/EpisodeId'
- $ref: '#/components/parameters/KeywordId'
responses:
'200':
description: The requested keyword.
content:
application/json:
schema:
$ref: '#/components/schemas/Resource'
'401':
$ref: '#/components/responses/Unauthorized'
/episodes/{episode_id}/markers:
get:
operationId: listEpisodeMarkers
tags:
- Episodes
summary: List markers for an episode
description: Lists the chapter markers defined on the episode.
parameters:
- $ref: '#/components/parameters/EpisodeId'
responses:
'200':
description: A collection of markers.
content:
application/json:
schema:
$ref: '#/components/schemas/Collection'
'401':
$ref: '#/components/responses/Unauthorized'
/episodes/{episode_id}/markers/{marker_id}:
get:
operationId: getEpisodeMarker
tags:
- Episodes
summary: Retrieve an episode marker
parameters:
- $ref: '#/components/parameters/EpisodeId'
- name: marker_id
in: path
required: true
schema:
type: string
responses:
'200':
description: The requested marker.
content:
application/json:
schema:
$ref: '#/components/schemas/Resource'
'401':
$ref: '#/components/responses/Unauthorized'
/episodes/{episode_id}/audio:
post:
operationId: uploadEpisodeAudio
tags:
- Episodes
summary: Upload episode audio
description: Uploads the audio file for an episode.
parameters:
- $ref: '#/components/parameters/EpisodeId'
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
file:
type: string
format: binary
responses:
'200':
description: The audio upload was accepted.
'401':
$ref: '#/components/responses/Unauthorized'
components:
schemas:
Collection:
type: object
description: A paged collection of resources. Fields are modeled; the API is self-describing.
properties:
collection:
type: array
items:
$ref: '#/components/schemas/Resource'
pages:
type: object
properties:
total:
type: integer
limit:
type: integer
offset:
type: integer
Error:
type: object
properties:
error:
type: string
message:
type: string
Episode:
type: object
description: An episode. Fields are modeled from documented responses.
properties:
id:
type: string
title:
type: string
description:
type: string
number:
type: integer
season:
type: object
published_at:
type: string
format: date-time
href:
type: string
Resource:
type: object
description: A generic Simplecast resource. The API is self-describing; exact fields vary by type.
properties:
id:
type: string
href:
type: string
parameters:
KeywordId:
name: keyword_id
in: path
required: true
schema:
type: string
EpisodeId:
name: episode_id
in: path
required: true
schema:
type: string
responses:
Unauthorized:
description: Missing or invalid bearer token.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: 'Bearer token generated from the Private Apps page in the Simplecast dashboard. Sent as "authorization: Bearer {token}".'