Podcast.co podcast page API
The podcast page API from Podcast.co — 1 operation(s) for podcast page.
The podcast page API from Podcast.co — 1 operation(s) for podcast page.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/podcast-co:podcast-co-podcast-page-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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: 3.2.0
info:
version: 1.0.0
title: Podcast.co Public podcast page API
contact:
name: API Support
url: help.podcast.co
email: help@podcast.co
servers:
- url: https://public-api.pod.co
security: []
tags:
- name: podcast page
paths:
/podcasts/{podcast_slug}/page:
parameters:
- $ref: '#/components/parameters/podcast_slug'
get:
summary: Get settings
operationId: getPodcastPageSettings
tags:
- podcast page
responses:
'200':
description: Page settings
content:
application/json:
schema:
title: Page Settings
description: Page settings
type: object
properties:
data:
type: object
properties:
theme:
title: Theme
type: object
required:
- background_color
- text_color
- accent_color
properties:
background_color:
$ref: '#/paths/~1podcasts~1%7Bpodcast_slug%7D~1subscribe_button/get/responses/200/content/application~1json/schema/properties/data/properties/theme/properties/background_color'
text_color:
$ref: '#/paths/~1podcasts~1%7Bpodcast_slug%7D~1subscribe_button/get/responses/200/content/application~1json/schema/properties/data/properties/theme/properties/background_color'
accent_color:
$ref: '#/paths/~1podcasts~1%7Bpodcast_slug%7D~1subscribe_button/get/responses/200/content/application~1json/schema/properties/data/properties/theme/properties/background_color'
settings:
title: Settings
type: object
required:
- font
- show_header
- header_color
- use_background_image
- blur_background_image
- overlay
- wave
- allow_contact
- contact_email
- google_analytics_id
- hosts_section_title
properties:
font:
type: string
default: Sailec
description: The font used for the page
show_header:
type: boolean
default: true
description: Whether to show header or not
header_color:
$ref: '#/paths/~1podcasts~1%7Bpodcast_slug%7D~1subscribe_button/get/responses/200/content/application~1json/schema/properties/data/properties/theme/properties/background_color'
use_background_image:
type: boolean
default: false
description: Whether to use a background image or not
blur_background_image:
type: boolean
default: true
description: Whether to blur the background image or not
overlay:
type: boolean
default: true
description: Whether to blur the background image or not
wave:
type: boolean
default: true
description: Whether to show wave or not
allow_contact:
type: boolean
default: true
description: Whether to allow contact or not
contact_email:
type:
- string
- 'null'
format: email
description: The contact email
google_analytics_id:
type:
- string
- 'null'
example: UA-12345-6
hosts_section_title:
type:
- string
- 'null'
example: The hosts
about:
title: About
type: object
required:
- title
- description
properties:
title:
type: string
description: The about section title
example: 'Guardian: Football weekly'
description:
type: string
description: The about section description
example: Weekly show giving you all the insights into the Premier League and more.
banner:
title: Banner
type: object
required:
- urls
properties:
urls:
type: array
items:
title: BannerImage
type: object
required:
- url
- size
properties:
url:
type: string
format: uri
example: https://assets.pod.co/banner.png
size:
type: string
format: ^[0-9]*x[0-9]*$
description: Size of the image
example: 900x300
title:
type:
- string
- 'null'
example: 'Guardian: Football weekly'
logo:
oneOf:
- type: object
title: Podcast logo
properties:
type:
type: string
enum:
- page-logo
default: page-logo
urls:
type: array
items:
type: object
properties:
size:
type: string
format: ^[0-9]*x[0-9]*$
description: Size of the artwork
example: 200x200
url:
type: string
format: uri
description: Url for the artwork
example: https://artwork.pod.co/podcast/123.jpg
required:
- size
- url
required:
- type
- urls
- title: Nullable
required:
- theme
- settings
- about
- banner
- title
- logo
'403':
$ref: '#/paths/~1podcasts~1%7Bpodcast_slug%7D/get/responses/403'
components:
parameters:
podcast_slug:
in: path
name: podcast_slug
required: true
description: a podcast slug
schema:
type: string
pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
example: guardian-football-weekly