{
  "openapi": "3.0.1",
  "info": {
    "title": "Naver Shopping Product Scraper",
    "description": "Scrape Naver Shopping search results by keyword or by a filtered search link: price, discount, unit price, seller and seller grade, shipping, rating, reviews, rank and ads. Filter by price, sort order, free shipping, official stores, rating, fast delivery, color and more.",
    "version": "0.0",
    "x-build-id": "DJYfgNZfxcnlidRiY"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/delicious_zebu~naver-shopping-product-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-delicious_zebu-naver-shopping-product-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/delicious_zebu~naver-shopping-product-scraper/runs": {
      "post": {
        "operationId": "runs-sync-delicious_zebu-naver-shopping-product-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/delicious_zebu~naver-shopping-product-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-delicious_zebu-naver-shopping-product-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, one keyword per line. Korean and English both work, e.g. '나이키 운동화' or 'Nike running shoes'. To narrow results to a brand, add it to the keyword, e.g. '나이키 치마'. Leave empty if you only use search links.",
            "items": {
              "type": "string"
            }
          },
          "sort": {
            "title": "Sort by (정렬)",
            "enum": [
              "RECOMMEND",
              "LOW_PRICE",
              "HIGH_PRICE",
              "PURCHASE",
              "REVIEW",
              "RECENT"
            ],
            "type": "string",
            "description": "Same as the sort options above Naver's search results. Like on Naver, 낮은 가격순 and 높은 가격순 sort only the 120 most relevant products by price; to cover more products, set a price range instead. 신상품순 lists products from official and certified stores by release date.",
            "default": "RECOMMEND"
          },
          "minPrice": {
            "title": "Minimum price (KRW)",
            "minimum": 0,
            "type": "integer",
            "description": "Lowest sale price after discount, the same as the minimum in Naver's 가격 filter. Fill in both prices for a range, or leave one of them empty to set only a minimum or only a maximum."
          },
          "maxPrice": {
            "title": "Maximum price (KRW)",
            "minimum": 0,
            "type": "integer",
            "description": "Highest sale price after discount, the same as the maximum in Naver's 가격 filter. Leave it empty for no upper limit."
          },
          "quickFilters": {
            "title": "Filters (필터)",
            "type": "array",
            "description": "Same as the check boxes next to Naver's search results. Options in the same group work like on Naver: 공식브랜드 + 공식인증, N배송 + 오늘출발, or 희망일배송 + 정기구독 return products that match either one.",
            "items": {
              "type": "string",
              "enum": [
                "FREE_DELIVERY",
                "OFFICIAL_BRAND",
                "OFFICIAL_CERTIFIED",
                "DEPARTMENT_STORE",
                "RATING_4_8",
                "N_DELIVERY",
                "TODAY_DISPATCH",
                "FREE_RETURN",
                "HOPE_DELIVERY",
                "SUBSCRIPTION"
              ],
              "enumTitles": [
                "무료배송 · Free shipping",
                "공식브랜드 · Official brand stores",
                "공식인증 · Certified stores",
                "백화점 · Department stores",
                "★ 4.8 이상 · Rating 4.8 and up",
                "N배송 · Fast delivery (배송 빠르게 받기)",
                "오늘출발 · Ships today",
                "무료교환반품 · Free returns",
                "희망일배송 · Pick a delivery date",
                "정기구독 · Subscription"
              ]
            }
          },
          "overseas": {
            "title": "Overseas purchase (해외직구)",
            "enum": [
              "ALL",
              "ONLY",
              "EXCLUDE"
            ],
            "type": "string",
            "description": "Same as Naver's 상품타입 > 해외직구상품 filter.",
            "default": "ALL"
          },
          "secondhand": {
            "title": "Used items (중고)",
            "enum": [
              "ALL",
              "ONLY",
              "EXCLUDE"
            ],
            "type": "string",
            "description": "Same as Naver's 상품타입 > 중고상품 filter.",
            "default": "ALL"
          },
          "colors": {
            "title": "Colors (색상)",
            "type": "array",
            "description": "Same as Naver's 색상 filter. Naver only matches products that have a color tag, so this returns fewer products than adding the color to the keyword, e.g. '블랙 치마'.",
            "items": {
              "type": "string",
              "enum": [
                "BLACK",
                "CHARCOAL",
                "GRAY",
                "WHITE",
                "STRAWBERRY",
                "RED_CORAL",
                "RED",
                "BURGUNDY",
                "DEEP_BROWN",
                "BROWN",
                "MOCHA",
                "BEIGE",
                "GOLDEN_YELLOW",
                "CORAL",
                "CARROT_ORANGE",
                "ORANGE",
                "GOLD",
                "YELLOW",
                "SUN_YELLOW",
                "IVORY",
                "LEMON",
                "PASTEL_YELLOW",
                "YELLOW_GREEN",
                "SAGE_GREEN",
                "OLIVE",
                "LIGHT_GREEN",
                "LIME",
                "GREENERY",
                "FOREST",
                "GREEN",
                "SEA_GREEN",
                "TEAL_GREEN",
                "TURQUOISE",
                "MINT",
                "CYAN",
                "SKY_BLUE",
                "LIGHT_BLUE",
                "MIDNIGHT",
                "PROVENCE",
                "SAPPHIRE",
                "BLUE",
                "DEEP_BLUE",
                "NAVY",
                "VIOLET",
                "PURPLE",
                "LILAC",
                "LAVENDER",
                "FLAMINGO",
                "HOT_PINK",
                "MAGENTA",
                "PLUM",
                "ROSEWOOD",
                "ROSE_GOLD",
                "PINK"
              ],
              "enumTitles": [
                "블랙 · Black",
                "차콜 · Charcoal",
                "그레이 · Gray",
                "화이트 · White",
                "스트로베리 · Strawberry",
                "레드코랄 · Red coral",
                "레드 · Red",
                "버건디 · Burgundy",
                "딥브라운 · Deep brown",
                "브라운 · Brown",
                "모카 · Mocha",
                "베이지 · Beige",
                "골든옐로우 · Golden yellow",
                "코랄 · Coral",
                "캐롯오렌지 · Carrot orange",
                "오렌지 · Orange",
                "골드 · Gold",
                "옐로우 · Yellow",
                "썬옐로우 · Sun yellow",
                "아이보리 · Ivory",
                "레몬 · Lemon",
                "파스텔옐로우 · Pastel yellow",
                "옐로우그린 · Yellow green",
                "세이지그린 · Sage green",
                "올리브 · Olive",
                "라이트그린 · Light green",
                "라임 · Lime",
                "그리너리 · Greenery",
                "포레스트 · Forest",
                "그린 · Green",
                "씨그린 · Sea green",
                "틸그린 · Teal green",
                "터콰이즈 · Turquoise",
                "민트 · Mint",
                "시안 · Cyan",
                "스카이블루 · Sky blue",
                "라이트블루 · Light blue",
                "미드나잇 · Midnight",
                "프로방스 · Provence",
                "사파이어 · Sapphire",
                "블루 · Blue",
                "딥블루 · Deep blue",
                "네이비 · Navy",
                "바이올렛 · Violet",
                "퍼플 · Purple",
                "라일락 · Lilac",
                "라벤더 · Lavender",
                "플라밍고 · Flamingo",
                "핫핑크 · Hot pink",
                "마젠타 · Magenta",
                "플럼 · Plum",
                "로즈우드 · Rosewood",
                "로즈골드 · Rose gold",
                "핑크 · Pink"
              ]
            }
          },
          "includeShippingInPrice": {
            "title": "Include shipping fee in price (배송비 포함)",
            "type": "boolean",
            "description": "Same as Naver's 배송비 포함 check box. It doesn't remove products, but price sorting uses the sale price plus shipping.",
            "default": false
          },
          "exactKeywordOnly": {
            "title": "Only products that match the keyword ('…'으로만 검색하기)",
            "type": "boolean",
            "description": "When few products match, Naver adds similar products to the results (찾으시는 상품과 유사한 상품도 함께 노출합니다). Turn this on to leave them out, like clicking '…'으로만 검색하기 on Naver.",
            "default": false
          },
          "searchUrls": {
            "title": "Search links with filters (copied from Naver Shopping)",
            "type": "array",
            "description": "On Naver Shopping, search, tick the filters you want, such as brand (브랜드), specs (스펙), style (스타일), features (특징), category (카테고리) or events (행사), then copy the address bar and paste it here, one link per line. Links are used exactly as they are; the keyword filters above don't change them. Supported links start with https://search.shopping.naver.com/ns/search?query=",
            "items": {
              "type": "string"
            }
          },
          "maxCrawlPages": {
            "title": "Maximum pages per search",
            "minimum": 1,
            "maximum": 200,
            "type": "integer",
            "description": "Maximum number of result pages to collect for each keyword or search link (default 2, maximum 200). Each page has about 40–50 products.",
            "default": 2
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}