# Justwatch — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Search for movies and TV shows, retrieve streaming availability and detailed metadata, browse trending content, and discover similar titles — all via JustWatch.

**Category:** Entertainment | **Website:** [justwatch.com/](https://justwatch.com/) | **Docs:** [parse.bot/marketplace/96a6e980-01b5-438e-90fb-77fbf4874001/justwatch-com-api](https://parse.bot/marketplace/96a6e980-01b5-438e-90fb-77fbf4874001/justwatch-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-justwatch-com-api-96a6e980/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### browse_popular_titles

Browse currently trending movies and TV shows in India, sorted by trending popularity. Returns lightweight title summaries without streaming offers. Use get_title_details with a result's path for full information.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Number of titles to return. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-justwatch-com-api-96a6e980/browse_popular_titles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>"}'
```

### get_similar_titles

Get content recommendations similar to a given movie or TV show. Returns related titles based on JustWatch's similarity algorithm. The reference title is specified by slug (obtainable from search_titles or browse_popular_titles results path field).

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of similar titles to return. |
| `slug` | string | Yes | The slug/path of the reference title (e.g. 'movie/inception'). Obtainable from search_titles results items[*].path. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-justwatch-com-api-96a6e980/get_similar_titles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","slug":"<string>"}'
```

### get_title_details

Retrieve comprehensive details for a single movie or TV show by its slug path. Returns scores (IMDB, TMDB, Rotten Tomatoes), cast credits, genre list, runtime, age rating, production countries, and all streaming offers with provider, monetization type, quality tier, and price. The slug is obtainable from search_titles or browse_popular_titles results path field.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `slug` | string | Yes | The slug or path of the title (e.g. 'movie/jaws' or '/in/movie/jaws'). Obtainable from search_titles results items[*].path. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-justwatch-com-api-96a6e980/get_title_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug":"<string>"}'
```

### list_genres

List all content genres available for filtering on JustWatch. Returns genre IDs, short codes, and translated display names.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-justwatch-com-api-96a6e980/list_genres \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### list_providers

List all streaming providers available in India with their identifiers and display names. Useful for mapping provider names in offer data to canonical provider records.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-justwatch-com-api-96a6e980/list_providers \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_titles

Full-text search for movies and TV shows by title. Returns matching titles with basic streaming availability (first flatrate or first available offer). Results are server-ranked by relevance to the query.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `limit` | integer | No | Maximum number of results to return. |
| `query` | string | Yes | The search query for title name. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-justwatch-com-api-96a6e980/search_titles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```