get_performer_rank_chart
Performer Rank Chart
Reads only.
Use this for one performer's popularity rank day by day. Use get_performer_analytics instead for the performer's current row. Daily marketplace popularity-rank time series for one performer (performer_rank_daily), ordered snapshot_date ASC. Columns per row: popularity_rank = the performer's rank by recent (rolling-window) sales revenue; lifetime_rank = rank by all-time revenue; captured_at = when the day's reading was taken. Rank semantics: HIGHER = BETTER (more revenue); null = unranked that day, not zero. Like the demand chart, ranks are rolling-window LEVELS: read the day-over-day change as momentum (a climbing popularity_rank = the performer is selling relatively more lately). History starts 2026-07-17, so history is shallow initially. Answers {performer_id, performer_name, range, rows}: rows is the series and performer_name is whose it is, so a chart legend reads a name and never an id. rows:[] when no rows. A rendered chart image of the series is included by default; pass render:false for data only.
Parameters
| Name | Type | Required | Default | Notes |
|---|---|---|---|---|
performer_id | string or integer | yes | The performer to chart. Ticker performer id, pf plus ten characters, as returned by every tool here. A marketplace id also resolves with its vs: prefix, and bare until 2027-09-13. | |
range | string | 28d | Lookback window over snapshot_date: 7d | 14d | 28d | 90d | all (all is bounded to ~1 year). Default 28d. One of 7d, 14d, 28d, 90d, all. | |
render | boolean | true | A rendered chart (a PNG image content block) is included ahead of the data by default. Pass false for a data-only (smaller) response. |