{ "openapi": "3.0.1", "info": { "title": "Letterboxd Scraper", "description": "Extract films, reviews, and watch history from Letterboxd. Get titles, directors, cast, genres, ratings, and full user reviews. Search by keyword or paste film, member, or list URLs. Films and reviews returned as separate rows.", "version": "1.0", "x-build-id": "Bj4rk581oCQMoiWF4" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/solidcode~letterboxd-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-solidcode-letterboxd-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/solidcode~letterboxd-scraper/runs": { "post": { "operationId": "runs-sync-solidcode-letterboxd-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/solidcode~letterboxd-scraper/run-sync": { "post": { "operationId": "run-sync-solidcode-letterboxd-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "startUrls": { "title": "Letterboxd URLs", "type": "array", "description": "Paste one or more Letterboxd URLs. Accepts film pages (e.g. https://letterboxd.com/film/parasite-2019/), member profiles (e.g. https://letterboxd.com/username/), and curated list pages (e.g. https://letterboxd.com/username/list/my-favourites/). Leave blank to use the search box below.", "items": { "type": "string" } }, "searchTerms": { "title": "Search Terms", "type": "array", "description": "Film titles or keywords to search for on Letterboxd (e.g. 'parasite', 'stanley kubrick', 'neon noir'). Each term is searched and the matching films are collected. Ignored for rows where you supply URLs above. Each search term returns up to about 20 films (Letterboxd shows one page of search results) — to pull larger sets, paste member or list URLs into Letterboxd URLs above instead.", "items": { "type": "string" } }, "includeReviews": { "title": "Include Reviews", "type": "boolean", "description": "Collect user reviews for each film, returned as their own rows (reviewer, star rating, full text, spoiler flag, date). Each review is billed as a separate result. Turn off for a faster, cheaper run that returns only film metadata.", "default": true }, "maxReviewsPerFilm": { "title": "Max Reviews Per Film", "minimum": 0, "type": "integer", "description": "Cap on the number of reviews captured per film (most popular first). Default is 20. Set to 0 to collect as many reviews as possible per film. Very popular films can have hundreds of thousands of reviews; for those, collection stops after a generous limit to keep runs efficient — set a specific number to control exactly how many you get. Each review is returned as its own result. Ignored when 'Include Reviews' is off.", "default": 20 }, "maxResults": { "title": "Max Films", "minimum": 0, "type": "integer", "description": "Cap on the total number of films collected across all URLs and search terms. Default 50 — increase for bigger runs, or set to 0 for no cap (collects every film found). Reviews collected for these films do not count against this cap.", "default": 50 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }