{ "openapi": "3.0.1", "info": { "title": "Rotten Tomatoes Scraper - Movie & TV Ratings", "description": "Collect Rotten Tomatoes movie, TV series, and season details with available Tomatometer and audience scores. Use keywords or URLs for title data, or URLs for critic and audience reviews. Save rows for film research and catalog work.", "version": "0.0", "x-build-id": "vrtDTeZPWcbQJUgaC" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/maximedupre~rottentomatoes/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-maximedupre-rottentomatoes", "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~rottentomatoes/runs": { "post": { "operationId": "runs-sync-maximedupre-rottentomatoes", "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~rottentomatoes/run-sync": { "post": { "operationId": "run-sync-maximedupre-rottentomatoes", "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": [ "resultType" ], "properties": { "resultType": { "title": "Result type", "enum": [ "titles", "reviews" ], "type": "string", "description": "Titles returns movie, TV series, and season details with available scores. Reviews returns one row per review for a movie or TV season." }, "keywords": { "title": "Search keywords", "type": "array", "description": "Find titles with these keywords. Enter one search term per line. You can also submit title URLs below.", "items": { "type": "string", "minLength": 1 } }, "mediaType": { "title": "Search for", "enum": [ "movies", "tv", "both" ], "type": "string", "description": "Limit keyword search to movies, TV titles, or both. This choice does not limit submitted URLs.", "default": "both" }, "includeSearchAlternatives": { "title": "Include alternative search matches", "type": "boolean", "description": "Collect all matching titles from keyword search. Turn off to collect only the first match for each keyword. Search does not guarantee an exact title match.", "default": true }, "reviewType": { "title": "Review source", "enum": [ "critic", "audience", "both" ], "type": "string", "description": "Choose whose reviews to collect. Submit title or review addresses below. This choice also applies to addresses with review query parameters or fragments.", "default": "critic" }, "topCriticsOnly": { "title": "Top Critics only", "type": "boolean", "description": "Collect only critic reviews marked as Top Critic reviews. Applies when collecting critic reviews, including when both review sources are selected.", "default": false }, "verifiedAudienceOnly": { "title": "Verified audience only", "type": "boolean", "description": "Collect only audience reviews marked as verified. Applies when collecting audience reviews, including when both review sources are selected.", "default": false }, "startUrls": { "title": "Rotten Tomatoes addresses", "type": "array", "description": "Enter one Rotten Tomatoes movie, TV series, season, review, or credits address per line. Full URLs and paths such as /m/the_matrix are accepted. Titles accepts keywords, addresses, or both. Reviews needs addresses; the review source choice sets whose reviews to collect.", "items": { "type": "string", "minLength": 1 } }, "maxItems": { "title": "Maximum results", "minimum": 1, "type": "integer", "description": "Stop after this many title or review rows across the run. Leave it empty to return 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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }