# StreamRank API

> StreamRank serves daily Top 10 charts for Netflix, Prime Video, Disney+, HBO Max, Hulu, Apple TV+, Paramount+, and Peacock.

No API key is required for the free scope: country=US; provider=netflix; current charts only.

Base URL: https://streamrank.io/v1

Auth: optional `Authorization: Bearer sk_live_…` or `sk_test_…`

## Docs

- [Full API reference (markdown)](https://streamrank.io/docs.md): complete endpoint docs, examples, errors, and plans
- [llms-full.txt](https://streamrank.io/llms-full.txt): same content as the markdown reference
- [OpenAPI 3.1](https://streamrank.io/v1/openapi.json): machine-readable contract
- [HTML docs](https://streamrank.io/docs): human playground

## Endpoints

- [GET /v1/charts](https://streamrank.io/docs.md#charts): Current or historical Top 10
- [GET /v1/titles](https://streamrank.io/docs.md#title-search): Look up titles by name, IMDb id, or TMDB id
- [GET /v1/titles/{id}](https://streamrank.io/docs.md#title): Canonical title, current positions, lifetime stats
- [GET /v1/titles/{id}/rankings](https://streamrank.io/docs.md#title-rankings): Day-by-day ranking history
- [GET /v1/trending](https://streamrank.io/docs.md#trending): Risers, new entries, longest streaks
- [GET /v1/trending/titles](https://streamrank.io/docs.md#trending-titles): One cross-service trending list
- [GET /v1/titles/{id}/trend](https://streamrank.io/docs.md#title-trend): Day-by-day trend score for one title
- [GET /v1/countries](https://streamrank.io/docs.md#countries): Countries with chart data
- [GET /v1/providers](https://streamrank.io/docs.md#providers): Providers and their countries

## Optional

- [Pricing](https://streamrank.io/pricing)
- [Sign up for an API key](https://streamrank.io/signup)