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}

cURL

cURL

curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/publishers/{id}"

200

{
  "id": "<string>",
  "name": "<string>",
  "podcast_count": 123,
  "slug": "<string>"
}

Authorizations

ApiKeyHeaderBearerAuth

X-API-Key · string · header · required

Pass your API key in the X-API-Key header (recommended).

Path Parameters

id · string · 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

200

application/json

OK

id · string · required

Publisher ID

name · string · required

Publisher name

podcast_count · integer<int64> · required

Number of podcasts attributed to this publisher.

slug · string

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.