# FlixPatrol API

> FlixPatrol returns daily streaming top 10 charts and title rankings, available as a workflow and API.

FlixPatrol returns daily top 10 movie and TV charts for a streaming service and country; provide a service, with date and country optional. Find a movie or show’s current country rankings across streaming services with Get title rankings; provide a title, with year and service optional.

- Page: https://fous.com/tools/flixpatrol
- Handle: `@flixpatrol`
- Category: [Entertainment](https://fous.com/tools/category/entertainment)
- Source website: https://flixpatrol.com
- Last verified: Sep 29, 2026

## Methods

### Get daily top 10

Operation `get_daily_top_10`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Get the public daily top 10 movies and TV shows for a streaming service and country. Worldwide rankings do not show daily change or days in the top 10; dates outside the public daily charts are unavailable.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `date` | string | no | `"2026-09-28"` | Chart date (YYYY-MM-DD), for example 2026-09-28. If omitted, use the latest available day. |
| `country` | string | no | `"United Kingdom"` | Country name or two-letter code, for example United States, US, United Kingdom, or worldwide. |
| `service` | string | yes | `"Disney+"` | Streaming service name, for example Netflix, Disney+, Prime Video, Max, or Apple TV+. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "service"
  ],
  "properties": {
    "date": {
      "type": "string",
      "format": "date",
      "description": "Chart date (YYYY-MM-DD), for example 2026-09-28. If omitted, use the latest available day.",
      "examples": [
        "2026-09-28"
      ]
    },
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code, for example United States, US, United Kingdom, or worldwide.",
      "examples": [
        "United Kingdom",
        "worldwide"
      ]
    },
    "service": {
      "type": "string",
      "description": "Streaming service name, for example Netflix, Disney+, Prime Video, Max, or Apple TV+.",
      "examples": [
        "Disney+",
        "Netflix",
        "Prime Video"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "date": "2026-09-28",
      "country": "United Kingdom",
      "service": "Disney+"
    },
    {
      "service": "Netflix"
    },
    {
      "country": "worldwide",
      "service": "Prime Video"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `date` | string | `"2026-09-28"` |  |
| `link` | string | `"https://flixpatrol.com/top10/disney/united-kingdom/2026-09-28/"` |  |
| `shows` | array |  |  |
| `shows[].link` | string | `"https://flixpatrol.com/title/the-real-rooneys/"` | Title page on FlixPatrol. |
| `shows[].rank` | integer | `1` |  |
| `shows[].title` | string | `"The Real Rooneys"` |  |
| `shows[].change` | string or null | `"Same"` | Movement since the previous day, or null if not shown. |
| `shows[].days_in_top_10` | integer or null | `2` | Days on this top 10, or null if not shown. |
| `movies` | array |  |  |
| `movies[].link` | string | `"https://flixpatrol.com/title/toy-story-5/"` | Title page on FlixPatrol. |
| `movies[].rank` | integer | `1` |  |
| `movies[].title` | string | `"Toy Story 5"` |  |
| `movies[].change` | string or null | `"Same"` | Movement since the previous day, or null if not shown. |
| `movies[].days_in_top_10` | integer or null | `3` | Days on this top 10, or null if not shown. |
| `country` | string | `"United Kingdom"` |  |
| `service` | string | `"Disney+"` |  |

**Example input**

```json
{
  "date": "2026-09-28",
  "country": "United Kingdom",
  "service": "Disney+"
}
```

**Example output**

```json
{
  "date": "2026-09-28",
  "link": "https://flixpatrol.com/top10/disney/united-kingdom/2026-09-28/",
  "shows": [
    {
      "link": "https://flixpatrol.com/title/the-real-rooneys/",
      "rank": 1,
      "title": "The Real Rooneys",
      "change": "Same",
      "days_in_top_10": 2
    },
    {
      "link": "https://flixpatrol.com/title/fxs-american-horror-story-official-podcast/",
      "rank": 2,
      "title": "FX's American Horror Story Official Podcast",
      "change": "Same",
      "days_in_top_10": 1
    },
    {
      "link": "https://flixpatrol.com/title/welcome-to-the-family-the-murder-of-dan-markel/",
      "rank": 3,
      "title": "Welcome to the Family: The Murder of Dan Markel",
      "change": "Same",
      "days_in_top_10": 25
    }
  ],
  "movies": [
    {
      "link": "https://flixpatrol.com/title/toy-story-5/",
      "rank": 1,
      "title": "Toy Story 5",
      "change": "Same",
      "days_in_top_10": 3
    },
    {
      "link": "https://flixpatrol.com/title/toy-story/",
      "rank": 2,
      "title": "Toy Story",
      "change": "Same",
      "days_in_top_10": 108
    },
    {
      "link": "https://flixpatrol.com/title/the-mandalorian-and-grogu/",
      "rank": 3,
      "title": "The Mandalorian and Grogu",
      "change": "Same",
      "days_in_top_10": 24
    }
  ],
  "country": "United Kingdom",
  "service": "Disney+"
}
```

### Get title rankings

Operation `get_title_rankings`, version 1. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.

Find a movie or show and see its current country rankings across streaming services. Days in the Top 10 are omitted where no country figure is shown.

**Input**

| Field | Type | Required | Example | Description |
|---|---|---|---|---|
| `year` | integer | no | `2022` | Release year to distinguish titles with similar names, for example 2022. |
| `title` | string | yes | `"Neagley"` | Movie or show name, for example Wednesday. |
| `service` | string | no | `"Netflix"` | Streaming service name, for example Netflix. Leave blank for all services. |

**Input schema**

```json
{
  "type": "object",
  "required": [
    "title"
  ],
  "properties": {
    "year": {
      "type": "integer",
      "description": "Release year to distinguish titles with similar names, for example 2022.",
      "x-fous-developer": false,
      "examples": [
        2022
      ]
    },
    "title": {
      "type": "string",
      "description": "Movie or show name, for example Wednesday.",
      "examples": [
        "Neagley",
        "Wednesday",
        "MobLand"
      ]
    },
    "service": {
      "type": "string",
      "default": "",
      "description": "Streaming service name, for example Netflix. Leave blank for all services.",
      "examples": [
        "Netflix",
        "Paramount+"
      ]
    }
  },
  "additionalProperties": false,
  "examples": [
    {
      "title": "Neagley"
    },
    {
      "year": 2022,
      "title": "Wednesday",
      "service": "Netflix"
    },
    {
      "title": "MobLand",
      "service": "Paramount+"
    }
  ]
}
```

**Output**

| Field | Type | Example | Description |
|---|---|---|---|
| `type` | string | `"TV show"` | Movie or TV show. |
| `title` | string | `"Neagley"` |  |
| `rankings` | array |  |  |
| `rankings[].country` | string | `"Australia"` |  |
| `rankings[].rank_today` | integer | `1` |  |
| `rankings[].days_in_top_10` | integer or null |  |  |
| `rankings[].flixpatrol_link` | string | `"https://flixpatrol.com/top10/amazon-prime/australia/"` |  |
| `rankings[].streaming_service` | string | `"Amazon Prime"` |  |
| `release_year` | integer or null | `2026` |  |
| `flixpatrol_link` | string | `"https://flixpatrol.com/title/neagley/"` |  |
| `total_points_today` | integer or null | `469` | Sum of available daily FlixPatrol points across services. |

**Example input**

```json
{
  "title": "Neagley"
}
```

**Example output**

```json
{
  "type": "TV show",
  "title": "Neagley",
  "rankings": [
    {
      "country": "Australia",
      "rank_today": 1,
      "days_in_top_10": null,
      "flixpatrol_link": "https://flixpatrol.com/top10/amazon-prime/australia/",
      "streaming_service": "Amazon Prime"
    },
    {
      "country": "Austria",
      "rank_today": 1,
      "days_in_top_10": null,
      "flixpatrol_link": "https://flixpatrol.com/top10/amazon-prime/austria/",
      "streaming_service": "Amazon Prime"
    },
    {
      "country": "Belgium",
      "rank_today": 1,
      "days_in_top_10": null,
      "flixpatrol_link": "https://flixpatrol.com/top10/amazon-prime/belgium/",
      "streaming_service": "Amazon Prime"
    }
  ],
  "release_year": 2026,
  "flixpatrol_link": "https://flixpatrol.com/title/neagley/",
  "total_points_today": 469
}
```

## Quick start

Replace `YOUR_API_KEY` with a Fous API key. To create one, open Developers at the bottom of Fous Studio, turn on Developer mode, then go to API keys (https://app.fous.com/keys). Change the values in `input` to run the same tool on new data.

```bash
curl 'https://api.fous.com/v1/query' \
  --fail-with-body --silent --show-error --max-time 180 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "api": "@flixpatrol",
  "visibility": "public",
  "operation": "get_daily_top_10",
  "version": 1,
  "input": {
    "date": "2026-09-28",
    "country": "United Kingdom",
    "service": "Disney+"
  },
  "response": {
    "format": "json"
  }
}'
```

```python
# Save as fous.py and run with python3 fous.py. No packages needed.
import json
import urllib.error
import urllib.request

api_key = "YOUR_API_KEY"

body = json.loads("{\n  \"api\": \"@flixpatrol\",\n  \"visibility\": \"public\",\n  \"operation\": \"get_daily_top_10\",\n  \"version\": 1,\n  \"input\": {\n    \"date\": \"2026-09-28\",\n    \"country\": \"United Kingdom\",\n    \"service\": \"Disney+\"\n  },\n  \"response\": {\n    \"format\": \"json\"\n  }\n}")
request = urllib.request.Request(
    "https://api.fous.com/v1/query",
    data=json.dumps(body).encode("utf-8"),
    headers={
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json",
    },
    method="POST",
)
try:
    with urllib.request.urlopen(request, timeout=180) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    raise RuntimeError(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}") from error
if result.get("success") is False:
    raise RuntimeError(result.get("error", {}).get("message", "Request failed"))
print(json.dumps(result["data"]["output"], indent=2))
```

```typescript
// Save as fous.mts and run with npx tsx fous.mts.
const apiKey = "YOUR_API_KEY";

const response = await fetch("https://api.fous.com/v1/query", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json",
  },
  signal: AbortSignal.timeout(180_000),
  body: JSON.stringify({
  "api": "@flixpatrol",
  "visibility": "public",
  "operation": "get_daily_top_10",
  "version": 1,
  "input": {
    "date": "2026-09-28",
    "country": "United Kingdom",
    "service": "Disney+"
  },
  "response": {
    "format": "json"
  }
}),
});
type ApiResult = { success: boolean; data?: { output: unknown }; error?: { message: string } };
const result: ApiResult = await response.json();
if (!response.ok || result.success === false) {
  throw new Error(result.error?.message ?? `HTTP ${response.status}`);
}
if (!result.data) throw new Error("Missing API response data");
console.log(result.data.output);
```

## Use from an AI assistant

Connect this tool to Claude Code, Claude Desktop, Cursor, VS Code, Codex and any MCP client as its own MCP server. Each method is a typed tool whose arguments are the method’s input.

- Server URL: `https://api.fous.com/mcp/tools/flixpatrol`
- Authorization: `Authorization: Bearer <Fous API key>`

**Tools**

- `get_daily_top_10`: Get daily top 10. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `get_title_rankings`: Get title rankings. 1 credit per completed call. Failed calls without a completed billing receipt are free; completed work can remain charged if delivery is interrupted.
- `fous_get_run`: the result of a run that was still going, by its `request_id`. Free.

Claude Code:

```bash
claude mcp add --scope user --transport http fous-flixpatrol https://api.fous.com/mcp/tools/flixpatrol --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"
```

To give the assistant every tool, connect `https://api.fous.com/mcp`: it finds one with `fous_search_tools` and runs it with `fous_run_tool`. Setup for other clients: https://fous.com/llms-full.txt.

## Use cases

- Track daily movie and TV rankings by country and streaming service.
- Compare a title’s rankings across countries and streaming services.
- Monitor how long titles remain in a daily top 10.
- Find a title’s current streaming service rankings.

## FAQ

### Can I run it with my own inputs?

Yes. Change the inputs in Studio and press Run, or send new inputs from your code, or ask a connected AI assistant.

### Can I call this FlixPatrol tool as an API?

Yes. Send a POST request to /v1/query with your Fous API key and the inputs, and get JSON back.

### How much does it cost?

Each completed run costs 1 credit. Failed runs without a completed receipt are free; completed work can remain charged if delivery is interrupted. With pay as you go, a credit costs 1¢. Monthly plans cost less per credit.

### Do I need a FlixPatrol account?

No. You only need a Fous account.

### How current is the data?

Fous gets the data from flixpatrol.com when you run it. Some results are reused for up to 24 hours, and results that use your account or key are never reused. It was last verified on Sep 29, 2026.

### What movies and shows are in a service’s daily top 10?

Get daily top 10 returns the chart for a selected streaming service and, optionally, a country and date.

### Where is a movie or show ranked today?

Get title rankings returns the title’s current country rankings across streaming services.

### How many days has a title been in the top 10?

Get daily top 10 returns days in the top 10 where shown; Get title rankings returns country figures where available.

## Related

- [Netflix API](https://fous.com/tools/netflix.md): Netflix offers weekly global and country Top 10 rankings, all-time popularity rankings based on titles’ first 91 days, and title details with country availability that may lag.
- [JustWatch API](https://fous.com/tools/justwatch.md): JustWatch shows where movies and shows are available, including streaming, purchase, and cinema options, plus recent streaming arrivals and daily streaming charts based on its listings.
- [Letterboxd API](https://fous.com/tools/letterboxd.md): Letterboxd provides films with ratings, cast, location-dependent watch services and popular reviews, plus popularity-ranked lists by time period, genre and decade; some details may be unavailable.
- [Spotify API](https://fous.com/tools/spotify.md): Spotify returns public artist profiles, album credits and ordered tracks, song details and play counts, up to 500 playlist songs, keyword results, and country-based podcast charts; dates and regional options vary.
- [TMDB API](https://fous.com/tools/tmdb.md): TMDB returns movie and TV details, cast, trailers, releases, viewing services, scheduled upcoming movies, and up to 20 homepage trending titles; future episode details depend on published schedules.
- [Kworb API](https://fous.com/tools/kworb.md): Kworb provides published Spotify and YouTube music charts and tracked artist streaming totals; chart dates may lag, and daily streams or some views may be unavailable.
- [IMDb API](https://fous.com/tools/imdb.md): IMDb returns movie, TV, person, episode, chart and Parents Guide details, including available weekly rank changes; missing details are null, and unaired or unrated episodes lack ratings.
- [Fandango API](https://fous.com/tools/fandango.md): Fandango provides nearby U.S. movie showtimes, formats, local times and ticket links; theater listings for selected dates when available; and movies now playing or coming soon with details when listed.
- [All Entertainment tools](https://fous.com/tools/category/entertainment)