providers/.docs/content/1.get-started/1.quick-start.md

Quick start

Installation

Let's get started with @movie-web/providers. First lets install the package.

::code-group

npm install @movie-web/providers

yarn add @movie-web/providers

pnpm install @movie-web/providers

::

Scrape your first item

To get started with scraping on the server, first you have to make an instance of the providers.

::alert{type="warning"} This snippet will only work on a server. For other environments, check out Usage on X. ::

import { makeProviders, makeStandardFetcher, targets } from '@movie-web/providers';

// this is how the library will make http requests
const myFetcher = makeStandardFetcher(fetch);

// make an instance of the providers library
const providers = makeProviders({
  fetcher: myFetcher,

  // will be played on a native video player
  target: targets.NATIVE
})

Perfect. You now have an instance of the providers you can reuse everywhere. Now let's scrape an item:

// fetch some data from TMDB
const media = {
  type: 'movie',
  title: "Hamilton",
  releaseYear: 2020,
  tmdbId: "556574"
}
  
const output = await providers.runAll({
  media: media
})

Now we have our stream in the output variable. (If the output is null then nothing could be found.) To find out how to use the streams, check out Using streams.