{
  "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": "1FjZR1TlKP08bvO8u"
  },
  "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 pages work too: <code>https://smartstore.naver.com/brickmansion/products/12638820624</code> or the same on <code>brand.naver.com</code> gives one row with the Brand Store details. A store's address (<code>https://brand.naver.com/helinox</code>) reads the whole store. Product pages of Smart Stores that are not Brand Stores, and price comparison pages, are reported in the log and skipped.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "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: search its products by keyword instead.",
            "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.<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 product links always carry the details.",
            "default": true
          },
          "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}