{ "openapi": "3.0.1", "info": { "title": "Naver Shopping Scraper (네이버쇼핑) - Prices, Specs & Reviews", "description": "Extract Naver Shopping products by keyword, link or category: prices, discounts, stock, ratings, review counts, sellers and images. 111 fields per product, plus specification tables, every seller's price, six months of price history, and reviews with photos. Export to JSON, CSV or Excel.", "version": "0.0", "x-build-id": "frGjpebMsP0feYBkf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/zen-studio~naver-shopping-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-zen-studio-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/zen-studio~naver-shopping-scraper/runs": { "post": { "operationId": "runs-sync-zen-studio-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/zen-studio~naver-shopping-scraper/run-sync": { "post": { "operationId": "run-sync-zen-studio-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", "properties": { "keywords": { "title": "Search keywords (검색 키워드)", "type": "array", "description": "What to search for on Naver Shopping. Korean terms return the richest results (e.g. 노트북 for laptops), but English works too. Each keyword is searched separately.", "items": { "type": "string" } }, "productUrls": { "title": "Product or category links (상품·카테고리 링크)", "type": "array", "description": "Scrape specific products instead of, or in addition to, searching. Paste any Naver Shopping product link (price-comparison or store page), or a category link to collect that category's products. Product ID numbers work too.", "items": { "type": "string" } }, "maxProductsPerKeyword": { "title": "Max products per keyword (키워드당 최대 상품 수)", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many products to collect for each keyword. Naver serves at most 10,000 products per keyword, so use several keywords, price ranges or sort orders to go beyond that.", "default": 100 }, "sort": { "title": "Sort results by (정렬 기준)", "enum": [ "REL", "LOW_PRICE", "HIGH_PRICE", "REVIEW", "RECENT", "PURCHASE" ], "type": "string", "description": "The order Naver returns products in. Each order reaches a different slice of the catalogue, so switching it is also a way to collect more than 10,000 products for one keyword.", "default": "REL" }, "minPrice": { "title": "Minimum price (최저 가격, KRW)", "minimum": 0, "type": "integer", "description": "Only products at or above this price, in Korean won." }, "maxPrice": { "title": "Maximum price (최고 가격, KRW)", "minimum": 0, "type": "integer", "description": "Only products at or below this price, in Korean won." }, "categories": { "title": "Categories (카테고리)", "type": "array", "description": "Only keep products in these Naver categories. Pick from the list or paste any category ID. Every result this Actor returns carries its category IDs (lCatId, mCatId, sCatId, ssCatId), so you can run once and filter next time. A product matching at any level is kept.", "items": { "type": "string", "enumSuggestedValues": [ "50000003", "50000001", "50000006", "50000004", "50000002", "50000008", "50000007", "50000005", "50000000", "50000167", "50000174", "50000148", "50000105", "50001466", "50003854", "50000210", "50000101", "50001234", "50001238", "50003675", "50000100", "50001228", "50003215", "50000113", "50001136", "50003514", "50000212", "50001421", "50000151", "50000153", "50001408", "50000208", "50001395", "50000209", "50024379", "50000213", "50001430", "50000094", "50001204", "50015460", "50000204", "50000064", "50002057", "50000072", "50001938", "50000155", "50000078", "50000911", "50000029", "50001102", "50002668", "50000031", "50001527", "50000161", "50001108", "50000028", "50001099", "50002651", "50000023", "50001090", "50002425", "50000160", "50001052", "50004749", "50013960", "50013961", "50013941", "50022619", "50002032", "50001081", "50000116", "50000115", "50000142", "50001154", "50004212", "50000121", "50000686", "50021359", "50021479", "50000807", "50000803", "50000186", "50001487", "50000189", "50001490", "50000179", "50000195", "50000391", "50000191", "50000445", "50000190", "50000440", "50000200", "50000198", "50002558", "50016720", "50000173", "50002114", "50015660", "50024439", "50015700", "50000108", "50000176", "50001239", "50001119", "50000297", "50000205", "50001378", "50002932", "50004596", "50016800", "50001472", "50002509", "50022500", "50003985", "50003244", "50023979", "50023960", "50006630", "50000854" ], "enumTitles": [ "디지털/가전", "패션잡화", "식품", "가구/인테리어", "화장품/미용", "생활/건강", "스포츠/레저", "출산/육아", "패션의류", "패션의류 > 여성의류", "패션잡화 > 남성신발", "식품 > 음료", "가구/인테리어 > 서재/사무용가구", "패션잡화 > 남성신발 > 스니커즈/운동화", "패션잡화 > 남성신발 > 스니커즈/운동화 > 러닝화", "디지털/가전 > 생활가전", "가구/인테리어 > 거실가구", "가구/인테리어 > 거실가구 > 소파", "가구/인테리어 > 서재/사무용가구 > 책상", "가구/인테리어 > 서재/사무용가구 > 책상 > 일자형 책상", "가구/인테리어 > 침실가구", "가구/인테리어 > 침실가구 > 침대", "가구/인테리어 > 침실가구 > 침대 > 침대프레임", "가구/인테리어 > 커튼/블라인드", "가구/인테리어 > 커튼/블라인드 > 커튼", "가구/인테리어 > 커튼/블라인드 > 커튼 > 거실용커튼", "디지털/가전 > 계절가전", "디지털/가전 > 계절가전 > 에어컨", "디지털/가전 > 노트북", "디지털/가전 > 모니터", "디지털/가전 > 생활가전 > 세탁/건조기", "디지털/가전 > 영상가전", "디지털/가전 > 영상가전 > TV", "디지털/가전 > 음향가전", "디지털/가전 > 음향가전 > 이어폰/이어셋", "디지털/가전 > 주방가전", "디지털/가전 > 주방가전 > 냉장고", "디지털/가전 > 주변기기", "디지털/가전 > 주변기기 > 키보드", "디지털/가전 > 청소기", "디지털/가전 > 휴대폰", "생활/건강 > 건강관리용품", "생활/건강 > 건강관리용품 > 먼지차단마스크", "생활/건강 > 구강위생용품", "생활/건강 > 구강위생용품 > 칫솔", "생활/건강 > 반려동물", "생활/건강 > 생활용품", "생활/건강 > 생활용품 > 세제/세정제", "스포츠/레저 > 골프", "스포츠/레저 > 골프 > 골프클럽", "스포츠/레저 > 골프 > 골프클럽 > 드라이버", "스포츠/레저 > 요가/필라테스", "스포츠/레저 > 요가/필라테스 > 요가매트", "스포츠/레저 > 자전거", "스포츠/레저 > 자전거 > 자전거/MTB", "스포츠/레저 > 캠핑", "스포츠/레저 > 캠핑 > 텐트", "스포츠/레저 > 캠핑 > 텐트 > 3-4인용", "식품 > 건강식품", "식품 > 건강식품 > 비타민제", "식품 > 건강식품 > 비타민제 > 멀티비타민", "식품 > 농산물", "식품 > 농산물 > 쌀", "식품 > 농산물 > 쌀 > 백미", "식품 > 라면/면류", "식품 > 라면/면류 > 라면", "식품 > 라면/면류 > 라면 > 봉지라면", "식품 > 스낵/과자", "식품 > 음료 > 생수", "식품 > 음료 > 커피", "출산/육아 > 기저귀", "출산/육아 > 분유", "출산/육아 > 완구/인형", "출산/육아 > 완구/인형 > 작동완구", "출산/육아 > 완구/인형 > 작동완구 > 자동차", "출산/육아 > 유모차", "출산/육아 > 유모차 > 초경량/휴대용", "패션의류 > 여성의류 > 아우터", "패션의류 > 여성의류 > 아우터 > 기타코트", "패션의류 > 여성의류 > 원피스", "패션의류 > 여성의류 > 티셔츠", "패션잡화 > 시계", "패션잡화 > 시계 > 패션시계", "패션잡화 > 주얼리", "패션잡화 > 주얼리 > 귀걸이", "패션잡화 > 지갑", "화장품/미용 > 색조메이크업", "화장품/미용 > 색조메이크업 > 립스틱", "화장품/미용 > 선케어", "화장품/미용 > 선케어 > 선크림", "화장품/미용 > 스킨케어", "화장품/미용 > 스킨케어 > 크림", "화장품/미용 > 향수", "화장품/미용 > 헤어케어", "디지털/가전 > 주방가전 > 냉장고 > 양문형냉장고", "출산/육아 > 기저귀 > 일회용기저귀", "패션잡화 > 여성신발", "디지털/가전 > 영상가전 > TV > LEDTV", "디지털/가전 > 청소기 > 무선청소기", "디지털/가전 > 음향가전 > 이어폰/이어셋 > 무선이어폰/이어셋", "디지털/가전 > 청소기 > 무선청소기 > 핸디청소기", "가구/인테리어 > 인테리어소품", "패션잡화 > 여성가방", "가구/인테리어 > 서재/사무용가구 > 의자", "가구/인테리어 > 인테리어소품 > 조명", "화장품/미용 > 헤어케어 > 샴푸", "디지털/가전 > 휴대폰액세서리", "디지털/가전 > 휴대폰액세서리 > 휴대폰보호필름", "디지털/가전 > 주변기기 > 키보드 > 무선키보드", "디지털/가전 > 휴대폰액세서리 > 휴대폰보호필름 > 전신보호필름", "출산/육아 > 기저귀 > 일회용기저귀 > 팬티형", "패션잡화 > 지갑 > 남성지갑", "생활/건강 > 생활용품 > 세제/세정제 > 세탁세제", "식품 > 스낵/과자 > 일반스낵", "패션잡화 > 지갑 > 남성지갑 > 반지갑", "가구/인테리어 > 거실가구 > 소파 > 패브릭소파", "패션잡화 > 남성신발 > 구두", "패션잡화 > 남성신발 > 구두 > 구두", "생활/건강 > 반려동물 > 강아지 사료", "출산/육아 > 분유 > 국내분유" ] } }, "makerName": { "title": "Manufacturer (제조사)", "type": "string", "description": "Only products from one manufacturer, e.g. 삼성전자 (Samsung Electronics). Pick a suggestion or type any manufacturer name. This is the company that makes the product; for a specific product line use Brand below." }, "brandName": { "title": "Brand or product line (브랜드·시리즈)", "type": "string", "description": "Only products from one brand or product line, e.g. 갤럭시북4 (Galaxy Book 4). On Naver a brand is usually narrower than a manufacturer: 삼성전자 is the manufacturer, 갤럭시북4 is the brand." }, "includeDetail": { "title": "Include full product details (상품 상세정보)", "type": "boolean", "description": "Adds the full specification table, brand and manufacturer, every product image, the lowest price across all sellers and the seller count. Products Naver lists in its price comparison come back with the complete comparison record; products sold by a single store come back with that seller's own detail (all images, promotions, delivery and category path), so every product is enriched.", "default": true }, "includeReviews": { "title": "Include customer reviews (구매평)", "type": "boolean", "description": "Collects review text, star ratings, photos, videos and the purchased option. Reviews are written to a separate reviews dataset, linked to products by productId (and by catalogId where the product has a catalogue entry).", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product (상품당 최대 구매평 수)", "minimum": 0, "maximum": 50000, "type": "integer", "description": "How many reviews to collect for each product. Price-comparison products serve at most 10,000 per review order; store products have no such limit. Set 0 to skip reviews.", "default": 20 }, "reviewSort": { "title": "Review order (구매평 정렬)", "enum": [ "RANKING", "RECENT" ], "type": "string", "description": "Which reviews to collect first. Newest first reaches a completely different set from Top ranked, so it is also the way to collect more than 10,000 reviews for one price-comparison product.", "default": "RANKING" }, "reviewType": { "title": "Review type (구매평 유형)", "enum": [ "ALL", "PHOTO", "VIDEO", "QUALITY" ], "type": "string", "description": "Limit reviews to a particular kind. Detailed reviews returns the ones the source itself scores highest for usefulness.", "default": "ALL" }, "includeSellers": { "title": "Include all sellers and their prices (판매처별 가격)", "type": "boolean", "description": "For each product, every shop selling it with its own price, card and coupon discounts, delivery cost and shop rating. Useful for price comparison and for finding the cheapest seller.", "default": false }, "maxSellersPerProduct": { "title": "Max sellers per product (상품당 최대 판매처 수)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "How many sellers to list for each product.", "default": 30 }, "includeSellerRecord": { "title": "Seller's full product record (판매자 상품정보)", "type": "boolean", "description": "The seller's own record for a product: every option with the stock left for it, the mandated disclosure table (materials, country of origin, manufacturer, warranty), how fast this seller actually ships, and after-sales terms. Available for products sold through a brand's official store (브랜드 공식스토어). 옵션별 재고, 상품정보제공고시(소재·원산지·제조사·A/S), 배송 소요일 통계를 함께 수집합니다. It is a heavier request than the rest, so a run with many matching products takes somewhat longer. Off by default. 브랜드 공식스토어 상품이 많은 검색어의 경우 실행 시간이 다소 길어집니다.", "default": false }, "includePriceHistory": { "title": "Include price history (가격 변동 이력)", "type": "boolean", "description": "Daily price points over roughly the past six months, for tracking how a product's price moved.", "default": false } } }, "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 } } } } } } } } } }