# PilotScore

> PilotScore rates new TV show pilots (season 1, episode 1) from the US, UK, Australia and major streamers. Each show gets a 0–10 PilotScore and a letter tier, built from audience ratings, critic reviews, creative pedigree and pre-release buzz.

The website is at https://pilotscore.tv. Shows are grouped by premiere month at `https://pilotscore.tv/{year}/{month}` (for example `/2026/11`), and each show has a page at `https://pilotscore.tv/show/{id}/{slug}`. These pages are rendered client-side, so use the JSON API at https://api.pilotscore.tv for show data. It is public, read-only and needs no key.

A PilotScore combines two parts:

- Quality: user ratings from TVMaze, IMDb, Trakt and TMDB, each Bayesian-smoothed and weighted by how many votes exist; critic review averages, weighted by review count; pedigree (network, creator and cast track record), which fills in while real ratings are scarce; and retention (episode 1 vs episode 2 ratings).
- Demand: YouTube trailer views per day, Google Trends interest and TMDB popularity. Demand can only raise a score, by up to 30% of the gap when a show has no ratings yet and 15% once ratings are confident.

Gates: clearly negative critic reception (under 60% positive reviews, or an aggregate score under 50 out of 100, with enough reviews) caps the score at 7.5. Unreleased shows with almost no ratings are capped at 8.5.

Tiers: A+ is 9.0 and up, A is 7.5–8.9, B+ is 7.0–7.4, B is 6.5–6.9, B- is 6.0–6.4, C is 4.5–5.9, and D is below 4.5. Scores for unaired shows are predictions and change as ratings and reviews arrive. Data is synced daily.

## Docs

- [About PilotScore](https://pilotscore.tv/about.md): What the site covers and which shows are tracked
- [How It Works](https://pilotscore.tv/how-it-works.md): The full scoring method, with every component, weight and gate

## API

- [Pilots by month](https://api.pilotscore.tv/api/pilots/2026/11): `GET /api/pilots/{year}/{month}` returns that month's pilots with scores and tiers. Optional query params: `countries`, `tier`, `minScore`, `maxScore`, `search`
- [Show details](https://api.pilotscore.tv/api/shows/1463): `GET /api/shows/{id}` returns one show's metadata, ratings, crew, cast and score breakdown
- [Score story](https://api.pilotscore.tv/api/shows/1463/score-story): `GET /api/shows/{id}/score-story` explains why a show got its score
- [Search](https://api.pilotscore.tv/api/search?q=neuromancer): `GET /api/search?q={query}` searches show names, networks, summaries and cast/crew names (2+ characters). Optional: `genres`, `networks`, `countries`, `tier`, `year`, `limit`

## Feeds

- [RSS preview](https://api.pilotscore.tv/api/rss/preview): `GET /api/rss/preview` returns upcoming pilots as JSON. Filters: `minScore`, `tiers`, `countries`, `includeGenres`, `excludeGenres`, `includeNetworks`
- [RSS builder](https://pilotscore.tv/rss): Lets people create a custom RSS feed (Torznab-compatible, for Sonarr)

## Optional

- [Genres](https://api.pilotscore.tv/api/genres): All genres in the catalog
- [Networks](https://api.pilotscore.tv/api/networks): All networks in the catalog
- [Stats](https://api.pilotscore.tv/api/stats): Catalog size, how many shows are in each tier, counts per month and the last sync time
- [Sitemap](https://pilotscore.tv/sitemap.xml): Every month and show page on the site
- [Privacy Policy](https://pilotscore.tv/privacy.md)
- [Terms of Service](https://pilotscore.tv/terms.md)
