---
title: "Canonical title, current positions, lifetime stats"
method: GET
path: "/v1/titles/{id}"
tags: ["Titles"]
---

# Canonical title, current positions, lifetime stats

`GET /v1/titles/{id}`

## Request

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

Accepts a title id (`ttl_…`), slug, IMDb id, or TMDB id. TMDB ids that match both a movie and a show should use GET /v1/titles?tmdb_id=&type= instead. Returns where it sits on every current chart plus lifetime stats.

## Path parameters

- `id` string, required

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