{ "openapi": "3.0.1", "info": { "title": "Naver Shopping Scraper", "description": "Scrapes Naver Shopping search results by keyword or link, plus SmartStore and Brand Store products: price, discount, seller, price-comparison seller count, category, rating, reviews, purchases, delivery fee, images and ad flag. Optional specs, options, stock and reviews.", "version": "0.0", "x-build-id": "jUztpxVXp0lbhETcd" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mina_safwat~naver-shopping-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mina_safwat-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/mina_safwat~naver-shopping-scraper/runs": { "post": { "operationId": "runs-sync-mina_safwat-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/mina_safwat~naver-shopping-scraper/run-sync": { "post": { "operationId": "run-sync-mina_safwat-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": { "searchQueries": { "title": "Search words", "type": "array", "description": "Words to search on Naver Shopping, one search per line, for example 노트북 or 나이키 운동화. Korean words give the best results. Each search returns about 80 regular products with sponsored products off, or about 90 places (roughly 35–45 sponsored) with them on: Naver's own limit for one search.", "default": [], "items": { "type": "string" } }, "startUrls": { "title": "Naver Shopping links", "type": "array", "description": "Links, one per line: a Naver Shopping search (https://search.shopping.naver.com/ns/search?query=노트북; only its search words are used, filters in the link are not applied), a SmartStore or Brand Store product (https://smartstore.naver.com//products/, https://brand.naver.com//products/) or a category link (searched by the category's name; ids Naver gives no name for are listed in FAILED_INPUTS). Price-comparison (catalog) links cannot be read because Naver shows them only after a CAPTCHA; they are listed in the FAILED_INPUTS record.", "default": [], "items": { "type": "string" } }, "maxProducts": { "title": "Max products per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Stops after this many products for each search word, search link or category. Naver shows about 80 products for one search (about 90 with sponsored products on).", "default": 40 }, "sort": { "title": "Order of search results", "enum": [ "relevance", "price_asc", "price_desc", "review_count" ], "type": "string", "description": "Naver's ranking keeps the order Naver shows. The other choices re-order the products Naver returns for the search (up to about 90) before the limit above is applied, so price, low to high gives the cheapest of those products.", "default": "relevance" }, "includeAds": { "title": "Include sponsored products", "type": "boolean", "description": "Off by default: you get about 80 regular results per search. Turn it on to also save the sponsored (ad) products Naver mixes into search results, marked with isAd. Naver then fills about 90 places, roughly 35–45 of them sponsored, and each sponsored row is billed like any other row.", "default": false }, "includeDetails": { "title": "Add product details", "type": "boolean", "description": "Adds brand, maker, model, stock, sale status, specifications, product attributes, options with extra price and stock, delivery details, review score counts and the store's name and company.", "default": false }, "includeReviews": { "title": "Add reviews", "type": "boolean", "description": "Adds the product's reviews (rating, text, date, purchased option, photos) in the order Naver ranks them.", "default": false }, "maxReviewsPerProduct": { "title": "Max reviews per product", "minimum": 1, "maximum": 300, "type": "integer", "description": "How many reviews to add to each product when reviews are on. Up to 300.", "default": 20 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave this empty: the Actor connects directly and, if Naver refuses, retries through Apify's datacenter and then Korean residential proxies on its own.", "default": { "useApifyProxy": 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 }, "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 } } } } } } } } } }