Trending

One cross-service trending list

Titles ranked across every service by a single trend score, 0–100. Three categories feed the score: chart_momentum (position, breadth, and movement across Top 10 charts inside the scope), demand (consumption and discovery intent: first-party activity is worldwide, discovery rankings follow the country scope and are summed on the global list), and attention (broad web attention: one worldwide feed, and reading per language that follows the country). Omit country for the global list; a country scope weights that country's Top 10 charts, discovery rankings, and reading in its language, while first-party demand stays worldwide. The score is daily. First-party demand counts cover the last complete day, attention is discounted when it is flat, and titles seen only by attention rank after titles with chart or demand presence.

get/v1/trending/titles

Request

  • Base URL: https://streamrank.io
  • URL: https://streamrank.io/v1/trending/titles
  • Auth: one of:
    • none
    • HTTP bearer

Query parameters

countrystring

Optional. ISO 3166-1 alpha-2. Omit it for the global list. A country scope weights that country's Top 10 charts, that country's discovery rankings, and reading in its language; first-party demand stays worldwide.

type'movie' | 'tv'

Optional. Restrict the list to movies or to shows.

status'new' | 'rising' | 'steady' | 'peaking' | 'fading'

Optional. Keep only titles with this status.

limitinteger

Optional. Default 10. Capped by your plan: 10 on Free, without a key, or with a test key; 100 on paid plans.

datestring date

Optional. A past list. Resolves to the newest list on or before the date. Requires history on your plan.

Response

OK. Body is { data } and sometimes { meta }.

Changes

No recorded changes to this operation across all 1 revision of this API.