---
title: "Analyze JustWatch title availability"
method: GET
path: "/justwatch/title/analysis"
tags: ["JustWatch"]
---

# Analyze JustWatch title availability

`GET /justwatch/title/analysis`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/justwatch/title/analysis`
- Auth: API key in header `x-api-key`

Fetches a JustWatch title page and summarizes provider availability, monetization buckets, formats, price ranges, and best rent/buy/free/subscription options. Pass exactly one of `path` or `url`.

## Query parameters

- `path` string
- `url` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- JustwatchAnalysisResponseDoc
  - `code` integer
  - `data` JustwatchAnalysisResponse
    - `summary` JustwatchAnalysisSummary
      - `available` boolean: Whether the title has at least one offer.
      - `best_buy` JustwatchOffer
        - `availability` string: Availability of the offer as a schema.org URL, for example `https://schema.org/InStock`.
        - `category` string: Format label shown for the offer, for example `Blu-Ray`.
        - `currency` string: Currency of `price`, as an ISO 4217 code such as `USD`.
        - `monetization_type` string: How the title is offered: `FLATRATE`, `FREE`, `ADS`, `RENT` or `BUY`.
        - `presentation_type` string: Picture format of the offer, for example `HD` or `4K`.
        - `price` number: Price of the offer in `currency`. Omitted for free and subscription offers without a price.
        - `provider` string: Name of the provider offering the title, for example `Amazon Video`.
        - `provider_id` integer: JustWatch id of the provider.
        - `provider_short` string: Short provider code, for example `amz`.
        - `provider_technical` string: Technical provider name used by JustWatch, for example `amazon`.
        - `url` string: Link to watch or buy the title at the provider.
      - `best_free` JustwatchOffer
        - `availability` string: Availability of the offer as a schema.org URL, for example `https://schema.org/InStock`.
        - `category` string: Format label shown for the offer, for example `Blu-Ray`.
        - `currency` string: Currency of `price`, as an ISO 4217 code such as `USD`.
        - `monetization_type` string: How the title is offered: `FLATRATE`, `FREE`, `ADS`, `RENT` or `BUY`.
        - `presentation_type` string: Picture format of the offer, for example `HD` or `4K`.
        - `price` number: Price of the offer in `currency`. Omitted for free and subscription offers without a price.
        - `provider` string: Name of the provider offering the title, for example `Amazon Video`.
        - `provider_id` integer: JustWatch id of the provider.
        - `provider_short` string: Short provider code, for example `amz`.
        - `provider_technical` string: Technical provider name used by JustWatch, for example `amazon`.
        - `url` string: Link to watch or buy the title at the provider.
      - `best_rent` JustwatchOffer
        - `availability` string: Availability of the offer as a schema.org URL, for example `https://schema.org/InStock`.
        - `category` string: Format label shown for the offer, for example `Blu-Ray`.
        - `currency` string: Currency of `price`, as an ISO 4217 code such as `USD`.
        - `monetization_type` string: How the title is offered: `FLATRATE`, `FREE`, `ADS`, `RENT` or `BUY`.
        - `presentation_type` string: Picture format of the offer, for example `HD` or `4K`.
        - `price` number: Price of the offer in `currency`. Omitted for free and subscription offers without a price.
        - `provider` string: Name of the provider offering the title, for example `Amazon Video`.
        - `provider_id` integer: JustWatch id of the provider.
        - `provider_short` string: Short provider code, for example `amz`.
        - `provider_technical` string: Technical provider name used by JustWatch, for example `amazon`.
        - `url` string: Link to watch or buy the title at the provider.
      - `best_subscription` JustwatchOffer
        - `availability` string: Availability of the offer as a schema.org URL, for example `https://schema.org/InStock`.
        - `category` string: Format label shown for the offer, for example `Blu-Ray`.
        - `currency` string: Currency of `price`, as an ISO 4217 code such as `USD`.
        - `monetization_type` string: How the title is offered: `FLATRATE`, `FREE`, `ADS`, `RENT` or `BUY`.
        - `presentation_type` string: Picture format of the offer, for example `HD` or `4K`.
        - `price` number: Price of the offer in `currency`. Omitted for free and subscription offers without a price.
        - `provider` string: Name of the provider offering the title, for example `Amazon Video`.
        - `provider_id` integer: JustWatch id of the provider.
        - `provider_short` string: Short provider code, for example `amz`.
        - `provider_technical` string: Technical provider name used by JustWatch, for example `amazon`.
        - `url` string: Link to watch or buy the title at the provider.
      - `format_counts` object: Number of offers per picture format, keyed by format such as `HD` or `4K`.
      - `monetization_counts` object: Number of offers per monetization type, keyed by type such as `RENT` or `BUY`.
      - `price_ranges` object: Lowest and highest price per monetization type, keyed by type. Only offers with a price are counted.
      - `provider_count` integer: Number of distinct providers that carry the title.
      - `total_offers` integer: Total number of offers found for the title.
    - `title` JustwatchTitleResponse
      - `content_rating` string: Age or content rating shown for the title.
      - `description` string: Synopsis of the title.
      - `genres` string[]: Genre names of the title.
      - `id` string: JustWatch title id, for example `tm92641` for a movie.
      - `object_id` integer: Numeric JustWatch id of the title.
      - `object_type` string: JustWatch object type of the title, for example `MOVIE` or `SHOW`.
      - `offers` JustwatchOffer[]: Streaming, rental and purchase offers for the title.
        - `availability` string: Availability of the offer as a schema.org URL, for example `https://schema.org/InStock`.
        - `category` string: Format label shown for the offer, for example `Blu-Ray`.
        - `currency` string: Currency of `price`, as an ISO 4217 code such as `USD`.
        - `monetization_type` string: How the title is offered: `FLATRATE`, `FREE`, `ADS`, `RENT` or `BUY`.
        - `presentation_type` string: Picture format of the offer, for example `HD` or `4K`.
        - `price` number: Price of the offer in `currency`. Omitted for free and subscription offers without a price.
        - `provider` string: Name of the provider offering the title, for example `Amazon Video`.
        - `provider_id` integer: JustWatch id of the provider.
        - `provider_short` string: Short provider code, for example `amz`.
        - `provider_technical` string: Technical provider name used by JustWatch, for example `amazon`.
        - `url` string: Link to watch or buy the title at the provider.
      - `path` string: JustWatch page path of the title, for example `/us/movie/inception`.
      - `poster_url` string: URL of the poster image for the title.
      - `release_date` string: Release date of the title, for example `2010-07-14`.
      - `runtime` string: Running time as an ISO 8601 duration, for example `PT2H28M0S`.
      - `scoring` JustwatchScoring
        - `best_rating` string: Top of the scale for `justwatch_rating`, for example `100`.
        - `certified_fresh` boolean: Whether the title carries the Rotten Tomatoes Certified Fresh badge.
        - `imdb_score` number: IMDb user rating out of 10.
        - `imdb_votes` integer: Number of IMDb votes behind `imdb_score`.
        - `justwatch_rating` number: JustWatch user rating, on the scale given by `best_rating`.
        - `rating_count` integer: Number of ratings behind `justwatch_rating`.
        - `tmdb_popularity` number: TMDB popularity score for the title.
        - `tmdb_score` number: TMDB user rating for the title.
        - `tomato_meter` integer: Rotten Tomatoes Tomatometer score, as a percentage.
      - `title` string: Name of the title in the requested language.
      - `url` string: Full JustWatch page URL of the title.
      - `year` integer: Release year of the title.
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)
