{
  "openapi": "3.0.1",
  "info": {
    "title": "OliveYoung Global & Amore Mall Rankings + Reviews · $2/1k",
    "description": "Track K-beauty bestseller rankings on Olive Young Global (OliveYoung, 올리브영) and Amorepacific's Amore Mall (아모레몰: Sulwhasoo, Laneige, Hera…) and collect cosmetics reviews with optional AI classification — complaint types, sentiment and purchase motive in Korean, English and Japanese. No login.",
    "version": "0.1",
    "x-build-id": "sJZp42pIgYUcaItTq"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/leoworks~kbeauty-ranking-review-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-leoworks-kbeauty-ranking-review-monitor",
        "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/leoworks~kbeauty-ranking-review-monitor/runs": {
      "post": {
        "operationId": "runs-sync-leoworks-kbeauty-ranking-review-monitor",
        "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/leoworks~kbeauty-ranking-review-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-leoworks-kbeauty-ranking-review-monitor",
        "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": {
          "sources": {
            "title": "Rankings to track",
            "type": "array",
            "description": "Which bestseller rankings to collect. Leave empty to only collect reviews for the product pages below.",
            "items": {
              "type": "string",
              "enum": [
                "oliveyoung_global",
                "amoremall"
              ],
              "enumTitles": [
                "Olive Young Global bestsellers",
                "Amore Mall (Amorepacific) best ranking"
              ]
            },
            "default": [
              "oliveyoung_global"
            ]
          },
          "oliveyoungCategories": {
            "title": "Olive Young Global categories",
            "type": "array",
            "description": "Bestseller tabs to collect (one ranking per category).",
            "items": {
              "type": "string",
              "enum": [
                "all",
                "skincare",
                "makeup",
                "bath_body",
                "hair",
                "face_masks",
                "suncare",
                "kpop",
                "makeup_tools",
                "wellness",
                "supplements",
                "food_drink"
              ],
              "enumTitles": [
                "All",
                "Skincare",
                "Makeup",
                "Bath & Body",
                "Hair",
                "Face Masks",
                "Suncare",
                "K-Pop",
                "Makeup Brush & Tools",
                "Wellness",
                "Supplements",
                "Food & Drink"
              ]
            },
            "default": [
              "all"
            ]
          },
          "amoremallRankings": {
            "title": "Amore Mall ranking types",
            "type": "array",
            "description": "Amore Mall ranking tabs to collect.",
            "items": {
              "type": "string",
              "enum": [
                "best_purchased",
                "best_clicked"
              ],
              "enumTitles": [
                "Most purchased (많이 구매한)",
                "Most clicked (많이 클릭한)"
              ]
            },
            "default": [
              "best_purchased"
            ]
          },
          "amoremallCategories": {
            "title": "Amore Mall categories",
            "type": "array",
            "description": "Amore Mall categories (one ranking per category and ranking type).",
            "items": {
              "type": "string",
              "enum": [
                "all",
                "skincare",
                "cleansing",
                "makeup",
                "body",
                "hair",
                "men",
                "beauty_food",
                "fragrance",
                "tools",
                "devices"
              ],
              "enumTitles": [
                "전체 (All)",
                "스킨케어 (Skincare)",
                "클렌징 (Cleansing)",
                "메이크업 (Makeup)",
                "바디케어 (Body)",
                "헤어케어 (Hair)",
                "남성 (Men)",
                "뷰티푸드 (Beauty food)",
                "향수/디퓨저 (Fragrance)",
                "뷰티툴/소품 (Tools)",
                "뷰티디바이스 (Devices)"
              ]
            },
            "default": [
              "all"
            ]
          },
          "amoremallPeriod": {
            "title": "Amore Mall period",
            "enum": [
              "daily",
              "weekly",
              "monthly"
            ],
            "type": "string",
            "description": "Ranking period on Amore Mall.",
            "default": "daily"
          },
          "amoremallAgeGroup": {
            "title": "Amore Mall age group",
            "enum": [
              "all",
              "20s_and_under",
              "30s",
              "40s",
              "50s_and_over"
            ],
            "type": "string",
            "description": "Buyer age group for the Amore Mall ranking.",
            "default": "all"
          },
          "maxProductsPerRanking": {
            "title": "Products per ranking",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Top N products of each ranking (rankings have up to 100 products). Each product row is charged as ranking-item. The form starts at 5 for a quick first run; raise it up to 100 (default when omitted via API: 20).",
            "default": 20
          },
          "brands": {
            "title": "Only these brands",
            "type": "array",
            "description": "Optional. Keep only products of these brands (English or Korean name, e.g. COSRX, 설화수). The whole ranking (up to 100) is searched and the original rank is kept.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "productUrls": {
            "title": "Extra product pages",
            "type": "array",
            "description": "Optional. Olive Young Global or Amore Mall product pages to collect reviews for, in addition to the ranked products.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "reviewsPerProduct": {
            "title": "Reviews per product",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Reviews to collect for each product (0 = rankings only). Charged per review. The form starts at 5 for a quick first run; raise it up to 1,000 (default when omitted via API: 20).",
            "default": 20
          },
          "reviewSort": {
            "title": "Review order",
            "enum": [
              "newest",
              "helpful",
              "lowest",
              "highest",
              "oldest"
            ],
            "type": "string",
            "description": "Amore Mall supports Newest and Most helpful; other orders fall back to Newest there.",
            "default": "newest"
          },
          "classifyReviews": {
            "title": "Classify reviews with AI",
            "type": "boolean",
            "description": "Add complaint types, sentiment and purchase motive to each Korean, English or Japanese review (charged per review as review-judged).",
            "default": true
          },
          "complaintThreshold": {
            "title": "Complaint threshold",
            "minimum": 0.05,
            "maximum": 0.95,
            "type": "number",
            "description": "Minimum probability (0–1) for a complaint type to be reported.",
            "default": 0.5
          },
          "includeProductDetails": {
            "title": "Product details (Olive Young Global)",
            "type": "boolean",
            "description": "Add each Olive Young Global ranking product's information sheet as `productDetails`: full ingredient list, volume, skin type it is made for, country of manufacture, manufacturer, plus all other sheet fields. One extra request per product; no extra charge. Amore Mall rows are not covered.",
            "default": false
          },
          "rankHistoryStore": {
            "title": "Rank history store",
            "type": "string",
            "description": "Name of a key-value store in your Apify account that keeps the last snapshot of each ranking. Ranking rows then show `previousRank`, `rankChange` (positive = moved up) and `isNew` (not in the previous ranking). Run on a schedule to track movement. Use a different name per project; leave empty to turn this off. No extra charge.",
            "default": "kbeauty-ranking-history"
          },
          "maxConcurrency": {
            "title": "Max concurrency",
            "minimum": 1,
            "maximum": 10,
            "type": "integer",
            "description": "Rankings and products processed in parallel.",
            "default": 5
          },
          "residentialFallback": {
            "title": "Residential proxy fallback",
            "type": "boolean",
            "description": "Retry failing requests through Korean residential proxy.",
            "default": true
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Default Apify datacenter proxy works for both sites.",
            "default": {
              "useApifyProxy": true
            }
          },
          "healthCheck": {
            "title": "Health check mode (internal)",
            "type": "boolean",
            "description": "Internal: fail the run when results look degraded (used by the developer's scheduled checks).",
            "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}