{ "openapi": "3.0.1", "info": { "title": "Naver Shopping Scraper: Prices, Malls, Reviews", "description": "Scrape Naver Shopping (네이버쇼핑) by keyword: one row per product with price, discount, mall, category path, reviews, rating, purchases, delivery and an ad flag. Sort by relevance or price, filter by price. No login, no API key.", "version": "0.1", "x-build-id": "eZOeYImBVN5ZEy0Pj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/themineworks~naver-shopping-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-themineworks-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/themineworks~naver-shopping-scraper/runs": { "post": { "operationId": "runs-sync-themineworks-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/themineworks~naver-shopping-scraper/run-sync": { "post": { "operationId": "run-sync-themineworks-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": "Keywords", "type": "array", "description": "Product keywords, one per line, in Korean or English, as you would type them in Naver. Example: 노트북, 무선 이어폰, 다이슨 에어랩. Korean keywords usually match more products. Up to 100 keywords per run.", "items": { "type": "string" } }, "maxItems": { "title": "Max products per keyword", "minimum": 1, "maximum": 5000, "type": "integer", "description": "The most products to return for each keyword, 1 to 5,000. One call returns up to 90 cards; past that the actor splits the price range into bands to reach more. Example: 300.", "default": 50 }, "sort": { "title": "Sort", "enum": [ "relevance", "price_asc", "price_desc" ], "type": "string", "description": "relevance: Naver's own order (네이버 랭킹순). price_asc: cheapest first. price_desc: most expensive first. Newest and most reviewed are not offered on the surface this actor reads.", "default": "relevance" }, "minPrice": { "title": "Min price (KRW)", "minimum": 0, "type": "integer", "description": "Only products priced at or above this, in won. Naver applies it before answering. Example: 500000." }, "maxPrice": { "title": "Max price (KRW)", "minimum": 0, "type": "integer", "description": "Only products priced at or below this, in won. Example: 1500000." }, "includeAds": { "title": "Include sponsored products", "type": "boolean", "description": "On: paid placements (광고) are returned too, with is_ad true. Off: only organic listings and price comparison catalogs.", "default": true }, "includeCategoryNames": { "title": "Category names", "type": "boolean", "description": "On: each row gets its full category path in Korean, for example 디지털/가전 > 노트북. Off: category ids only, slightly faster.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Naver's main search answers the Apify datacenter pool, so the default is fine. Turn the proxy off to send requests straight from the run, or pick residential (country KR) if Naver ever refuses the run.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }