Look up a show

This query returns OP3's record of a show found by its feed URL, its podcast GUID, or its OP3 show identifier.

Developer info

API endpoint slug: op3.look_up_a_show
Runtime method: performQuery("op3.look_up_a_show"}

Query fields

Podcast show Text input > Other

Label: Podcast show
Helper text: The show you want to look up, as its feed URL, its podcast GUID, or its OP3 show ID.
Slug: podcast_show
Required: true
Can have default value: true

Ingredients

Show The unique OP3 uuid for the show and a required response field; this is the identifier the download-counts queries require.

Slug: show_id
Filter code: Op3.lookUpAShow.ShowId
Type: String
Example: <32-character hex OP3 show uuid>

Show title The show's title; optional in the documented response, so conditionally populated.

Slug: show_title
Filter code: Op3.lookUpAShow.ShowTitle
Type: String
Example: The Example Podcast

Podcast guid The show's podcast GUID; optional in the documented response, so conditionally populated.

Slug: podcast_guid
Filter code: Op3.lookUpAShow.PodcastGuid
Type: String
Example: <podcast:guid from the show's feed>

Stats page url The canonical public OP3 stats page url for the show, a required response field.

Slug: stats_page_url
Filter code: Op3.lookUpAShow.StatsPageUrl
Type: Web URL
Example: https://op3.dev/show/<show-uuid>

Episode count A count of the episodes array, which the spec documents as all episodes for the show when episodes are included. Numeric value as a string.

Slug: episode_count
Filter code: Op3.lookUpAShow.EpisodeCount
Type: String
Example: 128

Latest episode title The title of the episode with the newest pubdate; the array is documented newest to oldest, and the implementation selects by maximum pubdate.

Slug: latest_episode_title
Filter code: Op3.lookUpAShow.LatestEpisodeTitle
Type: String
Example: Episode 42: How We Got Started

Latest episode published at The publication time of the episode selected as newest, documented as an ISO 8601 timestamp.

Slug: latest_episode_published_at
Filter code: Op3.lookUpAShow.LatestEpisodePublishedAt
Type: Date with time (ISO8601)
Example: 2020-07-08T04:17:06+05:00

Applets using this Query