curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/entities/charts/{category}?window=7d&limit=10&sort=rank"{
"category_name": "<string>",
"category_slug": "<string>",
"edition_date": "<string>",
"entries": [
{
"episode_count": 123,
"mention_count": 123,
"movement": "new",
"podcast_count": 123,
"previous_episode_count": 123,
"previous_mention_count": 123,
"previous_podcast_count": 123,
"rank": 123,
"rank_change": 123,
"subject": {
"entity": {
"id": "<string>",
"name": "<string>",
"slug": "<string>",
"company": {
"id": "<string>",
"domain": "<string>",
"ticker": "<string>"
},
"description": "<string>",
"image_url": "<string>",
"person": {
"id": "<string>",
"company": "<string>",
"image_url": "<string>",
"title": "<string>"
},
"type": {
"name": "<string>",
"slug": "<string>"
},
"wikipedia_url": "<string>"
},
"person": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"image_url": "<string>",
"slug": "<string>"
},
"type": "entity"
},
"accel_multiple": 123,
"appearances": [
{
"episode": {
"id": "<string>",
"title": "<string>",
"duration_seconds": 123,
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
},
"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>"
},
"bias": "<string>",
"speaking_seconds": 123,
"suitability_tier": "<string>"
}
],
"breaking": true,
"caveats": [
"<string>"
],
"driven_by": {
"rank": 123,
"subject": {
"entity": {
"id": "<string>",
"name": "<string>",
"slug": "<string>",
"company": {
"id": "<string>",
"domain": "<string>",
"ticker": "<string>"
},
"description": "<string>",
"image_url": "<string>",
"person": {
"id": "<string>",
"company": "<string>",
"image_url": "<string>",
"title": "<string>"
},
"type": {
"name": "<string>",
"slug": "<string>"
},
"wikipedia_url": "<string>"
},
"person": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"image_url": "<string>",
"slug": "<string>"
},
"type": "entity"
}
},
"highlight_clip": {
"end_seconds": 123,
"engagement": 123,
"start_seconds": 123,
"title": "<string>",
"audio_url": "<string>",
"episode": {
"id": "<string>",
"title": "<string>",
"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>"
},
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
}
},
"previous_rank": 123,
"signals": {
"state": "breaking",
"elevation_baseline": 123,
"elevation_recent": 123,
"trend_baseline": 123,
"trend_recent": 123
},
"timeseries": {
"buckets": [
{
"mention_count": 123,
"podcast_count": 123,
"start": "<string>"
}
],
"interval": "day",
"end": "<string>",
"start": "<string>"
},
"tombstone": true,
"why": {
"text": "<string>",
"verifiable": true,
"clip": {
"end_seconds": 123,
"engagement": 123,
"start_seconds": 123,
"title": "<string>",
"audio_url": "<string>",
"episode": {
"id": "<string>",
"title": "<string>",
"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>"
},
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
}
},
"generated_at": "2023-11-07T05:31:56Z",
"quote": "<string>",
"quote_end_seconds": 123,
"quote_start_seconds": 123,
"quote_window": [
{
"end_seconds": 123,
"start_seconds": 123,
"text": "<string>",
"is_mention": true,
"number": 123,
"role": "<string>",
"speaker": "<string>"
}
],
"source_episode": {
"id": "<string>",
"title": "<string>",
"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>"
},
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
},
"source_episode_id": "<string>",
"source_episode_name": "<string>"
}
}
],
"methodology_version": 123,
"source": "mentions",
"status": "<string>",
"window": "<string>",
"caveats": [
"<string>"
],
"computed_at": "2023-11-07T05:31:56Z",
"enriched_at": "2023-11-07T05:31:56Z"
}{
"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"
}{
"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 an entity chart
Returns the current edition of one chart, each entry with its movement since the previous edition. How the chart ranks depends on the chart. The per-category mention charts (tv-series, movies, video-games) rank entities by how many distinct podcasts mentioned them organically in the window, which is podcast_count. The composite all chart draws on a wider curated pool of entity types — people, books, music, brands, companies and organizations, sports, events, and products as well as the three published categories — and ranks them by a blend of that reach and their 52-day elevation, so its ranks do not follow podcast_count. The guests chart ranks people by the distinct shows they appeared on. When the narrative pipeline has explained an entry, why carries a one-line explanation and, when one was captured, the verbatim quote with its source episode and the offsets to play it from; why.verifiable says whether that episode still exists. why is absent for entries with no explanation, which is normal: a flat hold or an ordinary decline is deliberately left unexplained. Access: an API key reads every chart at full depth. A session without paid Radar access reads only the composite all chart, its top 10 entries with the signal operands (signals.trend_*, signals.elevation_*) omitted, and is refused the per-category charts. The all chart publishes the 7d window only, so requesting it with window=24h is a 422.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/podcasts/entities/charts/{category}?window=7d&limit=10&sort=rank"{
"category_name": "<string>",
"category_slug": "<string>",
"edition_date": "<string>",
"entries": [
{
"episode_count": 123,
"mention_count": 123,
"movement": "new",
"podcast_count": 123,
"previous_episode_count": 123,
"previous_mention_count": 123,
"previous_podcast_count": 123,
"rank": 123,
"rank_change": 123,
"subject": {
"entity": {
"id": "<string>",
"name": "<string>",
"slug": "<string>",
"company": {
"id": "<string>",
"domain": "<string>",
"ticker": "<string>"
},
"description": "<string>",
"image_url": "<string>",
"person": {
"id": "<string>",
"company": "<string>",
"image_url": "<string>",
"title": "<string>"
},
"type": {
"name": "<string>",
"slug": "<string>"
},
"wikipedia_url": "<string>"
},
"person": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"image_url": "<string>",
"slug": "<string>"
},
"type": "entity"
},
"accel_multiple": 123,
"appearances": [
{
"episode": {
"id": "<string>",
"title": "<string>",
"duration_seconds": 123,
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
},
"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>"
},
"bias": "<string>",
"speaking_seconds": 123,
"suitability_tier": "<string>"
}
],
"breaking": true,
"caveats": [
"<string>"
],
"driven_by": {
"rank": 123,
"subject": {
"entity": {
"id": "<string>",
"name": "<string>",
"slug": "<string>",
"company": {
"id": "<string>",
"domain": "<string>",
"ticker": "<string>"
},
"description": "<string>",
"image_url": "<string>",
"person": {
"id": "<string>",
"company": "<string>",
"image_url": "<string>",
"title": "<string>"
},
"type": {
"name": "<string>",
"slug": "<string>"
},
"wikipedia_url": "<string>"
},
"person": {
"id": "<string>",
"name": "<string>",
"description": "<string>",
"image_url": "<string>",
"slug": "<string>"
},
"type": "entity"
}
},
"highlight_clip": {
"end_seconds": 123,
"engagement": 123,
"start_seconds": 123,
"title": "<string>",
"audio_url": "<string>",
"episode": {
"id": "<string>",
"title": "<string>",
"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>"
},
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
}
},
"previous_rank": 123,
"signals": {
"state": "breaking",
"elevation_baseline": 123,
"elevation_recent": 123,
"trend_baseline": 123,
"trend_recent": 123
},
"timeseries": {
"buckets": [
{
"mention_count": 123,
"podcast_count": 123,
"start": "<string>"
}
],
"interval": "day",
"end": "<string>",
"start": "<string>"
},
"tombstone": true,
"why": {
"text": "<string>",
"verifiable": true,
"clip": {
"end_seconds": 123,
"engagement": 123,
"start_seconds": 123,
"title": "<string>",
"audio_url": "<string>",
"episode": {
"id": "<string>",
"title": "<string>",
"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>"
},
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
}
},
"generated_at": "2023-11-07T05:31:56Z",
"quote": "<string>",
"quote_end_seconds": 123,
"quote_start_seconds": 123,
"quote_window": [
{
"end_seconds": 123,
"start_seconds": 123,
"text": "<string>",
"is_mention": true,
"number": 123,
"role": "<string>",
"speaker": "<string>"
}
],
"source_episode": {
"id": "<string>",
"title": "<string>",
"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>"
},
"published_at": "2023-11-07T05:31:56Z",
"slug": "<string>"
},
"source_episode_id": "<string>",
"source_episode_name": "<string>"
}
}
],
"methodology_version": 123,
"source": "mentions",
"status": "<string>",
"window": "<string>",
"caveats": [
"<string>"
],
"computed_at": "2023-11-07T05:31:56Z",
"enriched_at": "2023-11-07T05:31:56Z"
}{
"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"
}{
"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
Chart identifier from GET /v1/podcasts/entities/charts (e.g. 'all', 'tv-series', 'movies', 'video-games', 'guests').
Query Parameters
Measurement window for the edition to return. The all chart publishes 7d only.
7d, 24h How many ranked entries to return, from rank 1 down. Editions persist far deeper than the product surfaces, so raise this to page further into the chart. A session without paid Radar access reads the all chart 10 entries deep regardless of limit.
1 <= x <= 100Response ordering. 'rank' returns the chart as published. 'acceleration' reorders the whole persisted edition by each entry's accel_multiple, fastest first, so a fast riser deep in the chart can surface; entries without a multiple or with fewer than 5 podcasts follow in rank order. Acceleration is not measured for the guests chart, so 'acceleration' returns guests in rank order.
rank, acceleration Optional response sections (comma-separated). 'timeseries' adds each entry's daily podcast and mention history. 'driven_by' adds, on a derivative entry, the entry whose coverage drives it, for grouping derivative entries under what drives them.
timeseries, driven_by Response
OK
Display name for the chart.
Chart identifier.
Eastern-time calendar date the edition describes, as YYYY-MM-DD.
Ranked entries. Rank ascending by default; ordered by accel_multiple when the chart was requested with sort=acceleration, with each entry's rank still naming its published chart position.
Show child attributes
Show child attributes
Version of the ranking methodology that produced this edition. Editions across a version change are not directly comparable.
Which measurement family this chart belongs to, so a client knows which entry fields apply: 'mentions' charts measure organic podcast mentions and carry mention_count, accel_multiple, and signals — the per-category charts rank by distinct mentioning podcasts, while the composite all chart draws on a wider curated pool of entity types (people, books, music, brands, organizations, sports, events, products, and more) and blends that reach with 52-day elevation, so its rank does not follow podcast_count; the 'guest_appearances' chart ranks people by the distinct shows they appeared on, always reports mention_count 0, and carries appearances and highlight_clip instead.
mentions, guest_appearances Edition lifecycle: 'computed' or 'enriched'.
Measurement window this edition covers.
Edition-level measurement caveats.
When the positions were computed.
When the narrative pipeline finished. Absent while status is 'computed'.
Was this page helpful?