How To: Fetch an Episode Details

Getting Started

The SeekrAlign™ Podcast Intelligence API enables users to retrieve detailed information about a specific podcast episode. This API call is ideal for accessing episode-level metadata, such as duration, civility scores, GARM classifications, and published dates, for a single episode of a podcast show (e.g., a specific episode from The Joe Rogan Experience).

If you need to retrieve a list of episodes for a podcast, use the Fetch Episodes from a Podcast API call instead.

Purpose

This API call retrieves detailed metadata for a specific podcast episode, enabling users to analyze a single episode’s content comprehensively.

API Endpoint

API Reference:
GET Episode Details

Base URL:
https://services-api.seekr.com/api/v1/podcasts/{podcastId}/episodes/{episodeId}

Path Parameters

Authentication

All API requests must include an API key for authentication.
Header Format:

Authorization: Bearer <api_key>

Response Format

Responses are returned in JSON format, providing metadata for the specified episode.

Using the Fetch Episode Details API

Step 1: Identify the Podcast and Episode IDs

• Use the Fetch Podcast Information API to retrieve the podcastId for the show.
• Use the Fetch Episodes from a Podcast API to retrieve the episodeId for the desired episode.

Step 2: Make the API Call

Submit a GET request to the endpoint, including both the podcastId and episodeId in the URL.

Example Request

curl --request GET \
--url https://services-api.seekr.com/api/v1/podcasts/abc123xyz456/episodes/def456uvw789 \
--header 'accept: application/json' \
--header 'authorization: Bearer your_api_key'

Example Response

{
  "apiVersion": "1.0.0",
  "status": 200,
  "results": {
    "audioLinkUrl": "https://my-podcast.com/episode1/audio.mp3",
    "civilityScore": 81,
    "civilityScoreLabel": "high",
    "description": "This is a description of the episode",
    "duration": 60000,
    "episodeId": "def456uvw789",
    "episodeNumber": 1,
    "episodeTitle": "My Episode",
    "excusableAttacks": 10,
    "garm": [
      {
        "category": "Firearms",
        "level": "high"
      }
    ],
    "imageUrl": "https://imageurl.com/image",
    "inexcusableAttacks": 10,
    "podcastId": "abc123xyz456",
    "podcastTitle": "The Joe Rogan Experience",
    "publishedDate": "2023-09-23",
    "season": 1
  }
}

Use Case Examples

Example 1: Retrieve Metadata for a Specific Episode

Objective: Access details of an episode of The Joe Rogan Experience.
Steps:

• Identify the podcastId and episodeId.
• Make the API call to retrieve detailed metadata.
  Result: A JSON response with detailed episode information, including civility scores and GARM classifications.

Best Practices

1. Ensure Accuracy: Validate the podcastId and episodeId to avoid errors.
2. Analyze GARM Data: Use GARM classifications for compliance with industry standards.
3. Leverage Metadata: Use civility scores and duration information for content suitability analysis.

For more details, visit the SeekrAlign API Documentation.

Would you like to proceed with the fifth API call?