{
"openapi": "3.0.1",
"info": {
"title": "Naver Shopping Product Scraper",
"description": "Ultra-fast Naver Shopping product data scraper with advanced filtering, multi-keyword support, price range filtering, category filtering, and detailed product analytics including reviews, seller info, and delivery details.",
"version": "1.0",
"x-build-id": "pzQGqqaXiSjoNDObx"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/huggable_quote~naver-shopping-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-huggable_quote-naver-shopping-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/huggable_quote~naver-shopping-scraper/runs": {
"post": {
"operationId": "runs-sync-huggable_quote-naver-shopping-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/huggable_quote~naver-shopping-scraper/run-sync": {
"post": {
"operationId": "run-sync-huggable_quote-naver-shopping-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": [
"searchKeywords"
],
"properties": {
"searchKeywords": {
"title": "Search Keywords",
"minItems": 1,
"type": "array",
"description": "List of search keywords to scrape. Each keyword will produce a separate set of results.
Example: [\"나이키운동화\", \"아이폰15\", \"노트북\"]",
"items": {
"type": "string"
}
},
"maxPages": {
"title": "Max Pages per Keyword",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Maximum number of search result pages to scrape per keyword. Each page contains up to 40 products.
Max: 200 pages = 8,000 products per keyword.",
"default": 5
},
"maxItems": {
"title": "Max Items per Keyword",
"minimum": 0,
"type": "integer",
"description": "Limit the total number of items collected per keyword. Set to 0 for no limit (controlled by maxPages only).",
"default": 0
},
"sortBy": {
"title": "Sort Results By",
"enum": [
"rel",
"review",
"date",
"price_asc",
"price_dsc"
],
"type": "string",
"description": "How to sort the search results.",
"default": "rel"
},
"minPrice": {
"title": "Minimum Price (₩)",
"type": "integer",
"description": "Filter products with price equal to or above this value. Leave empty for no minimum."
},
"maxPrice": {
"title": "Maximum Price (₩)",
"type": "integer",
"description": "Filter products with price equal to or below this value. Leave empty for no maximum."
},
"filterByNaverPay": {
"title": "Naver Pay Products Only",
"type": "boolean",
"description": "Only include products that support Naver Pay (네이버페이).",
"default": false
},
"filterFreeShipping": {
"title": "Free Shipping Only",
"type": "boolean",
"description": "Only include products with free shipping (무료배송).",
"default": false
},
"filterByDeliveryType": {
"title": "Delivery Type",
"enum": [
"all",
"rocket",
"today",
"pickup"
],
"type": "string",
"description": "Filter by delivery type.",
"default": "all"
},
"productCondition": {
"title": "Product Condition",
"enum": [
"all",
"new",
"used",
"refurbished"
],
"type": "string",
"description": "Filter by product condition.",
"default": "all"
},
"excludeAds": {
"title": "Exclude Ad Products",
"type": "boolean",
"description": "Exclude sponsored/advertisement products from results.",
"default": false
},
"minReviews": {
"title": "Minimum Review Count",
"minimum": 0,
"type": "integer",
"description": "Only include products with at least this many reviews. Set to 0 to include all.",
"default": 0
},
"minRating": {
"title": "Minimum Rating",
"minimum": 0,
"maximum": 5,
"type": "number",
"description": "Only include products with average rating at or above this value (1.0 - 5.0). Set to 0 for no filter.",
"default": 0
},
"includeProductDetails": {
"title": "Scrape Product Detail Pages",
"type": "boolean",
"description": "Navigate to each product's detail page to extract additional data such as detailed descriptions, specifications, photo review counts, Q&A counts, delivery estimates, and more.
⚠️ Enabling this will significantly increase run time and compute usage.",
"default": false
},
"includeSellerDetails": {
"title": "Scrape Seller Details",
"type": "boolean",
"description": "Extract additional seller/store information including store rating, total products, satisfaction score, and store creation date.
⚠️ Enabling this will increase run time.",
"default": false
},
"includePriceHistory": {
"title": "Include Price Comparison",
"type": "boolean",
"description": "For group products (price comparison), extract all seller prices with their individual store info and shipping fees.",
"default": false
},
"maxConcurrency": {
"title": "Max Concurrency",
"minimum": 1,
"maximum": 10,
"type": "integer",
"description": "Maximum number of concurrent browser pages. Higher values = faster but more resource-intensive. Recommended: 3–5.",
"default": 3
},
"requestTimeout": {
"title": "Request Timeout (seconds)",
"minimum": 10,
"maximum": 300,
"type": "integer",
"description": "Maximum time to wait for each page before retrying.",
"default": 90
},
"maxRetries": {
"title": "Max Retries",
"minimum": 0,
"maximum": 10,
"type": "integer",
"description": "Maximum number of retry attempts for failed requests. Naver may block some requests, so higher values increase reliability.",
"default": 5
},
"proxyConfiguration": {
"title": "Proxy Configuration (Required)",
"type": "object",
"description": "⚠️ Proxy is REQUIRED for this actor. Naver Shopping aggressively blocks automated access. Residential proxies are strongly recommended for reliable results. Without proxies, the actor will almost certainly fail due to CAPTCHA and IP blocking."
},
"outputFormat": {
"title": "Output Dataset Fields",
"enum": [
"full",
"compact",
"minimal"
],
"type": "string",
"description": "Choose the level of detail in the output.",
"default": "full"
},
"language": {
"title": "Output Language",
"enum": [
"en",
"ko"
],
"type": "string",
"description": "Language for field labels in output metadata.",
"default": "en"
}
}
},
"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
}
}
}
}
}
}
}
}
}
}