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 sports charts (nfl, nba, mlb, nhl, college-football, wnba, college-basketball, soccer, golf, tennis, formula-1, nascar, pro-wrestling) rank the players, teams, coaches, and events resolved into that league or sport rather than a single entity type, so their entries mix subject kinds. A sports chart blends each member's reach, measured against members of the same kind, with 52-day elevation, so its ranks do not follow podcast_count, and league organizations such as divisions sit below the top 10. The composite charts rank by a blend of reach and 52-day elevation, so their ranks do not follow podcast_count: all 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 — while all-entertainment and all-sports pool only their own group's charts, so an entry there always has a sibling chart to drill into. 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 composite charts (all, all-entertainment, all-sports) and every sports chart except nfl, nba, mlb, nhl, and college-football publish the 7d window only, so requesting one with window=24h is a 422.

get/v1/podcasts/entities/charts/{category}

Request

Base URL: https://api.particle.pro
URL: https://api.particle.pro/v1/podcasts/entities/charts/{category}
Auth: one of:
- API key in header X-API-Key
- HTTP bearer

Path parameters

categorystring required

Chart identifier from GET /v1/podcasts/entities/charts (e.g. 'all', 'tv-series', 'movies', 'video-games', 'guests', 'all-sports', 'nfl').

Query parameters

window'7d' | '24h'

Measurement window for the edition to return. The all chart publishes 7d only.

limitinteger

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.

sort'rank' | 'acceleration'

Response 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.

includestring[] nullable

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.

Response

category_namestring required

Display name for the chart.

category_slugstring required

Chart identifier.

computed_atstring date-time

When the positions were computed.

edition_datestring required

Eastern-time calendar date the edition describes, as YYYY-MM-DD.

enriched_atstring date-time

When the narrative pipeline finished. Absent while status is 'computed'.

methodology_versioninteger required

Version of the ranking methodology that produced this edition. Editions across a version change are not directly comparable.

source'mentions' | 'guest_appearances' required

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 sports charts and the composite charts (all, all-entertainment, all-sports) blend reach with 52-day elevation, so their rank does not follow podcast_count; all draws on a wider curated pool of entity types (people, books, music, brands, organizations, sports, events, products, and more), and the per-group composites pool only their group's charts; 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.

statusstring required

Edition lifecycle: 'computed' or 'enriched'.

windowstring required

Measurement window this edition covers.

Changes

No recorded changes to this operation across all 2 revisions of this API.