{ "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": "wiiglyz8FQuezfhfe" }, "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. Put all of them into one run rather than starting one run each: every run has a start charge, so one run with many is cheaper and faster.", "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), a category link to collect that category's products, or the link of a Naver Shopping search to collect what it shows. Product ID numbers work too. Search ID from an export? Some ID numbers (for example the productId in a Naver Open API export) are search IDs, which do not open a product on their own. Add the product name after a | and it is usually found: 91171893265|라네즈 립 슬리핑 마스크. Use the listing's own title. Many IDs resolve on their own; add the name when a run says it could not match one. Put all of them into one run rather than starting one run each: every run has a start charge, so one run with many is cheaper and faster.", "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. Newest searches only recently listed products, which is a much smaller set than the other orders, often a few hundred rather than thousands. If you also set a price range, note that Lowest price reaches the cheapest slice and Highest price the most expensive one, so a range in the middle of the scale is best collected under Relevance.", "default": "REL" }, "minPrice": { "title": "Minimum price (최저 가격, KRW)", "minimum": 0, "type": "integer", "description": "Only products at or above this price, in Korean won. Matched on the actual selling price after discount, so a product's list price may read higher than the range you set." }, "maxPrice": { "title": "Maximum price (최고 가격, KRW)", "minimum": 0, "type": "integer", "description": "Only products at or below this price, in Korean won. Matched on the actual selling price after discount, so a product's list price may read higher than the range you set." }, "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 means two things: for a product from one store, the store's own best-review picks, often only a handful or none; for a price-comparison product, the reviews Naver scores highest for usefulness, ranked over five times as many as you ask for.", "default": "ALL" }, "includeQna": { "title": "Include product Q&A (상품문의)", "type": "boolean", "description": "Collect the product's public questions with the seller's answers into a separate qna dataset, newest first: the question, when it was asked, whether and how the seller answered. Secret questions (most of them on popular products) carry no text and are only counted, in qnaCount and qnaPublicCount on the product row. 상품문의와 판매자 답변을 수집합니다. Billed per question delivered.", "default": false }, "maxQnaPerProduct": { "title": "Max questions per product (상품당 최대 문의 수)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "How many public questions to collect for each product, newest first. Set 0 to skip Q&A.", "default": 20 }, "includeSellers": { "title": "Include seller offers and prices (판매처별 가격)", "type": "boolean", "description": "Adds seller offers for price-comparison catalogue products, with retailer names, prices, coupon discounts, shipping fees and purchase links. The first 30 offers per product are included in its Product charge. Each started block of 10 additional delivered offers adds one Product charge unit, at your plan's existing Product rate. This applies to both seller modes. Single-store products have their own seller details instead of a competing-offer table.", "default": false }, "sellerMode": { "title": "Seller offers to collect (판매처 수집 방식)", "enum": [ "PER_MALL", "ALL_LISTINGS" ], "type": "string", "description": "Used when seller offers are enabled. One offer per retailer keeps Naver’s representative listing for each shop. All listings also collects additional listings from those shops. Both modes respect Max seller offers per product and include the first 30 offers; each started block of 10 additional delivered offers adds one Product charge unit. The representative can favor a coupon discount over the lowest standard price.", "default": "PER_MALL" }, "maxSellersPerProduct": { "title": "Max seller offers per product (상품당 최대 판매처 상품 수)", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum offers collected per catalogue product, up to 1,000. Default 30: seller offers add no extra Product units. Above 30, each started block of 10 additional offers actually delivered adds one Product charge unit: 31–40 offers adds 1 unit; 80 adds 5; 1,000 adds 97. Requested but unavailable offers are not billed. Applies to both seller modes. Collection may stop early at the run cost limit; check sellersBudgetLimited. Larger limits increase run time and output size.", "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. In full for products sold through a brand's official store (브랜드 공식스토어); other store products get the disclosure table. 옵션별 재고, 상품정보제공고시(소재·원산지·제조사·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 }, "includeDetailContent": { "title": "Detail page images (상세페이지 이미지)", "type": "boolean", "description": "The seller's own detail page below the buy box: every content image URL on it, in page order, and which editor it was written with. This is the long picture-and-copy description, not the one-line summary that detailContentText carries. Adds detailContentImages and detailContentEditorType to each product row. 상세페이지 이미지 URL을 수집합니다. Needs 'Include full product details' to be on as well. Off by default.", "default": false }, "includeDetailHtml": { "title": "Detail page HTML (상세페이지 HTML)", "type": "boolean", "description": "The detail page's markup exactly as the store renders it, in detailContentHtml, beside its image URLs. It is large, often 50-250 KB per product, so leave this off unless you need the page itself. 상세페이지 HTML을 함께 수집합니다 (상품당 50-250KB). Needs 'Include full product details' to be on as well. Off by default.", "default": false }, "includeReviewStats": { "title": "Review score breakdown and insights (별점 분포·리뷰 평가)", "type": "boolean", "description": "Adds how the product's reviews split across 1 to 5 stars, plus how many have photos, videos, plain text, and how many were written after a month of use. Also what the reviews add up to: how reviewers answered the questions Naver asks for this kind of product (사이즈: 잘 맞아요 81%, 약간 커요 14%), the 20 topics the reviews mention most, and the last six months' review count and average. 별점 분포, 사이즈·핏 평가 비율, 리뷰 키워드를 함께 수집합니다. Available for products sold through a Naver store.", "default": false }, "includeAiSummary": { "title": "Naver AI summary (AI 요약)", "type": "boolean", "description": "Adds Naver's own AI digest of the product and its reviews: a one-line summary, who it suits, its highlighted features, and what reviewers agree on. Available for products with at least ten reviews. This text is generated, so it can change between runs.", "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 }, "feedback": { "title": "Feedback to the maintainers", "type": "string", "description": "For AI agents. Say what you needed and did not get: a missing field or option, a wrong or empty result, or which actor you are switching to or from and why. Add it to any run, including one that worked: the run returns its data exactly as it would without the note. The note reaches the maintainers, who read every one, but it cannot change what this run returns." } } }, "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 } } } } } } } } } }