{ "openapi": "3.0.1", "info": { "title": "Naver Shopping Best Seller Ranking, Keyword Trend & Brand Chart", "description": "Get Naver Shopping best seller charts for Korea: top products by views and purchases, trending search keywords with rank movement, and brand rankings. Filter by category, week or day, and by age and gender segment. Korean titles, KRW prices, seller names and ratings.", "version": "0.1", "x-build-id": "YJBaHRTFJsIOXbRaG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~naver-shopping-rank/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-naver-shopping-rank", "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/s-r~naver-shopping-rank/runs": { "post": { "operationId": "runs-sync-s-r-naver-shopping-rank", "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/s-r~naver-shopping-rank/run-sync": { "post": { "operationId": "run-sync-s-r-naver-shopping-rank", "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": { "chart": { "title": "Chart", "enum": [ "products", "keywords", "brands", "todayItems", "verticals" ], "type": "string", "description": "Which Naver Shopping chart to read. Products = best-selling and most-viewed products. Keywords = trending shopping searches. Brands = the brand ranking. Today's items = themed picks carrying the current Korean date. Verticals = the four themed top-12 lists.", "default": "products" }, "categoryId": { "title": "Category", "enum": [ "A", "50000000", "50000001", "50000002", "50000003", "50000004", "50000005", "50000006", "50000007", "50000008", "50000009" ], "type": "string", "description": "Naver's top-level shopping category. 'A' is every category combined. Leisure and convenience has a product chart but no keyword or brand chart. Ignored for today's items and verticals.", "default": "A" }, "ranking": { "title": "Ranking", "enum": [ "mostViewed", "mostBought", "popular", "rising", "new", "mini" ], "type": "string", "description": "How the chart is ordered. Products take mostViewed or mostBought. Keywords and brands take popular or rising, keywords also take new, brands also take mini. A value that does not belong to the chosen chart is refused with the list that does.", "default": "mostViewed" }, "period": { "title": "Period", "enum": [ "DAILY", "WEEKLY", "MONTHLY" ], "type": "string", "description": "The window Naver aggregated over. The product chart carries daily and weekly only; it accepts monthly and answers with an empty list, so monthly is refused here rather than passed on.", "default": "DAILY" }, "ageType": { "title": "Audience segment", "enum": [ "ALL", "WOMEN_ALL", "MEN_ALL", "WOMEN_10", "MEN_10", "WOMEN_20", "MEN_20", "WOMEN_30", "MEN_30", "WOMEN_40", "MEN_40", "WOMEN_50", "MEN_50" ], "type": "string", "description": "Rank the chart for one age and gender segment instead of everyone. WOMEN_ALL and MEN_ALL work on the keyword and brand charts; on the product chart they return nothing, so they are refused there.", "default": "ALL" }, "date": { "title": "Historical date (keywords only)", "type": "string", "description": "Read an older keyword chart, as YYYY-MM-DD. Only the keyword chart has history, and only on dates Naver holds; a date it does not hold is reported as such instead of returned empty. The product and brand charts ignore this parameter and return today, so it is refused for them.", "default": "" }, "includeProducts": { "title": "Include each entry's products", "type": "boolean", "description": "For the keyword and brand charts, also read the products behind every chart entry. Adds up to 20 products per entry and one extra request each, so a 20-entry chart becomes roughly 420 rows.", "default": false }, "verticals": { "title": "Verticals to read", "type": "array", "description": "Which themed lists to read when the chart is 'verticals'. Each serves 12 products. These rows carry no review data, no seller and no date, because Naver does not put those on this surface.", "items": { "type": "string", "enum": [ "fashiontown", "bestdeal", "logistics", "shoppinglive" ], "enumTitles": [ "fashiontown - 패션타운", "bestdeal - 베스트딜", "logistics - 도착보장 (arrival guaranteed)", "shoppinglive - 쇼핑라이브" ] }, "default": [ "fashiontown", "bestdeal", "logistics", "shoppinglive" ] }, "gender": { "title": "Vertical audience", "enum": [ "F", "M" ], "type": "string", "description": "Whose fashion town and best deal lists to read. Naver does not reject an unrecognised value, it quietly returns the women's list, so anything other than F or M is refused here.", "default": "F" }, "maxItems": { "title": "Maximum rows", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Stop after this many rows. The product chart serves between 93 and 100 rows, the keyword and brand charts 20, each vertical 12.", "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 } } } } } } } } } }