{ "openapi": "3.0.1", "info": { "title": "Daraz Scraper", "description": "Scrape Daraz, South Asia's largest online marketplace (Pakistan, Bangladesh, Sri Lanka, Nepal). Search products by keyword or category, filter by price, rating, and sort order, across all four country storefronts.", "version": "1.0", "x-build-id": "l69Q1A2J1Q13sBp6C" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~daraz-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-daraz-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/crawlerbros~daraz-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-daraz-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/crawlerbros~daraz-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-daraz-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", "required": [ "mode", "countrySite" ], "properties": { "mode": { "title": "Mode", "enum": [ "search", "category" ], "type": "string", "description": "What to fetch: search by keyword, or browse a category listing.", "default": "search" }, "countrySite": { "title": "Country site", "enum": [ "pk", "bd", "lk", "np" ], "type": "string", "description": "Which Daraz storefront to scrape.", "default": "pk" }, "searchQuery": { "title": "Search query", "type": "string", "description": "Free-text keyword (mode=search). Also used to narrow results within a category when mode=category.", "default": "mobile phone" }, "category": { "title": "Category", "enum": [ "phones-tablets", "computing", "camera", "home-appliances", "fashion", "shoes-clothing", "jewellery-watches-eyewear", "beauty-health", "mother-baby", "furniture-decor", "home-improvement-tools", "grocers-shop", "sports-travel", "motors-vehicles", "books-games-music" ], "type": "string", "description": "Daraz category to browse (mode=category).", "default": "phones-tablets" }, "brand": { "title": "Brand", "type": "string", "description": "Only keep products whose brand exactly matches this name (case-insensitive), e.g. `Dell`, `Samsung`, `Nike`. Matched against the brand Daraz shows on the listing — leave empty to include all brands. Narrower than a dropdown because Daraz doesn't expose a fixed, query-independent brand list." }, "shippedFrom": { "title": "Shipped from", "type": "string", "description": "Only keep products shipped from this region (case-insensitive exact match), e.g. `Punjab`, `Sindh`, `Local`, `Overseas` (Pakistan); `Dhaka`, `Chattogram` (Bangladesh); `Western`, `Southern` (Sri Lanka); `Bagmati Province` (Nepal). Matches Daraz's own \"Shipped From\" filter — leave empty to include all regions." }, "freeShippingOnly": { "title": "Free shipping only", "type": "boolean", "description": "Only keep products that show a free-shipping / free-delivery badge.", "default": false }, "inStockOnly": { "title": "In stock only", "type": "boolean", "description": "Only keep products Daraz currently reports as in stock.", "default": false }, "minPrice": { "title": "Min price", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop products priced below this amount (in the storefront's local currency)." }, "maxPrice": { "title": "Max price", "minimum": 0, "maximum": 100000000, "type": "integer", "description": "Drop products priced above this amount (in the storefront's local currency)." }, "minRating": { "title": "Minimum rating", "enum": [ "0", "1", "2", "3", "4", "5" ], "type": "string", "description": "Only include products with at least this star rating.", "default": "0" }, "sortBy": { "title": "Sort order", "enum": [ "popularity", "priceasc", "pricedesc" ], "type": "string", "description": "Result ordering, matching Daraz's own sort options.", "default": "popularity" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on the number of products emitted.", "default": 50 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Daraz's product-listing API accepts plain datacenter traffic, so the free AUTO group is sufficient. Left on by default for IP diversity across large runs.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }