# 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 for Locus Pro. Each call burns credits from your workspace balance.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/credits/justwatch/`
**Auth:** `Authorization: Bearer <LOCUS_CREDITS_SECRET_KEY>` (an `lcr_` secret key or a scoped `lcac_` agent credential)
**Required header:** `Idempotency-Key: <fresh UUID per call>`. A retry with the same key replays the stored result without a new charge.
**Response:** the provider response after any endpoint-specific normalization. `X-Locus-Credits-Charged` carries the charge and `X-Locus-Credits-Balance` the remaining balance. Insufficient credits return `402` before the provider is called.
**Pricing:** estimated costs below are USD. Locus debits the credit equivalent at your workspace rate.

Full call contract: https://docs.paywithlocus.com/api-reference/introduction

> Using a Pay With Locus wallet key (`claw_` prefix)? Wallet routes are documented separately: https://docs.paywithlocus.com/wrapped-apis/for-agents

## 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/credits/justwatch/browse-popular-titles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/justwatch/get-similar-titles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/justwatch/get-title-details \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/justwatch/list-genres \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/justwatch/list-providers \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -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/credits/justwatch/search-titles \
  -H "Authorization: Bearer $LOCUS_CREDITS_SECRET_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"limit":"<integer>","query":"<string>"}'
```

## Next steps

- [All wrapped API providers](https://paywithlocus.com/wapi/index.md): pick another provider.
- [Find and call tools](https://paywithlocus.com/agent/tools.md): price ceilings, async results, and errors.
- [Credits and billing](https://paywithlocus.com/agent/billing.md): what a call costs and how to add credits.
- [Agent docs index](https://paywithlocus.com/agent/index.md): every Locus agent page.