{"id":17939106,"url":"https://github.com/zoetrope69/letterboxd","last_synced_at":"2025-05-07T15:23:18.452Z","repository":{"id":37035715,"uuid":"61458863","full_name":"zoetrope69/letterboxd","owner":"zoetrope69","description":":movie_camera::clapper: get public diary data for letterboxd users","archived":false,"fork":false,"pushed_at":"2025-05-04T10:46:48.000Z","size":591,"stargazers_count":52,"open_issues_count":13,"forks_count":9,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-04T11:29:10.551Z","etag":null,"topics":["films","letterboxd","rss"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zoetrope69.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2016-06-19T01:02:29.000Z","updated_at":"2025-02-03T21:04:40.000Z","dependencies_parsed_at":"2023-10-14T22:45:31.471Z","dependency_job_id":"3df36877-fa76-49b2-96f8-e9f4a1359461","html_url":"https://github.com/zoetrope69/letterboxd","commit_stats":{"total_commits":140,"total_committers":9,"mean_commits":"15.555555555555555","dds":0.6714285714285715,"last_synced_commit":"1bced8dbb6ec659f03cfe1ac12e4633cbd80bd2f"},"previous_names":["zoetrope69/letterboxd","zactopus/letterboxd"],"tags_count":7,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoetrope69%2Fletterboxd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoetrope69%2Fletterboxd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoetrope69%2Fletterboxd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zoetrope69%2Fletterboxd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zoetrope69","download_url":"https://codeload.github.com/zoetrope69/letterboxd/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252903205,"owners_count":21822394,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["films","letterboxd","rss"],"created_at":"2024-10-29T00:06:43.467Z","updated_at":"2025-05-07T15:23:18.428Z","avatar_url":"https://github.com/zoetrope69.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# letterboxd\n\n[![npm](https://img.shields.io/npm/v/letterboxd.svg)](https://www.npmjs.com/package/letterboxd)\n\nget public data for letterboxd users\n\n_currently only consumes the RSS feeds from letterboxd, when API is released this will be used_\n\n## installation\n\n```bash\nnpm install letterboxd --save\n```\n\n## usage\n\n### function(username, [callback])\n\nReturns a promise if no callback is provided.\n\n```javascript\nimport letterboxd from \"letterboxd\";\n\nletterboxd(\"rubencordeiro\")\n  .then((items) =\u003e console.log(items))\n  .catch((error) =\u003e console.log(error));\n```\n\n#### output\n\noutput is an array of items.\n\nthere are two types of items: diary entries and lists.\n\n**due to the limitation of the data source (scraping a RSS feed), only the 20 most recent diary entries are returned**\n\nitems of note for the list type:\n\n- `ranked`: shows if it was set to ranked (1, 2, 3, 4).\n- `films`: films in the list, capped at 10\n- `totalFilms`: the total amount of films in the list, only 10 films are given here.\n\n```javascript\n[\n  {\n    type: \"diary\",\n    film: {\n      title: \"Zootopia\",\n      year: \"2016\",\n      image: { tiny: \"...\", small: \"...\", medium: \"...\", large: \"...\" },\n    },\n    rating: { text: \"★★★★\", score: 4 },\n    review: \"proper cute, funny and interesting through out. ...\",\n    spoilers: false,\n    isRewatch: false,\n    date: { watched: 1463702400000, published: 1463784779000 },\n    uri: \"https://letterboxd.com/zoetrope69/film/zootopia/\",\n  },\n  //...\n  {\n    type: \"list\",\n    date: {\n      published: 1473470608000,\n    },\n    title: \"All The Toy Stories\",\n    description: \"I fucking love these films lol\",\n    ranked: false,\n    films: [\n      { title: \"Toy Story\", uri: \"https://letterboxd.com/film/toy-story/\" },\n      { title: \"Toy Story 2\", uri: \"https://letterboxd.com/film/toy-story-2/\" },\n      { title: \"Toy Story 3\", uri: \"https://letterboxd.com/film/toy-story-3/\" },\n      {\n        title: \"Toy Story That Time Forgot\",\n        uri: \"https://letterboxd.com/film/toy-story-that-time-forgot/\",\n      },\n      {\n        title: \"Toy Story of Terror!\",\n        uri: \"https://letterboxd.com/film/toy-story-of-terror/\",\n      },\n    ],\n    totalFilms: 56,\n    uri: \"https://letterboxd.com/zoetrope69/list/tiff-2016/\",\n  },\n  //...\n];\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoetrope69%2Fletterboxd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzoetrope69%2Fletterboxd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzoetrope69%2Fletterboxd/lists"}