{ "openapi": "3.0.1", "info": { "title": "ShortMax Scraper - Short Dramas, Rankings & Episodes", "description": "Scrape the ShortMax short-drama catalog: titles, descriptions, creators, view and follow counters, two genre taxonomies, trending rails with rank and episode lists. Catalog, category, genre, trending or pasted links, in 19 site languages. Resume, incremental updates and MCP export.", "version": "1.0", "x-build-id": "ycArSkrjrKQHTmVDy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~shortmax-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-shortmax-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/abotapi~shortmax-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-shortmax-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/abotapi~shortmax-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-shortmax-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": { "mode": { "title": "Mode", "enum": [ "catalog", "category", "genre", "trending", "urls" ], "type": "string", "description": "catalog walks the full drama catalog page by page. category walks selected category pages. genre walks selected genre pages (a second, independent taxonomy). trending reads the homepage rails with rail name and position. urls scrapes only the links you paste.", "default": "catalog" }, "categories": { "title": "Categories (category mode)", "type": "array", "description": "Category slugs, ids or display names, resolved against the live category index when the run starts (example: fantasy). Leave empty to walk every category.", "items": { "type": "string" } }, "genres": { "title": "Genres (genre mode)", "type": "array", "description": "Genre slugs, ids or display names, resolved against the live genre index when the run starts (example: modern). Leave empty to walk every genre.", "items": { "type": "string" } }, "language": { "title": "Site language", "enum": [ "en", "zh-Hans", "ja", "ko", "pt", "vi", "id", "th", "es", "it", "ar", "de", "fr", "zh-Hant", "tr", "hi", "ru", "ms", "fil" ], "type": "string", "description": "Which localized catalog to read. The stable numeric title id is the same across languages; titles, synopses and slugs are localized.", "default": "en" }, "listingUrls": { "title": "Links (urls mode)", "type": "array", "description": "Drama pages (/drama/...), episode pages (/episode/...), all-episodes pages (/episodes/...), category pages (/dramas/-), genre pages (/genres/-) and catalog links (/dramas). Each link keeps its own site language.", "default": [ { "url": "https://www.shorttv.live/drama/the-day-i-chose-his-roommate-43438" }, { "url": "https://www.shorttv.live/dramas/fantasy-200003" } ], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Max items", "minimum": 0, "type": "integer", "description": "Maximum number of title records per run. 0 means no limit.", "default": 20 }, "maxPages": { "title": "Max pages per scope", "minimum": 0, "type": "integer", "description": "Maximum pages walked per catalog, category or genre scope. 0 means no page cap, so Max items is the only cap that stops a run early.", "default": 0 }, "fetchDetails": { "title": "Fetch detail pages", "type": "boolean", "description": "Read each title's drama page for the full description, creator, view/follow counters, tag taxonomy and the episode list. Off = catalog card rows only (title, cover, links).", "default": true }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Apify datacenter proxies serve this site reliably. Residential proxies are recommended for the most reliable long runs.", "default": { "useApifyProxy": true } }, "resumeFromRunId": { "title": "Resume from run ID", "type": "string", "description": "Run ID whose collected titles should be skipped (for continuing after an interrupted run).", "default": "" }, "incrementalMode": { "title": "Incremental mode", "type": "boolean", "description": "Track state between runs and classify every title as NEW, UPDATED, UNCHANGED or EXPIRED instead of always NEW. Rows already known and unchanged are suppressed.", "default": false }, "stateKey": { "title": "State key", "type": "string", "description": "Named baseline for incremental runs. Leave empty to derive the key from the run scope (mode, categories, genres, language).", "default": "" }, "emitUnchanged": { "title": "Emit unchanged rows", "type": "boolean", "description": "In incremental mode, also push rows that did not change (changeType UNCHANGED).", "default": false }, "emitExpired": { "title": "Emit expired rows", "type": "boolean", "description": "In incremental mode, emit EXPIRED tombstone rows for titles that disappeared from the walked scope.", "default": false }, "ignoreFieldsForChanges": { "title": "Ignore fields when detecting changes (incremental mode only)", "type": "array", "description": "Extra field names that must never mark a row UPDATED (counters and rank positions are already excluded by default).", "default": [], "items": { "type": "string" } }, "mcpConnectors": { "title": "MCP connectors", "type": "array", "description": "Apify MCP connector IDs that receive pushed records while the run executes.", "default": [], "items": { "type": "string" } }, "notionParentPageUrl": { "title": "Notion parent page URL", "type": "string", "description": "Notion parent page for the Notion MCP connector.", "default": "" }, "maxNotifyListings": { "title": "Max records to connectors", "minimum": 0, "type": "integer", "description": "Cap on records sent to MCP connectors per run.", "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 }, "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 } } } } } } } } } }