---
title: "One cross-service trending list"
method: GET
path: "/v1/trending/titles"
tags: ["Trending"]
---

# One cross-service trending list

`GET /v1/trending/titles`

## Request

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

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.

## Query parameters

- `country` string
- `type` 'movie' | 'tv'
- `status` 'new' | 'rising' | 'steady' | 'peaking' | 'fading'
- `limit` integer
- `date` string, date

## Response `200`

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

## Other responses

- `400`: invalid_request
- `401`: unauthorized
- `403`: plan_required
- `404`: not_found
- `429`: rate_limited or quota_exceeded

---

[API](https://skmtc.dev/streamrank/apis/streamrank-api.md) · [All operations](https://skmtc.dev/streamrank/apis/streamrank-api/llms.txt) · [OpenAPI document](https://skmtc.dev/streamrank/apis/streamrank-api/revisions/082b881d04e4?raw)