Skip to main content
GET
/
v1
/
podcasts
/
publishers
/
{id}
/
suitability
/
podcasts
cURL
curl -H "X-API-Key: $PARTICLE_API_KEY" \
  "https://api.particle.pro/v1/podcasts/publishers/{id}/suitability/podcasts?limit=25&min_prevalence=INCIDENTAL&sort=risk_desc"
{
  "data": [
    {
      "confidence": "<string>",
      "evaluated_at": "2023-11-07T05:31:56Z",
      "overall_tier": "<string>",
      "podcast": {
        "id": "<string>",
        "title": "<string>",
        "image_url": "<string>",
        "slug": "<string>"
      },
      "flagged_categories": [
        {
          "code": "<string>",
          "prevalence": "<string>",
          "risk_level": "<string>",
          "treatment": "<string>"
        }
      ]
    }
  ],
  "has_more": true,
  "cursor": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.particle.pro/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
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 or ID.

Query Parameters

​
limit
integer<int64>
default:25

Results per page

Required range: 1 <= x <= 100
​
cursor
string

Opaque pagination cursor from previous response

​
tier
enum<string>[] | null

Filter to podcasts whose latest verdict is in this tier set. To OR-filter multiple tiers, pass a comma-separated list (e.g. ?tier=UNSAFE,SENSITIVE).

Available options:
SAFE,
LIMITED,
SENSITIVE,
UNSAFE
​
category
enum<string>

Filter to podcasts whose latest assessment shows non-NONE exposure in this GARM category.

Available options:
adult_sexual,
arms_ammunition,
crime_harmful_acts,
death_injury_military_conflict,
online_piracy,
hate_speech_aggression,
obscenity_profanity,
illegal_drugs_alcohol_tobacco,
spam_harmful,
terrorism,
debated_social_issues,
misinformation
​
min_prevalence
enum<string>
default:INCIDENTAL

When combined with category, filter to podcasts whose prevalence in that category is at or above this threshold. Defaults to INCIDENTAL — any non-NONE prevalence. Ignored without category.

Available options:
INCIDENTAL,
OCCASIONAL,
FREQUENT,
PERVASIVE
​
treatment
enum<string>

When combined with category, filter to podcasts whose treatment in that category equals this value. Ignored without category.

Available options:
DOCUMENTARY,
EDITORIAL,
PROMOTIONAL,
GLAMORIZING
​
sort
enum<string>
default:risk_desc

Sort order. risk_desc ranks the most-risky first (UNSAFE → SAFE); risk_asc inverts that; recently_evaluated sorts by most-recent assessment first.

Available options:
risk_desc,
risk_asc,
recently_evaluated

Response

OK

​
data
object[] | null
required

List of results

​
has_more
boolean
required

Whether more results exist

​
cursor
string

Pass to next request for more results