leoworks/kbeauty-ranking-review-monitor
leoworks--kbeauty-ranking-review-monitorDestructive
This tool calls the Actor "leoworks/kbeauty-ranking-review-monitor" and retrieves its output results. Actor 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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| brands | No | 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. | |
| sources | No | Which bestseller rankings to collect. Leave empty to only collect reviews for the product pages below. Example values: ["oliveyoung_global"] | |
| waitSecs | No | Max seconds (0–45, default 30) to cap the wait for the Actor run to reach terminal state. For long-running Actors the response returns at the cap with the current run status; follow `nextStep` to poll via get-actor-run. Set to 0 to fire-and-forget. | |
| reviewSort | No | Amore Mall supports Newest and Most helpful; other orders fall back to Newest there. Example values: "newest" | newest |
| healthCheck | No | Internal: fail the run when results look degraded (used by the developer's scheduled checks). | |
| productUrls | No | Optional. Olive Young Global or Amore Mall product pages to collect reviews for, in addition to the ranked products. | |
| maxConcurrency | No | Rankings and products processed in parallel. Example values: 5 | |
| amoremallPeriod | No | Ranking period on Amore Mall. Example values: "daily" | daily |
| classifyReviews | No | Add complaint types, sentiment and purchase motive to each Korean, English or Japanese review (charged per review as review-judged). Example values: true | |
| rankHistoryStore | No | 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. Example values: "kbeauty-ranking-history" | kbeauty-ranking-history |
| amoremallAgeGroup | No | Buyer age group for the Amore Mall ranking. Example values: "all" | all |
| amoremallRankings | No | Amore Mall ranking tabs to collect. Example values: ["best_purchased"] | |
| reviewsPerProduct | No | 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). Example values: 5 | |
| complaintThreshold | No | Minimum probability (0–1) for a complaint type to be reported. Example values: 0.5 | |
| proxyConfiguration | No | Default Apify datacenter proxy works for both sites. Example values: {"useApifyProxy":true} | |
| amoremallCategories | No | Amore Mall categories (one ranking per category and ranking type). Example values: ["all"] | |
| residentialFallback | No | Retry failing requests through Korean residential proxy. Example values: true | |
| oliveyoungCategories | No | Bestseller tabs to collect (one ranking per category). Example values: ["all"] | |
| includeProductDetails | No | 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. | |
| maxProductsPerRanking | No | 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). Example values: 5 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tip | No | Advisory guidance RAG Web Browser wrote to its key-value store under the reserved "TIP" key | |
| runId | Yes | Actor run ID | |
| stats | No | Run statistics | |
| status | Yes | Run status: READY | RUNNING | TIMING-OUT | TIMED-OUT | ABORTING | ABORTED | SUCCEEDED | FAILED | |
| actorId | Yes | Stable Apify Actor ID from the run record | |
| summary | Yes | Past-tense summary of the run state | |
| exitCode | No | Actor process exit code; populated for terminal states (especially FAILED) | |
| nextStep | Yes | One primary follow-up action with identifiers interpolated | |
| storages | Yes | Dataset and key-value store metadata, keyed by alias. "default" is always the primary entry. | |
| actorName | No | "username/actor-name" | |
| startedAt | No | ISO timestamp when the run started | |
| finishedAt | No | ISO timestamp when the run finished (terminal states only) | |
| statusMessage | No | Pass-through from Apify run.statusMessage | |
| apifyConsoleUrl | No | Personalized Apify Console link to the run; present only for Console sessions |