# JustWatch API: List streaming chart titles

> Lists titles on JustWatch's daily streaming chart for a country, optionally limited to one streaming service.

Unofficial. Not affiliated with or endorsed by JustWatch.

- Page: https://fous.com/methods/justwatch.com/list-streaming-charts
- Method: `justwatch.com/list_streaming_charts`, version 1
- Website: justwatch.com
- Returns: rank, rank change, title, year, type, JustWatch rating, services, link
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `country` | string | no | `"United States"` | Country name or two-letter code, for example Germany or DE. Default "United States". |
| `service` | string | no | `"Netflix"` | One streaming service, for example Netflix. Leave blank for all services. Default "". |
| `max_results` | integer | no | `20` | Most titles to return, for example 20. Default 20. |
| `content_type` | string | no | `"movies"` | Which chart to list, for example movies. One of "movies", "shows". Default "movies". |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "country": "United States",
  "service": "Netflix",
  "max_results": 20,
  "content_type": "movies"
}
```

Its output:

```json
{
  "charts": [
    {
      "rank": 14,
      "type": "movie",
      "year": 1980,
      "title": "Friday the 13th",
      "services": [
        "Netflix",
        "Paramount Plus Premium",
        "Paramount Plus Essential"
      ],
      "rank_change": -3,
      "justwatch_link": "https://www.justwatch.com/us/movie/friday-the-13th-1980",
      "justwatch_rating_percent": 87
    },
    {
      "rank": 15,
      "type": "movie",
      "year": 2016,
      "title": "Green Room",
      "services": [
        "Netflix",
        "JustWatch TV Free",
        "JustWatch TV Plus"
      ],
      "rank_change": 0,
      "justwatch_link": "https://www.justwatch.com/us/movie/green-room",
      "justwatch_rating_percent": 88
    },
    {
      "rank": 19,
      "type": "movie",
      "year": 2026,
      "title": "Sacrifice",
      "services": [
        "Netflix",
        "Netflix Standard with Ads"
      ],
      "rank_change": 0,
      "justwatch_link": "https://www.justwatch.com/us/movie/sacrifice-2025-1",
      "justwatch_rating_percent": 41
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"justwatch.com/list_streaming_charts","input":{"country":"United States","service":"Netflix","max_results":20,"content_type":"movies"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- What are the top 20 movies on the streaming chart in the United States today?
- Show me today's most popular TV shows streaming in Germany, limit 10.
- Which titles are climbing the daily chart on Netflix in Brazil right now?
- Give me the top 50 shows trending on Amazon Prime Video in Japan, with their ranks and rank changes.
- On justwatch.com, what movies are ranking highest for DE today on Disney Plus?

## Input schema

```json
{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "default": "United States",
      "description": "Country name or two-letter code, for example Germany or DE."
    },
    "service": {
      "type": "string",
      "default": "",
      "description": "One streaming service, for example Netflix. Leave blank for all services."
    },
    "max_results": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1,
      "description": "Most titles to return, for example 20."
    },
    "content_type": {
      "enum": [
        "movies",
        "shows"
      ],
      "type": "string",
      "default": "movies",
      "description": "Which chart to list, for example movies."
    }
  }
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "charts"
  ],
  "properties": {
    "charts": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "rank",
          "rank_change",
          "title",
          "year",
          "type",
          "justwatch_rating_percent",
          "services",
          "justwatch_link"
        ],
        "properties": {
          "rank": {
            "type": "integer",
            "description": "Position on the daily chart."
          },
          "type": {
            "enum": [
              "movie",
              "show"
            ],
            "type": "string"
          },
          "year": {
            "type": [
              "integer",
              "null"
            ]
          },
          "title": {
            "type": "string"
          },
          "services": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Services offering the title, including subscription, rental or purchase services."
          },
          "rank_change": {
            "type": [
              "integer",
              "null"
            ],
            "description": "Position change since yesterday; positive means moved up, null if new or unavailable."
          },
          "justwatch_link": {
            "type": "string"
          },
          "justwatch_rating_percent": {
            "type": [
              "integer",
              "null"
            ],
            "description": "JustWatch rating as a percent, when available."
          }
        },
        "additionalProperties": false
      }
    }
  },
  "additionalProperties": false
}
```

## See more

- [JustWatch API: List new arrivals](https://fous.com/methods/justwatch.com/list-new-arrivals.md): Lists recently added movies and show seasons on streaming services in a country, newest first, from JustWatch listings.
- [JustWatch API: Get where to watch](https://fous.com/methods/justwatch.com/get-where-to-watch.md): Finds where a movie or show can be watched in a country on JustWatch. Returns streaming, rental and purchase offers with prices, plus ratings and whether it is in cinemas.
- [Spotify API: List top podcasts](https://fous.com/methods/open.spotify.com/list-top-podcasts.md): Lists Spotify's top or trending podcasts for a country in chart order, with rank, movement, publisher, artwork and Spotify link. Category charts exist only for some countries.
- [IMDb API: List top charts](https://fous.com/methods/imdb.com/list-top-charts.md): Lists titles in an IMDb movie or TV chart (Top 250 movies, Top 250 TV shows, most popular movies or TV shows) with ratings, votes, runtime, age rating and weekly rank movement for popularity charts. Popular charts contain up to 100 titles.
- [Kworb API: Get YouTube music chart](https://fous.com/methods/kworb.net/get-youtube-music-chart.md): Gets Kworb's latest YouTube music chart, worldwide or for one country, ordered by daily views. The worldwide chart covers the past 24 hours. Country charts report daily track streams.
- [Google API: List Google Play top charts](https://fous.com/methods/play.google.com/list-top-charts.md): Lists ranked Android apps or games from the Google Play top free, top paid or top grossing chart for a country and category.
- [Apple API: List top charts](https://fous.com/methods/music.apple.com/list-top-charts.md): Lists the current top songs, albums, or music videos on Apple Music for a country, in chart order. Countries without an Apple Music chart return no results.
- [Kworb API: Get Spotify daily chart](https://fous.com/methods/kworb.net/get-spotify-daily-chart.md): Returns the latest published Spotify daily Top 200 chart from Kworb for a country or worldwide, with rankings and stream counts.
- [All JustWatch methods](https://fous.com/methods/justwatch.com.md)