curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/requests/{id}"{
"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>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Get a podcast request
Returns one of your organization’s podcast requests and where it stands.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/requests/{id}"{
"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>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Pass your API key in the X-API-Key header (recommended).
Path Parameters
The request's ID, as POST /v1/podcasts/requests returned it.
Response
OK
Where the link points: an Apple Podcasts, Spotify or YouTube show, or (rss) any other URL, taken as the show's feed.
apple, spotify, youtube, rss The show's identifier on that platform: the Apple Podcasts id, Spotify show id, YouTube channel id or handle, or the feed URL.
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.
requested, in_review, indexed, rejected The show link as you sent it.
The reason in a sentence, for people.
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.
When the show was indexed.
The show, once it is indexed. Its slug works with every podcast endpoint.
Show child attributes
Show child attributes
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.
When you asked for the show.
The show's title, when we can read it from the link before indexing it.
Was this page helpful?