{
"openapi": "3.0.1",
"info": {
"title": "Musinsa Scraper — K-Fashion Rankings & Reviews [💰 $2/1K]",
"description": "Scrape Musinsa (musinsa.com), Korea's #1 fashion platform: keyword search, official best-seller rankings by category, gender and age, and every review with size fit plus reviewer height and weight. Prices, discounts, ratings, likes and English brand names as clean JSON. No login.",
"version": "0.1",
"x-build-id": "i9RGX2EmDQueNxcuk"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/cocomoon~musinsa-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-cocomoon-musinsa-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/cocomoon~musinsa-scraper/runs": {
"post": {
"operationId": "runs-sync-cocomoon-musinsa-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/cocomoon~musinsa-scraper/run-sync": {
"post": {
"operationId": "run-sync-cocomoon-musinsa-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"
],
"properties": {
"mode": {
"title": "Mode",
"enum": [
"search",
"ranking",
"reviews"
],
"type": "string",
"description": "What to scrape: search — products by keyword (prices, discounts, rating, review count, likes, category); ranking — Musinsa best-seller ranking by category, gender, age group and period; reviews — all customer reviews of specific products (text, stars, size fit, reviewer height/weight, photos).",
"default": "search"
},
"keywords": {
"title": "Search keywords",
"type": "array",
"description": "Search mode: keywords to search. Korean and English both work — e.g. 가디건, cardigan, 나이키, denim jacket.",
"items": {
"type": "string"
}
},
"sortBy": {
"title": "Search sort order",
"enum": [
"POPULAR",
"NEW",
"LOW_PRICE",
"HIGH_PRICE",
"DISCOUNT_RATE",
"REVIEW",
"SALE_ONE_DAY_COUNT",
"SALE_ONE_WEEK_COUNT",
"SALE_ONE_MONTH_COUNT",
"SALE_THREE_MONTH_COUNT",
"SALE_COUNT"
],
"type": "string",
"description": "Search mode: sort order of results. The best-selling options rank by units sold in that window.",
"default": "POPULAR"
},
"gender": {
"title": "Gender filter",
"enum": [
"A",
"M",
"F"
],
"type": "string",
"description": "Search and ranking modes: all, men or women products.",
"default": "A"
},
"rankingCategories": {
"title": "Ranking categories",
"type": "array",
"description": "Ranking mode: Musinsa category codes. 000 all, 001 tops, 002 outerwear, 003 pants, 100 dresses/skirts, 103 shoes, 004 bags, 120 hats, 101 accessories, 104 beauty, 026 underwear/homewear, 017 sports, 102 digital/life, 106 kids. Sub-categories use 6 digits, e.g. 002020 cardigans, 003002 denim pants, 103004 sneakers, 104001 skincare. Full list in the README.",
"items": {
"type": "string"
}
},
"rankingPeriod": {
"title": "Ranking period",
"enum": [
"REALTIME",
"DAILY",
"WEEKLY",
"MONTHLY"
],
"type": "string",
"description": "Ranking mode: time window of the ranking.",
"default": "REALTIME"
},
"rankingAgeBand": {
"title": "Ranking age group",
"enum": [
"AGE_BAND_ALL",
"AGE_BAND_MINOR",
"AGE_BAND_20",
"AGE_BAND_25",
"AGE_BAND_30",
"AGE_BAND_35",
"AGE_BAND_40"
],
"type": "string",
"description": "Ranking mode: shopper age group.",
"default": "AGE_BAND_ALL"
},
"products": {
"title": "Products (for reviews)",
"type": "array",
"description": "Reviews mode: Musinsa goods numbers (e.g. 6957177) or product URLs (e.g. https://www.musinsa.com/products/6957177). Get goods numbers from a search or ranking run (goodsNo field).",
"items": {
"type": "string"
}
},
"reviewSort": {
"title": "Review sort order",
"enum": [
"new",
"up_cnt_desc",
"goods_est_desc",
"goods_est_asc"
],
"type": "string",
"description": "Reviews mode: order in which reviews are collected.",
"default": "new"
},
"photoReviewsOnly": {
"title": "Photo reviews only",
"type": "boolean",
"description": "Reviews mode: collect only reviews that include photos.",
"default": false
},
"maxReviewsPerProduct": {
"title": "Max reviews per product",
"minimum": 0,
"type": "integer",
"description": "Reviews mode: cap per product. 0 = no cap (every review, limited only by Max items).",
"default": 0
},
"includeDetails": {
"title": "Include product details",
"type": "boolean",
"description": "Search and ranking modes: also fetch each product's detail data — English brand name, English product name, category, style number, brand country, season and exact rating. Slightly slower; turn off for maximum speed.",
"default": true
},
"maxItems": {
"title": "Max items",
"minimum": 1,
"type": "integer",
"description": "Maximum number of results in total (products or reviews) across all keywords, categories or products.",
"default": 1000
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxies to use. The default Apify proxy works in most cases.",
"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
}
}
}
}
}
}
}
}
}
}