Podcast Publishers
tier:standard

Get a podcast publisher

Returns a single podcast publisher by slug (e.g., 'goalhanger', 'iheartpodcasts', 'bbc-radio-4') or ID. Slugs are human-readable identifiers populated for the vast majority of publishers and are the recommended way to reference a publisher in URLs. The ID always works as a fallback for publishers whose name doesn't slugify.

get/v1/podcasts/publishers/{id}

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/podcasts/publishers/{id}
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

idstring required

Podcast publisher slug (e.g., 'goalhanger', 'iheartpodcasts', 'bbc-radio-4') or ID. Slugs are stable, human-readable identifiers returned on every publisher response and are the recommended way to reference a publisher in URLs.

Response

OK

idstring required

Publisher ID

namestring required

Publisher name

podcast_countinteger required

Number of podcasts attributed to this publisher.

slugstring

Human-readable slug identifier (e.g., 'goalhanger', 'iheartpodcasts'). When present, accepted in place of the ID anywhere a publisher reference is taken in the API (e.g., GET /v1/podcasts/publishers/{slug}). Occasionally absent on publishers whose name doesn't slugify.

Changes

No recorded changes to this operation across all 2 revisions of this API.