Docs/Models

ContentHit

object

The core content object returned across the API.

A ContentHit is the canonical representation of any piece of content: a show, episode, album, track or clip. It carries identity (_id, _type), user-facing info (including the playable info.audio and info.video URLs) and links to related content.

Fields

_idContentIDrequired

Unique content identifier.

_typeContentTyperequired

The kind of content.

_guidstringoptional

Podcast GUID, when the content originates from an RSS feed.

infoobjectrequired

User-facing display information, plus the playable audio and video URLs.

titlestringrequired

Display title.

subtitlestringoptional

Secondary title, e.g. the parent show name for an episode.

publisherstringoptional

The publisher or author.

descriptionstringoptional

Long-form description or show notes (may contain HTML).

imagestringoptional

Cover artwork URL.

audiostringoptional

Playable audio URL, present on episodes and tracks.

videostringoptional

Playable video URL, when the content has video.

durationnumberoptional

Duration in seconds.

publishedstringoptional

ISO-8601 publish date.

payablebooleanoptional

Whether the content can receive value-for-value payments.

linksContentID[]optional

Identifiers for related content, e.g. an episode links to its parent show.

tagsstring[]optional

Genre and hashtag tags, e.g. genre:bitcoin.

Example

{
  "_id": "episode:id:abc123",
  "_type": "EPISODE",
  "_guid": "abcdef",
  "info": {
    "title": "#2394 - Palmer Luckey",
    "subtitle": "The Joe Rogan Experience",
    "publisher": "Joe Rogan",
    "audio": "https://example.com/episodes/abc123/audio.mp3",
    "video": "https://example.com/episodes/abc123/video.m3u8",
    "duration": 11294,
    "published": "2025-10-16T17:00:00.000Z"
  },
  "links": [
    "show:id:def456"
  ]
}