Get a podcast request

Returns one of your organization’s podcast requests and where it stands.

GET /v1/podcasts/requests/{id}

cURL

cURL

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

200

{
  "platform": "apple",
  "platform_id": "<string>",
  "state": "requested",
  "url": "<string>",
  "detail": "<string>",
  "id": "<string>",
  "indexed_at": "2023-11-07T05:31:56Z",
  "podcast": {
    "id": "<string>",
    "title": "<string>",
    "best_rank": {
      "captured_at": "2023-11-07T05:31:56Z",
      "chart_type": "top_podcasts",
      "rank": 123,
      "source": "apple",
      "category_slug": "<string>",
      "country": "<string>"
    },
    "image_url": "<string>",
    "popularity": 123,
    "publisher": {
      "id": "<string>",
      "name": "<string>",
      "slug": "<string>"
    },
    "slug": "<string>"
  },
  "reason": "<string>",
  "requested_at": "2023-11-07T05:31:56Z",
  "title": "<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

The request's ID, as POST /v1/podcasts/requests returned it.

Response

200

application/json

OK

platform · enum<string> · required

Where the link points: an Apple Podcasts, Spotify or YouTube show, or (rss) any other URL, taken as the show's feed.

Available options: apple, spotify, youtube, rss

platform_id · string · required

The show's identifier on that platform: the Apple Podcasts id, Spotify show id, YouTube channel id or handle, or the feed URL.

state · enum<string> · required

requested: waiting for automatic screening, which usually takes a minute or two. in_review: the show did not qualify for automatic screening (no RSS feed in the link, not in English, ...) and our team will add or reject it; reason says why. indexed: the show is in the catalogue; podcast names it. rejected: we will not index it; reason says why.

Available options: requested, in_review, indexed, rejected

url · string · required

The show link as you sent it.

detail · string

The reason in a sentence, for people.

id · string

The request's ID, for GET /v1/podcasts/requests/{id}. Organizations asking for the same show share it. Absent when no request was needed because we already index the show: podcast is then set.

indexed_at · string<date-time>

When the show was indexed.

podcast · object

The show, once it is indexed. Its slug works with every podcast endpoint.

Show child attributes

reason · string

Why a request is in review or rejected, as a stable code. In review: no_feed, not_english, not_found_in_podcast_index, dead_feed, previously_removed, podcast_guid_collision, ai_generated_suspected, screening_failed, radio_rebroadcast, content_type_uncertain. Rejected: audiobook, guided_audio, non_speech_ambient, subliminal, language_instruction, kids_story, sermon_worship, low_value_publisher, ai_generated, content_farm, syndication_spam, brand_impersonation, removed.

requested_at · string<date-time>

When you asked for the show.

title · string

The show's title, when we can read it from the link before indexing it.