How To: Fetch a Podcast Show Details

Getting Started

The SeekrAlign Podcast Intelligence API enables users to retrieve detailed information about a specific podcast show. This API call is ideal for accessing enriched data for a particular podcast (e.g., The Joe Rogan Experience), including its civility scores, description, genres, and publication details. If you're looking for broader, multiple podcast results, use the Fetch All Podcast Shows API instead.

Purpose

This API call retrieves detailed, show-level information about a specific podcast. It focuses on providing a deep dive into one podcast’s metadata using its unique podcastId.

API Endpoint

API Reference:
GET Podcast Details

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

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 detailed information about the podcast show.

Using the Fetch Detailed Podcast Information API

Step 1: Identify the Podcast ID

Obtain the podcastId for the specific podcast you want to query. You can retrieve this from the Fetch Podcast Information API call.

Step 2: Make the API Call

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

Example Request

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

Example Response

{
  "apiVersion": "1.0.0",
  "status": 200,
  "results": {
    "authors": ["Joe Rogan"],
    "civilityScore": 85,
    "civilityScoreLabel": "high",
    "description": "Joe Rogan's long-form podcast featuring a variety of guests.",
    "edisonRanking": 3,
    "genres": ["Comedy", "Talk"],
    "imageUrl": "https://imageurl.com/joerogan",
    "lastPublishedDate": "2023-09-23",
    "podcastId": "abc123xyz456",
    "podcastTitle": "The Joe Rogan Experience",
    "rssFeedUrl": "https://rssfeed.com/joerogan",
    "totalDuration": 7200000
  }
}

Use Case Examples

Example 1: Retrieve Metadata for a Podcast Show

Objective: Get detailed information about The Joe Rogan Experience.
Steps:

• Identify the podcastId for the show (e.g., 34043753fa18efe73b73ee24eff27381).
• Call the API with the podcast ID.
  Result: The API returns the civility score, genres, description, and other metadata for the show.

Best Practices

1. Validate Podcast ID: Ensure you’re using the correct podcastId to avoid errors.
2. Focus on Show-Level Data: This API is for a single podcast's details. Use episode-level API calls for specific episodes.
3. Combine with Other APIs: Pair this API with the Fetch Episodes from a Podcast endpoint for a complete dataset.

For more details, visit the SeekrAlign API Documentation.

Would you like to proceed with the third API call?