{
  "openapi": "3.0.1",
  "info": {
    "title": "Naver Products Scraper | Shopping Prices, Sellers and Ratings",
    "description": "Naver Shopping scraper (네이버 쇼핑 크롤러): 100 products in 9 seconds, 76 fields per product. Search by keyword, search link, product link or Brand Store id and get price, discount, stock, seller, rating, reviews, shipping, category and price comparison, plus brand and model for Brand Stores. No login.",
    "version": "1.0",
    "x-build-id": "7hTYmUwtkG3CmJBc5"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/silentflow~naver-products-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-silentflow-naver-products-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/silentflow~naver-products-scraper/runs": {
      "post": {
        "operationId": "runs-sync-silentflow-naver-products-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/silentflow~naver-products-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-silentflow-naver-products-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": "What to search on Naver Shopping, one keyword per line. Korean keywords match best (<code>에어팟 프로</code>, <code>유기농 사과</code>), brand and model names work in English (<code>nike 운동화</code>, <code>iphone 16 case</code>). A popular keyword holds tens of thousands of products; each one is saved once per run.",
            "items": {
              "type": "string"
            }
          },
          "startUrls": {
            "title": "🔗 Naver Shopping links",
            "type": "array",
            "description": "Searches you already set up on Naver, one link per line: a Naver Shopping search (<code>https://search.shopping.naver.com/ns/search?query=텀블러</code> or <code>https://search.shopping.naver.com/search/all?query=캠핑+의자&minPrice=30000</code>) or a Naver search page (<code>https://m.search.naver.com/search.naver?query=가습기</code>). The order, price range, category, free shipping, fast delivery, top rated, Brand Store and official store filters of the link are kept.<br><br>Product and price comparison links work here too, as in <b>Product links or numbers</b>, and a store's address (<code>https://brand.naver.com/helinox</code>) reads the whole Brand Store.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "productUrls": {
            "title": "🛍️ Product links or numbers",
            "type": "array",
            "description": "Products to follow, one per line, each one row:<br>• a price comparison link (<code>https://search.shopping.naver.com/catalog/56987011355</code>): the product with its lowest price, its number of sellers and every store's offer,<br>• a Smart Store or Brand Store product link (<code>https://smartstore.naver.com/hansguo/products/12600640448</code>): the product with its store and page details. Copy the link that holds the store's name, not Naver's <code>smartstore.naver.com/main/products/...</code> one,<br>• a bare Naver Shopping product number or price comparison number (<code>90145151304</code>).<br><br>Ideal for tracking a fixed list of products every day. Search links and store addresses pasted here are read as searches and stores.",
            "items": {
              "type": "string"
            }
          },
          "storeIds": {
            "title": "🏬 Brand Store ids",
            "type": "array",
            "description": "Read whole Naver Brand Stores, one per line: the id in the store's address (<code>helinox</code> for brand.naver.com/helinox, <code>brickmansion</code>) or a link to the store. The run goes through the store's categories in three orders (popular, newest, most reviewed) and saves each product once, with its category path, brand, model, discounts, points, delivery promises, seller tags and the store's details.<br><br>Only Brand Stores can be read this way. A Smart Store that is not a Brand Store is reported in the log and skipped: paste its product links in <b>Product links or numbers</b>, or search its products by keyword.",
            "items": {
              "type": "string"
            }
          },
          "maxItems": {
            "title": "🔢 Max products",
            "minimum": 1,
            "type": "integer",
            "description": "How many products to save for the whole run, shared evenly across keywords, links and stores. <code>100</code> reads in a few seconds, <code>10000</code> in about half a minute without Brand Store details, seller offers or reviews.<br><br>Naver lists at most 10,000 products per order. Ask for more on one keyword and the run goes on with the other orders (best selling, most reviewed, highest and lowest price, newest) and saves only the products it has not saved yet, so a large keyword gives well over 10,000 products in one run.",
            "default": 100
          },
          "sort": {
            "title": "↕️ Order",
            "enum": [
              "REL",
              "PURCHASE",
              "REVIEW",
              "LOW_PRICE",
              "HIGH_PRICE",
              "RECENT"
            ],
            "type": "string",
            "description": "The order products are saved in, the one you see on Naver Shopping. Each row says the order it came from and its position in it. <b>Newest</b> lists only recently listed products, often a few hundred, and is never extended with the other orders.",
            "default": "REL"
          },
          "minPrice": {
            "title": "💰 Min price (KRW)",
            "minimum": 0,
            "type": "integer",
            "description": "Only products priced at or above this amount in Korean won, the price after the seller's discount, for example <code>10000</code>. Leave empty for no floor."
          },
          "maxPrice": {
            "title": "💰 Max price (KRW)",
            "minimum": 0,
            "type": "integer",
            "description": "Only products priced at or below this amount in Korean won, the price after the seller's discount, for example <code>50000</code>. With <b>Lowest price</b> the run stops as soon as prices pass it. Leave empty for no ceiling."
          },
          "freeShippingOnly": {
            "title": "🚚 Free shipping only",
            "type": "boolean",
            "description": "Only products shipped for free.",
            "default": false
          },
          "includeBrandDetails": {
            "title": "🏷️ Brand Store details",
            "type": "boolean",
            "description": "For the products of your keywords and search links sold by a Brand Store, adds 35 fields read from the product's page: full category path, brand, manufacturer and model, seller and Naver discounts, mobile price, purchase and review points, courier, delivery promises, return insurance, options, and the store's company name, grade, sales count and social links. Rows that get them say <code>hasBrandDetails: true</code>.<br><br>Each detailed product takes a moment more: turn it off for the fastest large runs. Brand Store ids and store product links always carry the details.",
            "default": true
          },
          "maxSellersPerProduct": {
            "title": "🏪 Seller offers per price comparison",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "For each product Naver lists in a price comparison (가격비교), adds the offers of the stores selling it, cheapest first: store, price, discount, shipping fee, price with shipping, rating, reviews, official store and Naver's pick. The row also gets the lowest price, the lowest price with shipping and the number of sellers.<br><br><code>30</code> covers most products, up to <code>1000</code>. <code>0</code> leaves them out; price comparison links still carry their 100 cheapest offers.",
            "default": 0
          },
          "maxReviewsPerProduct": {
            "title": "💬 Reviews per product",
            "minimum": 0,
            "type": "integer",
            "description": "Adds the buyers' reviews of each Smart Store and Brand Store product to its row: star rating, text, date, photos, purchased option, one month use and repeat purchase marks, and the seller's reply. <code>0</code> leaves them out. Products of other malls have no Naver reviews.<br><br>Each product with reviews takes a moment more: keep it small for large runs.",
            "default": 0
          },
          "reviewSort": {
            "title": "↕️ Review order",
            "enum": [
              "RANKING",
              "RECENT",
              "LOWEST_RATING",
              "HIGHEST_RATING"
            ],
            "type": "string",
            "description": "Which reviews come first, as on the product page: Naver's ranking, the newest (for a daily watch of new reviews), the lowest rated (complaints first) or the highest rated.",
            "default": "RANKING"
          },
          "debugMode": {
            "title": "🐞 Debug mode",
            "type": "boolean",
            "description": "Adds detailed lines to the run log. Leave it off for normal runs.",
            "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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}