Letterboxd Scraper

A NPM module that will allow you to retrieve information from the Letterboxd website.

If you don't have any development knowledge, it is recommended to join the Discord support server to get help.

⚠️ Project under construction

Follow the progress on the Discord server.

Any bug issue should be reported. Any suggestions for improvement or new features are appreciated.

🧩 An easy to use module

Some examples with all features are available on GitHub.

| Feature | Requested | Details | | ------|-----|-----| | searchMovie | Name of a movie | Search a movie | | searchUser | Name of a Letterboxd user | Search a Letterboxd user | | searchPodcast | Name of a podcast | Find a podcast | | searchList | Name of a Letterboxd list | Find a Letterboxd list | | getMovie | Name of a movie / Letterboxd movie URL | More information on a movie | | getProfile | Name of a Letterboxd user | More information on a Letterboxd user |

📌 Examples

Search for a movie :

const scraper = require('letterboxd-scraper');

scraper.searchMovie('The Basketball')
    .then((items) => console.log(items))
    .catch((error) => console.log(error));

Response :

[
  {
    id: 163198,
    url: 'https://letterboxd.com/film/the-land-of-basketball-1995-2005/',
    name: 'The Land of Basketball 1995-2005',
    date: '2008',
    text: 'Original title: Zemlja košarke 1995-2005  Alternative title: Zemlja kosarke',
    directed: [],
    image: { width: '70', height: '105' }
  },
  {
    id: 557093,
    url: 'https://letterboxd.com/film/basketball-water-and-the-lost-city-of-elbowoods/',
    name: 'Basketball, Water and the Lost City of Elbowoods',
    date: '2019',
    text: null,
    directed: [],
    image: { width: '70', height: '105' }
  },
  {
    id: 706715,
    url: 'https://letterboxd.com/film/something-in-the-water-a-kinston-basketball-story/',
    name: 'Something In The Water: A Kinston Basketball Story',
    date: '2020',
    text: null,
    directed: [ 'Marcus Mizelle' ],
    image: { width: '70', height: '105' }
  }
]

Get a movie :

const scraper = require('letterboxd-scraper');

//With URL
scraper.getMovie('https://letterboxd.com/film/the-basketball-diaries')
    .then((items) => console.log(items))
    .catch((error) => console.log(error));

//With name
scraper.getMovie('The Basketball Diaries')
    .then((items) => console.log(items))
    .catch((error) => console.log(error));

Response :

{
  name: 'The Basketball Diaries',
  date: '1995',
  trailer: 'https://www.youtube.com/embed/W5eVnwe6Pxs?rel=0&wmode=transparent',
  description: {
    synopsis: 'The true story of the death of innocence and the birth of an artist.',
    summary: "Film adaptation of street tough Jim Carroll's epistle about his kaleidoscopic free fall into the harrowing world of drug addiction."
  }
}

Realized with ❤️ by ZerioDev, follow me on Letterboxd.