{ "openapi": "3.0.1", "info": { "title": "Daiso Korea Ranking Scraper (다이소 랭킹 · Best Sellers)", "description": "Pick a Daiso Korea (daisomall.co.kr) best-seller ranking - rising now, daily or weekly, overall or by category - and get flat product rows: rank, rank change since your last run, price, units sold, online stock, sold-out flag, reviews, optional barcode. Also new arrivals and keyword search. 다이소 크롤링.", "version": "0.1", "x-build-id": "YOA0LmqLZmfl26aIE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/magenta_courser~daiso-ranking-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-magenta_courser-daiso-ranking-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/magenta_courser~daiso-ranking-scraper/runs": { "post": { "operationId": "runs-sync-magenta_courser-daiso-ranking-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/magenta_courser~daiso-ranking-scraper/run-sync": { "post": { "operationId": "run-sync-magenta_courser-daiso-ranking-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": "What to scrape", "enum": [ "bestsellers", "newArrivals", "search" ], "type": "string", "description": "What to get. \"bestsellers\" (default) = Daiso Mall sales ranking. \"newArrivals\" = sales ranking of products launched in the last 7 days. \"search\" = products matching the keywords in \"keywords\". Example: \"bestsellers\".", "default": "bestsellers" }, "period": { "title": "Ranking period", "enum": [ "risingNow", "daily", "weekly" ], "type": "string", "description": "Ranking tab, used by \"bestsellers\" and \"newArrivals\": \"risingNow\" (Daiso tab \"급상승\", products whose sales are rising fastest; turns over heavily between refreshes), \"daily\" (\"일간\") or \"weekly\" (\"주간\"). Use \"daily\" or \"weekly\" for stable rank tracking. Ignored in search mode. Example: \"weekly\".", "default": "risingNow" }, "categories": { "title": "Categories", "type": "array", "description": "Ranking categories as a list of keys, one ranking per category. Allowed keys: all, beautyHygiene, kitchen, cleaningBath, storage, stationery, interiorGarden, toolsDigital, food, sportsHobby, fashion, pets, babyToys, seasonal. Leave empty or use [\"all\"] for the overall ranking. Ignored in search mode. Example: [\"beautyHygiene\", \"storage\"].", "items": { "type": "string", "enum": [ "all", "beautyHygiene", "kitchen", "cleaningBath", "storage", "stationery", "interiorGarden", "toolsDigital", "food", "sportsHobby", "fashion", "pets", "babyToys", "seasonal" ], "enumTitles": [ "All (overall ranking)", "Beauty / hygiene (뷰티/위생)", "Kitchen (주방용품)", "Cleaning / bathroom (청소/욕실)", "Storage / organizing (수납/정리)", "Stationery / fancy (문구/팬시)", "Interior / gardening (인테리어/원예)", "Tools / digital (공구/디지털)", "Food (식품)", "Sports / leisure / hobby (스포츠/레저/취미)", "Fashion / accessories (패션/잡화)", "Pets (반려동물)", "Baby / toys (유아/완구)", "Seasonal / series (시즌/시리즈)" ] } }, "keywords": { "title": "Search keywords", "type": "array", "description": "Only for mode \"search\": list of search keywords, one search per keyword, up to 50. Product names are Korean, so use Korean keywords. Example: [\"수납함\", \"텀블러\", \"립밤\"] (storage box, tumbler, lip balm). Results come in Daiso's default relevance order.", "items": { "type": "string" } }, "maxItems": { "title": "Max products per ranking or keyword", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many products to return for each ranking/category or keyword, counted from the top. Integer 1-1000, default 100. Each returned product is one charged row. Example: 100. In our tests the overall ranking was about 3,000 products deep and the new-arrivals ranking about 800.", "default": 100 }, "includeDetails": { "title": "Add barcode and wishlist count", "type": "boolean", "description": "true = make one extra request per product to add barcode (Daiso barcode value), wishlistCount, brandEn and maxOrderQty, and to fill onlineStockQty in the daily and weekly lists (which do not report stock). Charged as a separate \"product-details\" event per product, only when it succeeds. Slower: a few seconds per product. Default false.", "default": false }, "excludeBoxProducts": { "title": "Exclude box (case pack) products", "type": "boolean", "description": "Box listings (product IDs starting with \"B\": a case of the same item sold at a bulk price) show up in search results. true (default) skips them; false keeps them with isBoxProduct = true.", "default": true }, "historyStoreName": { "title": "History store name", "type": "string", "description": "Name of the key-value store that remembers the previous list, used to fill lastRunRank, rankChange and isNewEntry. Keep the same name (and the same maxItems) between scheduled runs. Use a different name for separate watchlists. Letters, digits and hyphens only. Example: \"daiso-ranking-history\" (default).", "default": "daiso-ranking-history" }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy settings. Keep the default {\"useApifyProxy\": true} (Apify datacenter proxy); Daiso Mall did not block it in our tests.", "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 }, "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 } } } } } } } } } }