Search episodes

GET

/api/public/episode/search

curl --request GET \
  --url 'https://backend.podscribe.ai/api/public/episode/search?search=example' \
  --header 'Authorization: Bearer <token>'

Search for episodes by query string. Supports searching in episode titles, descriptions, and transcripts.

Authorizations

• BearerAuth

Parameters

Query Parameters

search

required

string

Search query string

timeFrame

integer

Number of days to look back. Default is 31

exact

boolean

Enable exact match search. Default is false

transcriptOnly

boolean

Search only in transcripts, not in titles/descriptions. Default is false

excludeAds

boolean

Exclude ads from search results. Default is false

showFilterIds

Array<integer>

Filter episodes by multiple show IDs (array)

mediaType

Array<string>

Allowed values: all podcast youtube radio rumble

Filter episodes by media type. Can be a single value or array. If ‘all’ is included, no filter is applied.

Responses

200

OK

Media typeapplication/json

object

data

Array<object>

object

id

The unique identifier for an episode in the Podscribe platform.

integer

title

The title of an episode of a podcast or other audio content.

string

description

The description of an episode of a podcast or other audio content.

string

duration

The duration of an episode of a podcast or other audio content.

integer

uploaded_at

The date and time the episode was uploaded.

string format: date-time

url

The URL of the media file for an episode of a podcast or other audio content.

string

series_id

The unique identifier for a series in the Podscribe platform.

integer

artist

The artist of an episode of a podcast or other audio content.

string

num_listens

The number of listens of an episode of a podcast or other audio content.

integer

num_ratings

The number of ratings of an episode of a podcast or other audio content.

integer

series_logo_url

The URL of the logo for a series of a podcast or other audio content.

string

series_title

The title of a series of a podcast or other audio content.

string

highlights

Search highlights containing matched text snippets from transcripts, titles, or descriptions.

object

transcript

Array of transcript highlights containing matched phrases.

Array<object>

object

phrase

The highlighted phrase from the transcript with HTML emphasis tags.

string

startTime

The start time of the matched phrase in seconds.

number format: float

term

The search term that was matched.

string

ts

The timestamp of the matched phrase in seconds (same as startTime).

number format: float

context

The context around the matched phrase with HTML emphasis tags.

string

Example^generated

{
  "data": [
    {
      "id": 1,
      "title": "example",
      "description": "example",
      "duration": 1,
      "uploaded_at": "2026-04-15T12:00:00Z",
      "url": "example",
      "series_id": 1,
      "artist": "example",
      "num_listens": 1,
      "num_ratings": 1,
      "series_logo_url": "example",
      "series_title": "example",
      "highlights": {
        "transcript": [
          {
            "phrase": "example",
            "startTime": 1,
            "term": "example",
            "ts": 1,
            "context": "example"
          }
        ]
      }
    }
  ]
}

400

Invalid search query parameter

Media typeapplication/json

object

message

Nodejs Error

object

Example^generated

{
  "message": {}
}

500

Unexpected error

Media typeapplication/json

object

message

Nodejs Error

object

Example^generated

{
  "message": {}
}