{ "openapi": "3.0.1", "info": { "title": "Letterboxd Film & Reviews Scraper", "description": "Collect public Letterboxd film metadata, ratings, and optional reviews, or read public profiles, watched films, and lists. Choose a source, save structured rows, and export the data from your Apify dataset.", "version": "0.0", "x-build-id": "Gac3dbNaLLWmO1Npw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~letterboxd/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-letterboxd", "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/maximedupre~letterboxd/runs": { "post": { "operationId": "runs-sync-maximedupre-letterboxd", "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/maximedupre~letterboxd/run-sync": { "post": { "operationId": "run-sync-maximedupre-letterboxd", "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", "required": [ "target" ], "properties": { "target": { "title": "Target", "enum": [ "films", "search", "list", "popular", "profile", "watched" ], "type": "string", "description": "Choose one source. Fields for other targets stay visible and are ignored." }, "filmUrlsOrIds": { "title": "Film URLs or IDs", "minItems": 1, "type": "array", "description": "Enter one or more public Letterboxd film URLs or film identifiers. Each entry is one film. Required when Target is Films.", "items": { "type": "string", "minLength": 1 } }, "searchQuery": { "title": "Search query", "minLength": 1, "type": "string", "description": "Enter one film-related search, such as a title, director, cast member, or keyword. Run each different search separately. Required when Target is Film search." }, "listUrlOrId": { "title": "List URL or ID", "minLength": 1, "type": "string", "description": "Enter one public Letterboxd list URL or list identifier. Required when Target is Public list." }, "browseMode": { "title": "Browse type", "enum": [ "popular" ], "type": "string", "description": "Browse popular films. Required when Target is Popular films." }, "browsePeriod": { "title": "Browse period", "enum": [ "day", "week", "month", "year", "all-time" ], "type": "string", "description": "Choose the period for popular films. Required when Target is Popular films." }, "genre": { "title": "Genre", "minLength": 1, "type": "string", "description": "Optionally filter Popular films by a Letterboxd genre name, such as Drama. Leave it empty for all genres." }, "profileUrlOrUsername": { "title": "Profile URL or username", "minLength": 1, "type": "string", "description": "Enter one public Letterboxd profile URL or username. Required when Target is Public profile or Watched films." }, "includeReviews": { "title": "Include reviews", "type": "boolean", "description": "Collect public film reviews with film results. Used by Films, Film search, Public list, and Popular films. Leave it off for film data only.", "default": false }, "reviewOrder": { "title": "Review order", "enum": [ "popular", "recent", "earliest", "highest-rated", "lowest-rated" ], "type": "string", "description": "Choose the order for collected reviews. Used only when Include reviews is on.", "default": "popular" }, "completeReviewText": { "title": "Complete review text", "type": "boolean", "description": "Get complete review text when Letterboxd provides only a shortened preview. Used only when Include reviews is on.", "default": false }, "maxItems": { "title": "Maximum items", "minimum": 1, "type": "integer", "description": "Optionally stop after this many output items for Film search, Public list, Popular films, Public profile, or Watched films. Leave it empty to collect all available results until the source is exhausted." } } }, "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 } } } } } } } } } }