> For the complete documentation index, see [llms.txt](https://knowledgebase.fabricdata.com/insights/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledgebase.fabricdata.com/insights/developer-tools/where-to-stream-widget.md).

# Where to Stream widget

Embeddable component that shows **which platforms** a movie or series is available on. Built for media and entertainment sites that want to answer the visitor's "where can I watch it?" question without taking them off the site.

> The interactive reference is still hosted at [fabric-data-it.github.io/Widget-Where-to-Stream](https://fabric-data-it.github.io/Widget-Where-to-Stream/).

### Integration

#### 1. Insert the container

Drop this `<div>` where you want the widget to appear:

```html
<div id="WhereToStream"
     wts-id=""
     wts-provider=""
     wts-type=""
     wts-country=""
     wts-tag="">
</div>
```

#### 2. Load the script

Before closing `</body>`:

```html
<script src="https://tools.insights.fabricdata.com/widgets/where_to_stream.js"></script>
```

#### Full example

```html
<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Streaming Widget Example</title>
  </head>
  <body>
    <div id="WhereToStream"
         wts-id="tt1520211"
         wts-provider="imdb"
         wts-type="series"
         wts-country="US"
         wts-tag="example-site">
    </div>

    <script src="https://tools.insights.fabricdata.com/widgets/where_to_stream.js"></script>
  </body>
</html>
```

### Parameters

| Attribute      | Description                                                                       |
| -------------- | --------------------------------------------------------------------------------- |
| `wts-id`       | Title ID according to the source chosen in `wts-provider`.                        |
| `wts-provider` | Source of the ID: `imdb`, `tmdb`, `tvdb`, `eidr`, `fabric`                        |
| `wts-type`     | Content type: `movie` or `series`.                                                |
| `wts-country`  | ISO 3166-1 alpha-2 country code (e.g., `US`, `AR`, `BR`, `MX`).                   |
| `wts-tag`      | Tracking tag provided by Fabric Data to identify the integrating site or partner. |

#### Supported providers

| Provider            | Code    | When to use it                                                                                                |
| ------------------- | ------- | ------------------------------------------------------------------------------------------------------------- |
| **IMDb**            | `imdb`  | IDs like `tt1234567`. The most common in media integrations.                                                  |
| **TMDB**            | `tmdb`  | Numeric IDs from The Movie Database.                                                                          |
| **TVDB**            | `tvdb`  | TheTVDB IDs (especially useful for series).                                                                   |
| **EIDR**            | `eidr`  | Standard identifier in the audiovisual industry.                                                              |
| **Fabric Insights** | `uid`   | Fabric Data Insights own identifier. Recommended if you've already integrated other Origin Insights families. |
| **Fabric Nexus**    | `nexus` | Fabric Data Nexus own identifier. Recommended if you've already integrated other Origin Nexus families.       |

#### Supported countries

Any ISO 3166-1 alpha-2 code (`AR`, `BR`, `MX`, `US`, `ES`, `FR`, `DE`, `IT`, `JP`, etc.). The full list is the universe covered by the Streaming Availability & Content Pulse family; for which countries are actively tracked, see Data coverage.

### Visual customization

The `<div>` attributes can be modified **in real time** from the reference page ([fabric-data-it.github.io/Widget-Where-to-Stream](https://fabric-data-it.github.io/Widget-Where-to-Stream/)) to preview the result before integrating. The **Customize** panel on the right lets you change `wts-id`, `wts-provider`, `wts-type`, `wts-country`, and `wts-tag` and see the widget update live.

The widget ships with a **Light** theme by default.

### How it works under the hood

The widget resolves the provided ID against the Origin Insights catalog (Streaming Availability & Content Pulse family) and returns the platforms currently available in the selected country, with their business model (SVOD / AVOD / TVOD / TVE / Free) and the deeplink to each one. It updates automatically at the catalog's cadence — see Frequency.

### Support

For integrations, errors, or tag requests: <ask@fabricdata.com>.

Formal tickets in the [Service Desk](https://fabric.atlassian.net/servicedesk/customer/portal/336) with the category *Developer Tools — Where to Stream*.
