Skip to content

Paylicier/tmdb2boxd

Folders and files

NameName
Last commit message
Last commit date

Latest commit

2325420Β Β·Β Β· Mar 8, 2026

History

11 Commits
Mar 8, 2026
Dec 21, 2025
Dec 21, 2025
Feb 23, 2026
Dec 21, 2025
Dec 21, 2025
Dec 21, 2025
Dec 21, 2025

Repository files navigation


Warning

This project is not affiliated with, endorsed by, or sponsored by Letterboxd or The Movie Database (TMDB). All movie data, metadata, and related content are the property of their respective owners.

  • Letterboxd is a trademark of Letterboxd Limited.
  • TMDB data is provided under their Terms of Use.

This tool is provided for educational and personal use only. Please respect the terms of service of both platforms when using this API.


TMDB2BOXD Logo

TMDB2BOXD

A Cloudflare Worker to get the Letterboxd ID of a movie from its TMDB ID

Cloudflare Workers TypeScript License

API Usage

Endpoint

GET /tmdb/:id

Parameters

Parameter Type Description
id number The TMDB movie ID

Response

Success (200)

{
   "letterboxdId": "2a1m",
   "title": "The Matrix (1999)",
   "description": "Set in the 22nd century, The Matrix tells the story of a computer hacker who joins a group of underground insurgents fighting the vast and powerful computers who now rule the earth.",
   "url": "https://letterboxd.com/film/the-matrix/",
   "tmdbId": "603"
}}

Not Found (404)

{
   "error": "Movie not found on Letterboxd",
   "tmdbId": "123456789"
}}

Example

curl https://boxd.notri1.fr/tmdb/603

Setup

Prerequisites

Installation

  1. Clone the repository

    git clone https://github.com/Paylicier/tmdb2boxd.git
    
    cd tmdb2boxd
  2. Install dependencies

    bun install
  3. Run locally

    bun run dev
  4. Deploy to Cloudflare

    bun run deploy

Contributing 🀝

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Commit your changes (git commit -m 'Add some AmazingFeature')
  4. Push to the branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

License πŸ“„

This project is available under MIT

Please read the license carefully before using this software. If you have any questions about licensing, please open an issue.


Built with ❀️ and πŸ§‘β€πŸ³ by Paul

About

Cloudflare worker to get letterboxd id of a movie from its tmdb id

Resources

License

Stars

Watchers

Forks