---
title: "Day-by-day ranking history"
method: GET
path: "/v1/titles/{id}/rankings"
tags: ["Titles"]
---

# Day-by-day ranking history

`GET /v1/titles/{id}/rankings`

## Request

- Base URL: `https://streamrank.io`
- URL: `https://streamrank.io/v1/titles/{id}/rankings`
- Auth: one of:
  - none
  - HTTP bearer

Newest first, clamped to your plan's history window.

## Path parameters

- `id` string, required

## Query parameters

- `provider` 'netflix' | 'prime' | 'disney' | 'max' | 'hulu' | 'apple' | 'paramount' | 'peacock' | 'starz'
- `country` string
- `from` string, date
- `to` string, date
- `limit` integer

## 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)