{ "openapi": "3.0.1", "info": { "title": "Shopee, Lazada & TikTok Shop Listing Translator (SEA)", "description": "Translate and localize your product listings into Bahasa Malaysia, Indonesian, Thai and Vietnamese with AI, trim titles to Shopee, Lazada and TikTok Shop limits, and check Malaysia CPETTR 2024 seller disclosures.", "version": "0.1", "x-build-id": "O6WgfwmuvUBnDuNMM" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/messnomore~sea-listing-localizer/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-messnomore-sea-listing-localizer", "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/messnomore~sea-listing-localizer/runs": { "post": { "operationId": "runs-sync-messnomore-sea-listing-localizer", "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/messnomore~sea-listing-localizer/run-sync": { "post": { "operationId": "run-sync-messnomore-sea-listing-localizer", "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": { "listings": { "title": "Listings", "maxItems": 10000, "type": "array", "description": "Your products, one object each. Required: \"sku\" and \"title\". Optional: \"description\" (text or HTML), \"variations\" ([{\"name\": \"Color\", \"options\": [\"Black\"]}]), \"price\", \"currency\", \"brand\", \"protectedTerms\" (words to keep exactly as written, such as brand or model names), and any seller field from \"Seller details\" to override it for this product. Column names such as \"Product Name\" or \"Body (HTML)\" are recognized too." }, "listingsCsvUrl": { "title": "Listings CSV file (URL)", "type": "string", "description": "Optional: a public link to a CSV file with one product per row (same column names as above), or a Shopify product export (Shopify admin > Products > Export, \"CSV for Excel, Numbers, or other spreadsheet programs\"). Save the file as UTF-8. Up to 10 MB; rows are added after the listings above.", "default": "" }, "sellerProfile": { "title": "Seller details", "type": "object", "description": "Seller and sale information shared by all listings, used for the Malaysia CPETTR 2024 check: sellerName, sellerRegNo (SSM number), sellerAddress, sellerEmail, sellerPhone, sellerWebsite, paymentMethods, termsAndConditions, returnPolicy, shippingFee (0 = free shipping), deliveryTerms, estimatedDelivery, safetyCertificate. A listing's own value wins." }, "checkCPETTR": { "title": "Check CPETTR 2024 disclosures", "type": "boolean", "description": "Score each listing 0-100 against the seller disclosures required by Malaysia's Consumer Protection (Electronic Trade Transaction) Regulations 2024, and list what is missing. Switch off if you do not sell to Malaysia.", "default": true }, "targetLanguages": { "title": "Target languages", "minItems": 1, "type": "array", "description": "Each listing is returned once per language. Bahasa Malaysia also satisfies the CPETTR national-language rule.", "items": { "type": "string", "enum": [ "ms", "id", "th", "vi" ], "enumTitles": [ "Bahasa Malaysia", "Bahasa Indonesia", "Thai", "Vietnamese" ] }, "default": [ "ms" ] }, "marketplace": { "title": "Marketplace", "enum": [ "shopee", "lazada", "tiktokshop" ], "type": "string", "description": "Sets the title and description limits: Shopee 120 / 3,000 characters (common Seller Centre figures, check yours), Lazada 255 / 25,000, TikTok Shop 25-255 / 10,000.", "default": "shopee" }, "titleMaxLength": { "title": "Title length limit (optional)", "minimum": 0, "maximum": 255, "type": "integer", "description": "Your own title limit in characters (10-255), for example the number your Shopee Seller Centre shows for your category. 0 uses the marketplace limit. Lazada and TikTok Shop limits cannot be raised, and TikTok Shop titles need at least 25 characters.", "default": 0 }, "maxResults": { "title": "Maximum results", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper limit on returned listing versions (listings x languages). You pay per returned result, so this also caps the cost of a run. Runs on the Apify free plan return up to 10 results.", "default": 100 } } }, "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 } } } } } } } } } }