[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_166":167,"_168":169},"routes/_app.x.$handle.$name",{"_93":92,"_32":44,"_101":83,"_27":102,"_13":14,"_103":-5,"_11":104,"_105":106,"_107":108,"_109":110,"_111":112,"_20":-5,"_113":-5,"_114":-5,"_115":25,"_116":117,"_118":119,"_120":-5,"_121":-5,"_122":123},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_42":43,"_32":44,"_37":45,"_46":-5,"_47":25,"_48":49,"_50":49,"_51":-5,"_52":-5,"_18":53,"_54":-5,"_55":25,"_56":-5,"_57":-5,"_58":59,"_60":61,"_62":-5,"_63":-5,"_64":-5,"_65":-5,"_66":67,"_68":67,"_69":70,"_71":70,"_72":70,"_73":67,"_74":67,"_75":76,"_77":78,"_79":80,"_81":25},"version",26,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":20,"_34":36,"_37":38,"_39":14,"_40":41,"_24":25},"previous",{"_30":31,"_32":28,"_33":20,"_34":35},"deleted",false,"deletedHere","path","README.md","latestPath","fileId","1cf21222-f25a-11f0-9c5a-42dde27851f2","name","fileType","content","# Letterboxd Diary API\n\nA simple API to fetch the most recent diary entry from a Letterboxd user's diary page.\n\n## Overview\n\nThis API scrapes the Letterboxd diary page for user \"pinjasaur\" and returns the most recent film entry in a clean JSON format. Perfect for displaying your latest watched movie on a personal website or blog.\n\n## API Endpoint\n\n**GET** `/`\n\nReturns the most recent diary entry as JSON.\n\n## Response Format\n\n```json\n{\n \"title\": \"The Naked Gun: From the Files of Police Squad!\",\n \"year\": 1988,\n \"rating\": 4,\n \"watchDate\": \"2026-01-13\",\n \"posterUrl\": \"https://your-val-town-url.web.val.run/poster?url=https%3A//letterboxd.com/film/the-naked-gun-from-the-files-of-police-squad/image-300/\",\n \"filmUrl\": \"https://letterboxd.com/pinjasaur/film/the-naked-gun-from-the-files-of-police-squad/\",\n \"scrapedAt\": \"2026-01-15T21:35:08.392Z\"\n}\n```\n\n### Fields\n\n- **title**: Film title (string | null)\n- **year**: Release year (number | null)\n- **rating**: Star rating from 0.5 to 5 stars (number | null)\n- **watchDate**: Date watched in YYYY-MM-DD format (string | null)\n- **posterUrl**: High-resolution poster image URL (string | null)\n- **filmUrl**: Link to the film's Letterboxd page (string | null)\n- **scrapedAt**: ISO timestamp of when the data was scraped (string)\n\n## Usage Examples\n\n### JavaScript/Fetch\n```javascript\nfetch('https://your-val-town-url.web.val.run/')\n .then(response => response.json())\n .then(data => {\n console.log(`Latest watched: ${data.title} (${data.year})`);\n console.log(`Rating: ${data.rating}/5 stars`);\n });\n```\n\n### HTML Integration\n```html\n

