How To: Fetch All Podcast Shows

Getting Started

The SeekrAlign Podcast Intelligence API allows users to search and retrieve information about multiple podcast shows. This API call is ideal for discovering podcast shows that meet specific criteria, such as civility scores, genres, or titles. It provides show-level data (e.g., 2 Bears, 1 Cave, The Joe Rogan Experience, Call Her Daddy), giving you a broad overview of podcasts that align with your needs.

Purpose

This API call retrieves all podcast shows matching specified criteria, such as civility score ranges, genres, or specific titles. Use this for high-level searches when you need a list of shows rather than specific episode details. If you're looking for detailed episode-level data, use the episode-specific endpoints instead.

API Endpoint

API Reference:
GET Podcast Shows

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

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 details about each podcast show, such as civility scores, genres, descriptions, and last-published dates.

Key Features

Purpose: Retrieves all podcast shows meeting specified criteria.
Scope: Show-level data, useful for a broad overview of podcasts.
Result: Returns a list of shows with their corresponding metadata.

Using the Fetch Podcast Show Information API

Step 1: Define Query Parameters

Use query parameters to narrow your search results and target specific podcasts.

Parameter	Type	Description
`civilityScoreMax`	integer (1-100)	Maximum civility score in the results.
`civilityScoreMin`	integer (1-100)	Minimum civility score in the results.
`genres`	array of strings	Specify podcast genres (e.g., `News`, `True Crime`).
`limit`	integer (1-100)	Maximum number of results to return (default: 20).
`offset`	integer (≥0)	Starting index for results (default: 0).
`podcastTitle`	string	Name of the podcast to search for (e.g., The Joe Rogan Experience).
`sortBy`	string	Field to sort results by (e.g., `podcastTitle`).
`sortDirection`	string	Sorting direction (`asc` or `desc`). If provided, `sortBy` is required. Defaults to `desc`.

Step 2: Make the API Call

Submit a GET request to the endpoint with the query parameters included.

Example Request

curl --request GET \
--url https://services-api.seekr.com/api/v1/podcasts?civilityScoreMin=80&genres=News,True%20Crime \
--header 'accept: application/json' \
--header 'authorization: Bearer your_api_key'

Example Response

{
  "apiVersion": "1.0.0",
  "count": 2,
  "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
    },
    {
      "authors": ["The New York Times"],
      "civilityScore": 87,
      "civilityScoreLabel": "high",
      "description": "A daily podcast covering global news and events.",
      "edisonRanking": 1,
      "genres": ["News", "Politics"],
      "imageUrl": "https://imageurl.com/daily",
      "lastPublishedDate": "2023-09-23",
      "podcastId": "f3a6cf0edf0e53c71d29dcb970f3caf8",
      "podcastTitle": "The Daily",
      "rssFeedUrl": "https://rssfeed.com/thedaily",
      "totalDuration": 5400000
    }
  ]
}

Use Case Examples

Example 1: Find All Podcasts in Specific Genres

Objective: Retrieve all podcasts in the "News" and "True Crime" genres with civility scores above 80.
Steps:

Set genres=News,True Crime and civilityScoreMin=80.
Call the API.
Result: A list of podcast shows matching the criteria.

Example 2: Search for a Specific Podcast Show

Objective: Fetch details about The Joe Rogan Experience.
Steps:

Use the podcastTitle parameter: podcastTitle=The Joe Rogan Experience.
Call the API.
Result: Information about The Joe Rogan Experience, including its civility score, genres, and description.

Best Practices

Understand the Scope: Use this API call for show-level data. For specific episode information, refer to episode-level endpoints.
Refine Results: Use parameters like civilityScoreMin and genres to narrow down your search.
Combine Parameters: Combine filters for more targeted results.

For more details, visit the SeekrAlign API Documentation.

Would you like to proceed with the next API call?