{ "openapi": "3.0.1", "info": { "title": "Lazada Scraper - Products, Reviews & Shops in 6 Markets", "description": "Extract Lazada products, prices, reviews and shop data from Singapore, Malaysia, the Philippines, Thailand, Vietnam and Indonesia. Pay per delivered row.", "version": "0.3", "x-build-id": "4db0S7zwDOEN8uedb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lentic_clockss~lazada-ph-search-results-collector/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lentic_clockss-lazada-ph-search-results-collector", "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/lentic_clockss~lazada-ph-search-results-collector/runs": { "post": { "operationId": "runs-sync-lentic_clockss-lazada-ph-search-results-collector", "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/lentic_clockss~lazada-ph-search-results-collector/run-sync": { "post": { "operationId": "run-sync-lentic_clockss-lazada-ph-search-results-collector", "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": { "keywords": { "title": "Keywords", "maxItems": 20, "type": "array", "description": "Enter up to 20 Lazada search phrases. With no target input, the Actor runs a three-row example search.", "items": { "type": "string" } }, "sellerKeys": { "title": "Seller keys", "type": "array", "description": "Enter storefront keys from shop URLs, such as itel. Keys without keywords select shopcatalog; seller discovery modes can find shops when keys are omitted.", "items": { "type": "string" } }, "market": { "title": "Market", "enum": [ "PH", "SG", "MY", "TH", "VN", "ID" ], "type": "string", "description": "Choose the Lazada country site to collect from. One market is used for the whole run.", "default": "MY" }, "pages": { "title": "Pages per keyword", "minimum": 1, "maximum": 3, "type": "integer", "description": "Number of search pages to request per keyword, from 1 to 3. Fewer rows may be available than requested.", "default": 1 }, "maxItems": { "title": "Max rows per keyword or seller key", "minimum": 1, "maximum": 200, "type": "integer", "description": "Maximum rows per keyword or explicit seller key, from 1 to 200; the default is 70. All row types share that input limit, and total delivery also respects the cost cap and Free-plan limit of 200 rows per run and 10 total runs.", "default": 70 }, "minItemsPerPage": { "title": "Minimum items per page", "minimum": 1, "maximum": 40, "type": "integer", "description": "Minimum results required to accept a search page, from 1 to 40. Keep 1 for searches with few matches.", "default": 1 }, "headless": { "title": "Developer test setting", "type": "boolean", "description": "Leave enabled. Used only by the developer for testing.", "default": true }, "includeRawPayload": { "title": "Developer response capture", "type": "boolean", "description": "Leave disabled. Used only by the developer for testing.", "default": false }, "debug": { "title": "Developer diagnostics", "type": "boolean", "description": "Leave disabled. Used only by the developer for testing.", "default": false }, "maxRetriesPerKeyword": { "title": "Max retries per keyword", "minimum": 0, "maximum": 3, "type": "integer", "description": "Number of retries after a recoverable keyword failure, from 0 to 3.", "default": 1 }, "requestTimeoutSecs": { "title": "Request timeout (seconds)", "minimum": 15, "maximum": 120, "type": "integer", "description": "Time allowance for collecting each keyword, from 15 to 120 seconds.", "default": 90 }, "scrollSteps": { "title": "Developer scroll setting", "minimum": 0, "maximum": 8, "type": "integer", "description": "Leave at the default. Used only by the developer for testing.", "default": 3 }, "scrollDelayMs": { "title": "Developer scroll delay", "minimum": 0, "maximum": 3000, "type": "integer", "description": "Leave at the default. Used only by the developer for testing.", "default": 300 }, "postLoadWaitMs": { "title": "Developer load delay", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Leave at the default. Used only by the developer for testing.", "default": 1200 }, "enrichDetails": { "title": "Add product details", "type": "boolean", "description": "Add available product-page details to the first results, including seller identifiers and shipping location. Enabled by default; unavailable details do not replace existing search fields.", "default": true }, "enrichMaxItems": { "title": "Maximum products with details", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum products to supplement with product-page details, from 0 to 10. Sitemap mode requires a value above zero.", "default": 3 }, "searchEngine": { "title": "Search method", "enum": [ "auto", "mtop", "browser" ], "type": "string", "description": "Choose automatic selection for normal searches. The other choices use a fixed search method without automatic selection.", "default": "auto" }, "includeReviews": { "title": "Include buyer reviews", "type": "boolean", "description": "Return available buyer reviews as separate rowType=review rows at the same price per row. Products and reviews share maxItems; sitemap-only products do not receive this add-on.", "default": false }, "maxReviewsPerItem": { "title": "Max reviews per item", "minimum": 0, "maximum": 50, "type": "integer", "description": "Maximum separate review rows considered per product, from 0 to 50. The input maxItems limit also applies.", "default": 5 }, "includeSellerInfo": { "title": "Include seller info", "type": "boolean", "description": "Add available shop name, seller rating, follower count and chat information to product rows.", "default": false }, "includeShopProfile": { "title": "Include shop profile", "type": "boolean", "description": "Add available shop profile information. Requires shop and seller identifiers, so combine with includeSellerInfo for better coverage.", "default": false }, "includeSellerItemReviews": { "title": "Include seller item reviews", "type": "boolean", "description": "Add available shop-wide product-review information to product rows. Coverage depends on the seller information returned.", "default": false }, "maxSellerItemReviews": { "title": "Max seller item reviews per row", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum shop product-review page size, from 1 to 50.", "default": 10 }, "includePcReviewList": { "title": "Include extended product reviews", "type": "boolean", "description": "Add available extended product-review information, including review impressions. The field may be absent when unavailable.", "default": false }, "maxPcReviewList": { "title": "Maximum extended reviews per product", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum extended product-review page size, from 1 to 50.", "default": 5 }, "includeSellerReviews": { "title": "Include seller service reviews", "type": "boolean", "description": "Add available seller-service review information. The field may be absent when unavailable.", "default": false }, "maxSellerReviews": { "title": "Max seller reviews per seller", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum seller-service review page size, from 1 to 50.", "default": 5 }, "includeShopNavBadges": { "title": "Include shop nav badges", "type": "boolean", "description": "Add available storefront verification badges, such as Philippine business-registration badges.", "default": false }, "includeSeoInnerLink": { "title": "Include related product links", "type": "boolean", "description": "Add related tag, category and review-page links shown with a product.", "default": false }, "includeItemQA": { "title": "Include item Q&A", "type": "boolean", "description": "Add available product questions and answers, with product-variant context when shown.", "default": false }, "maxItemQA": { "title": "Max Q&A per item", "minimum": 1, "maximum": 50, "type": "integer", "description": "Maximum product question-and-answer page size, from 1 to 50.", "default": 5 }, "includeDetailAsync": { "title": "Include voucher and gift offers", "type": "boolean", "description": "Add available voucher and gift-offer fields. Fields are present only when the product has a matching offer.", "default": false }, "detailAsyncTypes": { "title": "Offer types", "type": "string", "description": "Comma-separated offer types to request. Empty uses multiVoucherCollect, dnbRecommend, voucherFsMultCollect and voucherPackageCollect.", "default": "" }, "includeMultiBuy": { "title": "Include multi-buy offers", "type": "boolean", "description": "Add bundle-offer counts and promotion links when the product has a multi-buy offer.", "default": false }, "enrichEngine": { "title": "Product detail method", "enum": [ "auto", "htmlDirect", "zyte", "none" ], "type": "string", "description": "Choose automatic selection for product details, a fixed detail method, or no detail enrichment. Availability depends on the product.", "default": "auto" }, "discoveryMode": { "title": "Discovery mode", "enum": [ "search", "sitemap", "both", "sellers", "live", "shopcatalog", "shopItems" ], "type": "string", "description": "Choose search, sitemap inventory, both, sellers, live rooms, shopcatalog categories or shopItems products. Sitemap requires enrichDetails=true and enrichMaxItems above zero; inventory is not keyword-matched.", "default": "search" }, "sitemapBuckets": { "title": "Maximum sitemap buckets", "minimum": 1, "maximum": 8, "type": "integer", "description": "Maximum inventory groups to inspect, from 1 to 8.", "default": 3 }, "sitemapMaxUrls": { "title": "Maximum discovered URLs", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum inventory URLs to consider, from 1 to 1000. Product output is also bounded by maxItems and enrichMaxItems.", "default": 200 }, "workerBaseUrl": { "title": "Developer test URL", "type": "string", "description": "Leave empty. Used only by the developer for testing." } } }, "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 } } } } } } } } } }