podchaser_skill

Overview

This skill provides access to the Podchaser GraphQL API for discovering podcasts, episodes, creators, networks, charts, and sponsorship data. It exposes search and detail queries so you can fetch metadata, chart rankings, transcripts, and advertising information programmatically. The skill is designed for integrations that need accurate podcast discovery and analytics.

How this skill works

Authenticate with Podchaser using client credentials to request a long-lived access token, then send GraphQL POST requests to the API. Use targeted queries to search podcasts or episodes, fetch single-item details by identifier type (PODCHASER, APPLE_PODCASTS, SPOTIFY), preview query cost via the /graphql/cost endpoint, and inspect response headers for rate and point limits. Queries should request only the fields you need to reduce cost and improve performance.

When to use it

• Build podcast discovery features by keyword, category, or chart rank.
• Fetch detailed podcast or episode metadata for directories or apps.
• Collect creator/host profiles and credits for show pages or bios.
• Retrieve sponsorship and ad data for monetization analysis.
• Estimate API cost before running expensive queries to control usage.

Best practices

• Request an access token once and cache it — tokens are valid for one year.
• Use the /graphql/cost endpoint to preview and limit point consumption.
• Only request fields you need to minimize query cost and latency.
• Respect rate limits (50 requests per 10 seconds) and check Retry-After on 429 responses.
• Never embed full access tokens in client-side code; use limited-scope tokens for public apps.

Example use cases

• Search top technology podcasts and display title, author, and cover art.
• Fetch episodes for a podcast to build an episode list with air dates and durations.
• Get Apple Podcasts or Spotify chart rankings to power chart pages.
• Lookup creator bios and credits to populate host profile pages.
• Estimate query points for a complex search before executing to avoid overage.