leoworks/naver-shopping-rank-tracker
leoworks--naver-shopping-rank-trackerDestructive
This tool calls the Actor "leoworks/naver-shopping-rank-tracker" and retrieves its output results. Actor description: Naver Shopping rank tracker (네이버 쇼핑 순위, Smartstore rank tracker): organic rank 1–35, ad slot, price per keyword. Use for ranks; for blogs use leoworks/naver-blog-brand-monitor. targets = keyword + product URL/ID/store. No login, 3–10 s/keyword, rank history in your key-value store. Pay per keyword.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| targets | Yes | **REQUIRED** One entry per keyword × target. `keyword` = Korean search keyword. `match` = what to find: a product URL (smartstore.naver.com/.../products/123, brand.naver.com/..., search.shopping.naver.com/catalog/123, or your own mall's product URL), a numeric product ID (Naver product/catalog ID or smartstore product number), or a store name / smartstore slug. Leave `match` empty to just snapshot the keyword (use with Top competitors). Example values: [{"keyword":"무선이어폰","match":"브리츠 공식몰"},{"keyword":"무선이어폰","match":"https://search.shopping.naver.com/catalog/56796984706"}] | |
| 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. | |
| includeAds | No | Also report the target's position among sponsored (ad) slots as `adRank`. Example values: true | |
| outputMode | No | `full` = all fields. `minimal` = rank, price, store and title only (smaller, faster to process). Example values: "full" | full |
| healthCheck | No | Internal: fail the run when results look degraded (used by the developer's scheduled checks). | |
| maxConcurrency | No | How many keywords to check in parallel. Example values: 5 | |
| topCompetitors | No | Attach the top N organic products for each keyword (0–40). Charged per item as `competitor-item`. Attached once per keyword. | |
| rankHistoryStore | No | Name of a key-value store in your Apify account that keeps the last organic rank of each keyword × target. Each row then shows `previousOrganicRank`, `rankChange` (positive = moved up) and `isNew` (found now, not found last time). Run on a schedule to track movement. Use a different name per project; leave empty to turn this off. No extra charge. Example values: "naver-shopping-rank-history" | naver-shopping-rank-history |
| proxyConfiguration | No | Default (Apify datacenter proxy) works for most users. Example values: {"useApifyProxy":true} | |
| residentialFallback | No | If a keyword keeps failing on the default proxy, retry it through Korean residential proxy. Example values: true |
Output 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 |