{
"openapi": "3.0.1",
"info": {
"title": "Naver Reviews Scraper | Shopping Product Reviews",
"description": "Naver reviews scraper (네이버 리뷰) for Smart Store (스마트스토어) and Brand Store products. Type 1 Korean keyword and get 100 reviews in 13 seconds, 31 fields each: rating, text, option bought, photos, videos, AI tags, buyer profile, seller reply and date. No Naver account. Export JSON, CSV or Excel.",
"version": "1.0",
"x-build-id": "4neOPPWYL2r7xbSNl"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/silentflow~naver-reviews-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-silentflow-naver-reviews-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/silentflow~naver-reviews-scraper/runs": {
"post": {
"operationId": "runs-sync-silentflow-naver-reviews-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/silentflow~naver-reviews-scraper/run-sync": {
"post": {
"operationId": "run-sync-silentflow-naver-reviews-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": {
"keywords": {
"title": "🔎 Keywords",
"type": "array",
"description": "What to search on Naver Shopping, one keyword per line. Korean keywords match best (유기농 사과, 무선 선풍기), brand and model names work in English (galaxy buds). The run reads the reviews of the Smart Store and Brand Store products Naver shows first for each keyword, product after product, up to about 50 reviewed products per keyword.",
"items": {
"type": "string"
}
},
"productUrls": {
"title": "🛍️ Product addresses or IDs",
"type": "array",
"description": "Products whose reviews you want, one per line: a Smart Store or Brand Store product address (https://smartstore.naver.com/pasteur365/products/11150965069, https://brand.naver.com/lumena/products/13244298880, mobile addresses too) or the bare product id at the end of it (11150965069). Price comparison pages (search.shopping.naver.com/catalog/...) are not store products; search their name as a keyword instead.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "🔢 Max reviews",
"minimum": 1,
"type": "integer",
"description": "How many reviews to save for the whole run. With the default 20 reviews per product, 100 covers the first five reviewed products of a keyword. Each review is one row, so set it to what you need.",
"default": 100
},
"maxReviewsPerProduct": {
"title": "📦 Reviews per product",
"minimum": 0,
"type": "integer",
"description": "How many reviews to read from each product before moving to the next one. 0 reads every review of a product (Naver shows up to 20,000 per product and sort), which suits a single product address; a small number spreads a keyword run over more products.",
"default": 20
},
"sortBy": {
"title": "↕️ Sort reviews by",
"enum": [
"ranking",
"newest",
"highest",
"lowest"
],
"type": "string",
"description": "The order reviews are read in: Naver's ranking (랭킹순), newest first (최신순), highest rating first (평점 높은순) or lowest rating first (평점 낮은순). Newest first suits a scheduled run that watches new reviews; lowest first surfaces complaints.",
"default": "ranking"
},
"starRatings": {
"title": "⭐ Star ratings",
"type": "array",
"description": "Keep only the reviews of these ratings. Leave it empty for all ratings. Pick 1 and 2 to collect the negative reviews only; each product's quota is shared between the ratings you pick.",
"items": {
"type": "string",
"enum": [
"5",
"4",
"3",
"2",
"1"
],
"enumTitles": [
"5 stars",
"4 stars",
"3 stars",
"2 stars",
"1 star"
]
},
"default": []
},
"reviewFilter": {
"title": "🧩 Review type",
"enum": [
"all",
"photo_video",
"after_use",
"repurchase",
"store_pick"
],
"type": "string",
"description": "Keep only one kind of review, as Naver's own tabs do: photo and video reviews (포토/동영상), one-month-use reviews (한달사용리뷰), repeat buyers (재구매) or the store's picks (스토어PICK).",
"default": "all"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}