\n\n\n```\n\n## Caching\n\nThe API includes caching headers:\n- **Cache-Control**: `public, max-age=300` (5 minutes)\n- **CORS**: Enabled for all origins\n\n## Error Handling\n\nThe API returns appropriate HTTP status codes:\n\n- **200**: Success\n- **404**: No diary entries found\n- **500**: Server error (network issues, parsing errors, etc.)\n\nError responses include a descriptive message:\n\n```json\n{\n \"error\": \"No diary entries found\",\n \"message\": \"The diary appears to be empty or the page structure has changed.\"\n}\n```\n\n## Technical Details\n\n- Built with TypeScript on Val Town\n- Scrapes HTML from `https://letterboxd.com/pinjasaur/diary/`\n- Uses regex patterns to extract structured data\n- Handles various edge cases and fallbacks\n- Returns high-resolution poster images (300px width)\n\n## Limitations\n\n- Only works for public Letterboxd profiles\n- Currently hardcoded to user \"pinjasaur\"\n- Dependent on Letterboxd's HTML structure (may break if they change their layout)\n- Rate limited by Letterboxd's servers\n- No authentication or private diary support\n\n## Future Enhancements\n\nPotential improvements could include:\n- Support for multiple users via query parameters\n- Pagination to get multiple recent entries\n- Additional metadata extraction (genres, director, etc.)\n- Webhook support for real-time updates\n- Better error handling and retry logic","createdAt",["D",1768513854209],"branchVersion","branchId","e6e8c96e-eb5b-11f0-8eee-42dde27851f2","id","e6e86834-eb5b-11f0-8eee-42dde27851f2","letterboxd",["D",1767744039700],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","imageUrl","41e8ffac-7579-4d28-8abc-9ea3fbbfbe3d","pinnedFileId","pinPreview","pinMigrated","screenshotVersion","likeCount",0,"orgId","df0d4168-ae66-42fa-a2b7-794c074a0595","tursoName","tursoHostname","tursoMeasuredAt","pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_93":92,"_100":96},"org",{"_93":92,"_94":-5,"_95":96,"_18":53,"_97":98,"_99":25},"branch",{"_13":82,"_32":83,"_42":41,"_84":43,"_85":-5,"_86":-5,"_87":-5,"_88":-5,"_89":-5,"_90":44,"_91":92},"isOwned",51,"main","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","pinjasaur","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoiZGVmYXVsdCIsImlpZCI6Imluc18yTm10cGhQUklwU0tqZHNiOHNnNGd2ZjJURFUiLCJyaWQiOiJ1c2VyXzJqVWJWeUNGZ2tVNzFGVzhOTnY2bWNOQnVGaSJ9","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_42":43,"_32":44,"_37":162,"_46":-5,"_47":25,"_48":49,"_50":49,"_51":-5,"_52":-5,"_18":53,"_54":-5,"_55":25,"_56":-5,"_57":-5,"_58":59,"_60":61,"_62":-5,"_63":-5,"_64":-5,"_65":-5,"_66":67,"_68":67,"_69":70,"_71":70,"_72":70,"_73":67,"_74":67,"_75":163,"_77":164,"_79":165,"_81":25},"tree",[153,154],"files",[153,154],"counts",{"_142":59,"_143":144,"_145":59,"_146":147,"_148":149},"contents",[124,125],"upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles",true,"grants","orgs","customDomains",{},{"_42":138,"_32":28,"_30":31,"_129":-5,"_40":41,"_39":14,"_131":25,"_37":139,"_13":140,"_33":20,"_34":36,"_24":25,"_136":-5,"_27":141},{"_42":126,"_32":127,"_30":128,"_129":-5,"_40":41,"_39":130,"_131":25,"_37":132,"_13":133,"_33":134,"_34":135,"_24":25,"_136":-5,"_27":137},"3d5ecd32-f25c-11f0-8f23-42dde27851f2","index.ts","0bab8bba-f25a-11f0-aa11-42dde27851f2","parentId",24,"latest",["D",1768513842896],5,"http","// Letterboxd Diary API - Get most recent diary entry for pinjasaur\n// Usage: GET / returns the most recent diary entry as JSON\n\ninterface DiaryEntry {\n title: string | null;\n year: number | null;\n rating: number | null; // 0.5 to 5 stars\n watchDate: string | null; // YYYY-MM-DD format\n posterUrl: string | null;\n filmUrl: string | null;\n scrapedAt: string;\n}\n\n// Proxy function to serve Letterboxd poster images\nasync function handlePosterProxy(posterUrl: string): Promise {\n try {\n const response = await fetch(posterUrl, {\n headers: {\n 'User-Agent': 'Mozilla/5.0 (compatible; LetterboxdAPI/1.0)',\n 'Referer': 'https://letterboxd.com/'\n }\n });\n \n if (!response.ok) {\n throw new Error(`Failed to fetch poster: ${response.status}`);\n }\n \n const imageBuffer = await response.arrayBuffer();\n const contentType = response.headers.get('content-type') || 'image/jpeg';\n \n return new Response(imageBuffer, {\n headers: {\n 'Content-Type': contentType,\n 'Cache-Control': 'public, max-age=86400', // Cache for 24 hours\n 'Access-Control-Allow-Origin': '*'\n }\n });\n } catch (error) {\n console.error('Error proxying poster:', error);\n return new Response('Image not found', { status: 404 });\n }\n}\n\nexport default async function(req: Request): Promise {\n const url = new URL(req.url);\n \n // Handle poster proxy requests\n if (url.pathname === '/poster' && url.searchParams.has('url')) {\n return handlePosterProxy(url.searchParams.get('url')!);\n }\n \n try {\n // Fetch the diary page\n const response = await fetch('https://letterboxd.com/pinjasaur/diary/', {\n headers: {\n 'User-Agent': 'Mozilla/5.0 (compatible; LetterboxdAPI/1.0)'\n }\n });\n \n if (!response.ok) {\n throw new Error(`Failed to fetch diary: ${response.status} ${response.statusText}`);\n }\n \n const html = await response.text();\n \n // Extract diary entry rows\n const diaryEntryRegex = /]*class=\"[^\"]*diary-entry-row[^\"]*\"[^>]*>(.*?)<\\/tr>/gs;\n const matches = [...html.matchAll(diaryEntryRegex)];\n \n if (matches.length === 0) {\n return new Response(JSON.stringify({\n error: 'No diary entries found',\n message: 'The diary appears to be empty or the page structure has changed.'\n }), {\n status: 404,\n headers: { \n 'Content-Type': 'application/json',\n 'Cache-Control': 'public, max-age=300' // Cache for 5 minutes\n }\n });\n }\n \n // Parse the first (most recent) diary entry\n const mostRecentEntryHtml = matches[0][1];\n \n // Extract film title\n const titleMatch = mostRecentEntryHtml.match(/]*class=\"[^\"]*name[^\"]*\"[^>]*>.*?]*href=\"[^\"]*\"[^>]*>(.*?)<\\/a>/s) ||\n mostRecentEntryHtml.match(/]*href=\"\\/[^\\/]*\\/film\\/[^\"]*\"[^>]*>(.*?)<\\/a>/s) ||\n mostRecentEntryHtml.match(/data-item-name=\"([^\"]*) \$\\d{4}\$\"/);\n const title = titleMatch ? titleMatch[1].replace(/<[^>]*>/g, '').trim() : null;\n \n // Extract film year\n const yearMatch = mostRecentEntryHtml.match(/\$(\\d{4})\$/) ||\n mostRecentEntryHtml.match(/]*class=\"[^\"]*metadata[^\"]*\"[^>]*>.*?(\\d{4})/s);\n const year = yearMatch ? parseInt(yearMatch[1]) : null;\n \n // Extract rating (stars) - Letterboxd uses rated-X classes where X is the number of half-stars\n const ratingMatch = mostRecentEntryHtml.match(/class=\"[^\"]*rating[^\"]*\"[^>]*>.*?rated-(\\d+)/s) ||\n mostRecentEntryHtml.match(/rated-(\\d+)/);\n const rating = ratingMatch ? parseInt(ratingMatch[1]) / 2 : null; // Convert half-stars to stars\n \n // Extract poster image\n const posterMatch = mostRecentEntryHtml.match(/data-poster-url=\"([^\"]*)\"/) ||\n mostRecentEntryHtml.match(/]*src=\"([^\"]*)\"[^>]*alt=\"[^\"]*\"[^>]*class=\"[^\"]*image[^\"]*\"/) ||\n mostRecentEntryHtml.match(/]*class=\"[^\"]*image[^\"]*\"[^>]*src=\"([^\"]*)\"/);\n let posterUrl = posterMatch ? posterMatch[1] : null;\n \n // Convert relative URLs to absolute and get higher resolution\n if (posterUrl && posterUrl.startsWith('/')) {\n posterUrl = `https://letterboxd.com${posterUrl}`;\n }\n // Replace small poster with larger version if possible\n if (posterUrl && posterUrl.includes('image-150')) {\n posterUrl = posterUrl.replace('image-150', 'image-300');\n }\n \n // Create proxied poster URL to avoid CORS issues\n const proxiedPosterUrl = posterUrl ? `${new URL(req.url).origin}/poster?url=${encodeURIComponent(posterUrl)}` : null;\n \n // Extract watch date with better formatting\n const dateMatch = mostRecentEntryHtml.match(/]*class=\"[^\"]*col-daydate[^\"]*\"[^>]*>.*?]*href=\"[^\"]*\\/(\\d{4})\\/(\\d{2})\\/(\\d{2})\\/\"[^>]*>(\\d+)<\\/a>/s) ||\n mostRecentEntryHtml.match(/]*href=\"[^\"]*\\/diary\\/films\\/for\\/(\\d{4})\\/(\\d{2})\\/(\\d{2})\\/\"[^>]*>(\\d+)<\\/a>/s);\n let watchDate = null;\n if (dateMatch) {\n const [, year, month, day] = dateMatch;\n watchDate = `${year}-${month}-${day.padStart(2, '0')}`;\n } else {\n // Fallback to just the day number\n const dayMatch = mostRecentEntryHtml.match(/]*class=\"[^\"]*col-daydate[^\"]*\"[^>]*>.*?]*>(\\d+)<\\/a>/s);\n watchDate = dayMatch ? dayMatch[1] : null;\n }\n \n // Extract film URL for more details\n const filmUrlMatch = mostRecentEntryHtml.match(/]*href=\"(\\/[^\\/]*\\/film\\/[^\"]*)\"/) ||\n mostRecentEntryHtml.match(/data-item-link=\"([^\"]*)\"/);\n const filmUrl = filmUrlMatch ? `https://letterboxd.com${filmUrlMatch[1]}` : null;\n \n const entry: DiaryEntry = {\n title,\n year,\n rating,\n watchDate,\n posterUrl: proxiedPosterUrl,\n filmUrl,\n scrapedAt: new Date().toISOString()\n };\n \n return new Response(JSON.stringify(entry, null, 2), {\n headers: { \n 'Content-Type': 'application/json',\n 'Cache-Control': 'public, max-age=300', // Cache for 5 minutes\n 'Access-Control-Allow-Origin': '*' // Allow CORS for your website\n }\n });\n \n } catch (error) {\n console.error('Error fetching diary:', error);\n return new Response(JSON.stringify({ \n error: 'Failed to fetch diary',\n message: error instanceof Error ? error.message : 'Unknown error occurred'\n }), {\n status: 500,\n headers: { \n 'Content-Type': 'application/json',\n 'Cache-Control': 'no-cache'\n }\n });\n }\n}","label",[127],"441dbc28-f25c-11f0-bcaf-42dde27851f2",["D",1768513854209],2,[28],"pulls","branches",1,"forks","envVars",{"_150":59,"_152":59},"connections",{"_150":59,"_151":59},"count","unfilledCount","emptyCount",{"_42":138,"_32":28,"_30":31,"_129":-5,"_40":41,"_39":14,"_131":25,"_37":159,"_13":140,"_33":20,"_34":36,"_24":25,"_136":-5,"_156":160,"_27":161},{"_42":126,"_32":127,"_30":128,"_129":-5,"_40":41,"_39":130,"_131":25,"_37":155,"_13":133,"_33":134,"_34":135,"_24":25,"_136":-5,"_156":157,"_27":158},["D",1768513842896],"children",[],[127],["D",1768513854209],[],[28],["D",1767744039700],{"_93":92,"_100":96},{"_93":92,"_94":-5,"_95":96,"_18":53,"_97":98,"_99":25},{"_13":82,"_32":83,"_42":41,"_84":43,"_85":-5,"_86":-5,"_87":-5,"_88":-5,"_89":-5,"_90":44,"_91":92},"ctx",{"_75":-5,"_121":199,"_200":201,"_202":203,"_204":25,"_205":25,"_206":25,"_207":119,"_208":-5,"_209":-7,"_210":-7,"_211":59,"_212":25,"_213":25,"_214":-5,"_215":25,"_216":25,"_217":25,"_218":-5},"ENV",{"_170":171,"_172":173,"_174":83,"_175":176,"_177":178,"_179":180,"_181":182,"_183":184,"_185":186,"_187":188,"_189":190,"_191":192,"_193":194,"_195":196,"_197":198},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

Diff · v26