Castos API

Name: Castos API API
Brand: Castos API
Availability: InStock

★ Only Publicly Available OpenAPI DocumentMediaAudio Processingbearer22 EndpointsREST

For Agents

Manage podcasts, episodes, and private subscribers on Castos, including bulk operations for invite-only feeds and reactivation of revoked subscribers.

Quickstart

Get started with Castos API in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"publish a podcast episode to Castos"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with Castos API API.

Create, update, and delete podcasts hosted on a Castos account

Publish, edit, and remove individual episodes within a podcast

Add private subscribers to a podcast for paid or members-only feeds

Bulk create, update, and revoke private subscribers in a single API call

Look up a private subscriber by email or by subscriber id

GET STARTED

Start building with Castos API API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for Castos API, keeping it validated and agent-ready.

Jentic publishes the only available OpenAPI specification for Castos API, keeping it validated and agent-ready. Castos is a podcast hosting platform for creators and the v2 API exposes podcast and episode management together with private subscriber controls used by paid and members-only feeds. The API supports listing, creating, updating, and deleting podcasts and episodes, plus full lifecycle management of private subscribers including bulk create, update, revoke, and reactivate operations. It also returns the supported podcast category taxonomy used when classifying a show.

Use Cases

Patterns agents use Castos API API for, with concrete tasks.

★ Membership-driven podcast access

Membership platforms can sync their paid subscribers into a Castos private feed using POST /private-subscribers and POST /create-private-subscribers for bulk imports. When a member cancels, POST /revoke-private-subscribers cuts feed access; reactivation endpoints restore it without re-collecting their email.

POST /create-private-subscribers with a list of 50 customer email addresses against podcast_id=42 to grant feed access in one batch.

Programmatic episode publishing

Production teams can post finished episodes to Castos using POST /podcasts/{podcast_id}/episodes with the audio URL, title, and show notes, then update metadata later via the corresponding update endpoint. This removes the manual step of uploading episodes via the Castos web UI for every release.

POST /podcasts/{podcast_id}/episodes with title, audio_url, and publish_at set to next Tuesday at 06:00 UTC.

Subscriber lifecycle management

Customer success workflows can keep Castos in sync with the source of truth by looking up a subscriber via GET /private-subscribers/email/{email_address}, then revoking, reactivating, or deleting based on billing status. Bulk endpoints make this efficient when running monthly reconciliation.

GET /private-subscribers/email/jane@example.com, then POST /private-subscribers/reactivate/email/jane@example.com if she has paid the outstanding invoice.

AI agent podcast operations via Jentic

An AI ops agent can take a list of new paid customers from a billing system and add them all to the right Castos private feed in one Jentic-driven call, with credentials kept inside the Jentic vault. The same agent can later trigger episode publication when a finished audio asset arrives.

Search Jentic for 'bulk create Castos private subscribers', load POST /create-private-subscribers, and execute it with the customer email batch.

Key Endpoints

22 endpoints — jentic publishes the only available openapi specification for castos api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/podcasts

List podcasts on the account

POST

/podcasts/{podcast_id}/episodes

Create a new episode

POST

/private-subscribers

Add a private subscriber to a podcast

POST

/create-private-subscribers

Bulk add private subscribers

POST

/revoke-private-subscribers

Bulk revoke private subscribers

POST

/private-subscribers/reactivate/email/{email_address}

Reactivate a subscription by email

GET

/get-categories

List supported podcast categories

GET

/podcasts

List podcasts on the account

POST

/podcasts/{podcast_id}/episodes

Create a new episode

POST

/private-subscribers

Add a private subscriber to a podcast

POST

/create-private-subscribers

Bulk add private subscribers

POST

/revoke-private-subscribers

Bulk revoke private subscribers

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Castos bearer API tokens are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped access at execution time and the token never enters prompts, logs, or response payloads.

Intent-based discovery

Agents search by intent (e.g., 'add a Castos private subscriber' or 'publish a podcast episode') and Jentic returns the matching operation along with its input schema, including the bulk variants.

Time to first call

Direct Castos integration including bulk subscriber handling and episode metadata: 1-2 days. Through Jentic: under 1 hour — search, load, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

Spotify Web API

Spotify is the listener-side platform that consumes podcast feeds Castos publishes.

Use Castos to publish episodes and Spotify to query listener-side metadata or playback for the same show.

Complementary

Castmagic API

Castmagic produces transcripts and show notes that you publish back into Castos episodes.

Run audio through Castmagic to generate show notes, then post the result as the description on a Castos episode.

Complementary

SquadCast API

SquadCast handles remote podcast recording sessions whose output you upload to Castos.

Pull finished recordings from SquadCast and create Castos episodes from the resulting audio file URLs.

FAQs

Specific to using Castos API API through Jentic.

Why is there no official OpenAPI spec for Castos API?

Castos publishes browsable docs but no machine-readable OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Castos API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.

What authentication does the Castos API use?

The Castos API uses HTTP bearer token authentication. You generate the API token from the Castos dashboard and include it as Authorization: Bearer in every request. Through Jentic the token is stored in the MAXsystem vault and injected at execution time, so it never appears in agent prompts.

Can I bulk add private subscribers to a Castos podcast?

Yes. POST /create-private-subscribers accepts a list of subscribers in a single request, and matching bulk endpoints exist for update (/update-private-subscribers) and revoke (/revoke-private-subscribers). Use these instead of looping over the per-subscriber endpoint when syncing membership lists.

What are the rate limits for the Castos API?

Castos does not document explicit numeric rate limits in this OpenAPI spec. Prefer the bulk private-subscriber endpoints over per-record loops, and avoid tight polling on /podcasts and /podcasts/{podcast_id}/episodes — use scheduled syncs instead.

How do I reactivate a cancelled Castos subscriber?

Call POST /private-subscribers/reactivate/{subscriber_id} if you know the subscriber id, or POST /private-subscribers/reactivate/email/{email_address} to reactivate by email. This restores feed access without requiring the subscriber to re-enter their email.

How do I publish a Castos episode through Jentic?

Run pip install jentic, search Jentic with the query 'publish a podcast episode to Castos', load the POST /podcasts/{podcast_id}/episodes schema, and execute it with title, audio_url, and an optional publish_at timestamp. Jentic handles the bearer token automatically.