# TikTok Shop Product Monitor: Prices & Reviews (`nexascout/tiktok-shop-product-monitor`) Actor Check selected US TikTok Shop products for observed prices, public sold counters, ratings, reviews and availability evidence. Export JSON or CSV and build monitoring history in your own Google Sheets workflow. - **URL**: https://apify.com/nexascout/tiktok-shop-product-monitor.md - **Developed by:** [NexaScout](https://apify.com/nexascout) (community) - **Categories:** E-commerce, Social media, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $9.00 / 1,000 useful product observations This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## TikTok Shop Product Monitor Check the products you already care about. Get current prices, public sold counters, ratings, reviews and availability evidence in a clean dataset ready for your own monitoring history. Useful for TikTok Shop researchers, affiliate creators and ecommerce teams following a selected product watchlist. Run it in Apify Console, export CSV/JSON, or connect through the API. A separate digital kit or Google Sheets connector is optional. ### Quick start 1. Open **Input**, start with the two product examples below, and replace their URLs with yours. Keep a unique, stable `watchId` for every watch entry. 2. Use **1024 MB** and one parallel check for your first run. Set a spending cap, for example **$0.10**. The two useful example targets would cost **$0.028** including the start event. 3. Run the Actor. After **SUCCEEDED**, open **Product observations** and **Run SUMMARY**. A completed run may still contain partial or unsuccessful product checks. The examples are real direct US product URLs; their values and availability can change. ```json { "schemaVersion": "1.0", "region": "US", "watchlist": [ { "watchId": "goli-001", "url": "https://shop.tiktok.com/us/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799", "label": "Goli gummies" }, { "watchId": "manspot-001", "url": "https://shop.tiktok.com/us/pdp/body-hair-trimmer-by-manspot-waterproof-ceramic-heads-ultra-smooth-shave/1730383241618035288", "label": "Manspot trimmer" } ], "maxConcurrency": 1, "navigationTimeoutSecs": 45, "maxAttemptsPerProduct": 2, "includeRawData": false } ``` Supported links include current `https://www.tiktok.com/shop/pdp/...` and legacy `https://shop.tiktok.com/us/pdp/...`. Only the **US storefront** is supported. This Actor checks selected URLs; keyword discovery is a separate workflow. ### What you receive Each completed run returns **one flat observation per watch entry** in the default dataset and a separate **SUMMARY** record in its default key-value store. All 35 observation fields are present. Missing values are `null`, not zero. The **Product observations** view highlights prices, public sold counts and reviews. **Quality and freshness** shows check status, precision and errors. Views are presentation aids; use the complete dataset when importing monitoring history. #### Example observation One illustrative row from a two-product check. Values, timestamps and example run/storage IDs below are illustrative, not a current product quote. ```json { "schemaVersion": "1.0", "recordType": "OBSERVATION", "runId": "EXAMPLE_RUN", "observationId": "9780e60ed61c61c675af1a8966418651461af0fcf0e54d8b1aebc19fa9ac9f13", "watchId": "goli-001", "watchKey": "US:1729587769570529799:PRODUCT_LEVEL", "region": "US", "requestedUrl": "https://shop.tiktok.com/us/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799", "productUrl": "https://shop.tiktok.com/us/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799", "requestedSkuId": null, "productId": "1729587769570529799", "skuId": null, "label": "Goli gummies", "productName": "Goli Ashwagandha Gummies", "sellerId": "7495794203056835079", "sellerName": "Goli Nutrition", "observedAt": "2026-10-12T16:00:00.000Z", "extractionStatus": "OK", "price": 58.47, "originalPrice": 74.1, "currency": "USD", "priceDisplay": "$58.47", "priceType": "EXACT", "discountPercent": 21.1, "rating": 4.7, "reviewCount": 71765, "salesTotal": 865595, "salesTotalDisplay": "865595", "salesCountPrecision": "EXACT", "availabilityStatus": "AVAILABLE", "dataSource": "TikTok Shop live product page", "sourceMethod": "http_embedded_json", "imageUrl": "https://p16-oec-general-useast5.ttcdn-us.com/tos-useast5-i-omjb5zjo8w-tx/b0d9acd7ae184c8d89e2e498941485b6~tplv-fhlh96nyum-crop-webp:800:800.webp?dr=12190&t=555f072d&ps=933b5bde&shp=c940a200&shcp=9b759fb9&idc=useast5&from=3376456192", "errorCode": null, "statusReason": null } ``` #### Example SUMMARY ```json { "schemaVersion": "1.0", "actorId": "6EAxcKlzd0X1nb63D", "runId": "EXAMPLE_RUN", "buildNumber": "0.1.6", "startedAt": "2026-10-12T16:00:00.000Z", "finishedAt": "2026-10-12T16:00:20.000Z", "defaultDatasetId": "EXAMPLE_DATASET", "requestedCount": 2, "uniqueTargetsCount": 2, "observationCount": 2, "okCount": 1, "partialCount": 1, "unknownCount": 0, "unavailableConfirmedCount": 0, "billableResultsCount": 2, "overallStatus": "PARTIAL", "reasonCodes": [] } ``` `SUMMARY.observationCount` counts rows. `billableResultsCount` counts useful **unique product/variant targets**, so duplicate watch entries can create more rows without additional result fees. ### Interpret quality correctly | Field / status | Meaning | |---|---| | `OK` | Identity, name, exact price, currency, rating, exact review count and sold count were captured. | | `PARTIAL` | Identity is confirmed, but some metrics are missing or ambiguous. A title-only partial record has no result fee. | | `UNKNOWN` | Current product/variant evidence could not be confirmed, or the check was skipped because of budget. It does not mean sold out or zero sales. | | `UNAVAILABLE_CONFIRMED` | The identified product or requested variant has explicit unavailable/sold-out evidence. | | `priceType=EXACT` | `price` is a confirmed numeric price for the identified target. | | `priceType=RANGE` | Keep `price=null` and use `priceDisplay`; never turn a minimum or range into an exact price. | | `salesCountPrecision=EXACT` | The source displayed a numeric public sold count. This is not a guarantee of independently audited sales. | | `salesCountPrecision=ROUNDED` | The public display is rounded; small real changes may be hidden by rounding. | | `availabilityStatus=UNKNOWN` | The page did not provide sufficient availability evidence. Price/review data alone do not prove stock. | Public sold counters may be **global, rounded or corrected**. US identifies the storefront checked; it does not establish US-only sales. The Actor does not return exact daily sales, 30-day sales, GMV, revenue, commission or guaranteed winners. Rounded review counts are omitted because the contract has no review-precision field. #### Products and variants For product-level monitoring, omit `skuId`. For a specific variant, add its exact ID **as a string** to the watch entry. The selected SKU must match current source evidence; otherwise the result is `UNKNOWN` with `VARIANT_UNCONFIRMED`. Another variant's price is never substituted. Sold/review totals remain **product-level**, even in SKU observations. Do not sum them across variants. Two watch IDs for the same product/SKU share at most one useful-result fee. Different requested SKUs are separate targets. ### Pricing and spending caps - **$0.009** per saved, identity-confirmed, useful unique product/variant observation. - **$0.01 per GB** of memory at startup, minimum one start event. - Minimum allowed spending cap: **$0.05**. This is a cap setting, not a minimum bill. A useful result is `OK` or `PARTIAL` with confirmed identity and at least one numeric price/original price, rating, exact review count or sold count. `UNKNOWN`, confirmed unavailable, duplicate targets, retries, SUMMARY and partial records without useful numeric metrics have **no result fee**. Startup fees also apply to failed/no-data runs. | Useful unique targets | Memory | Event fees | |---:|---:|---:| | 10 | 1024 MB | $0.10 | | 20 | 1024 MB | $0.19 | | 50 | 2048 MB | $0.47 | Results are saved before result charges are requested. If the cap cannot fund another useful target, remaining entries return `UNKNOWN` / `BUDGET_LIMIT`. At a $0.05 cap with 1024 MB, startup plus four useful results costs $0.046. Keep previous validated metrics for the skipped entries. The optional **$19 digital kit** is a separate one-time purchase. It does not include Actor runs. This Actor can be used independently of the kit. Public Store pricing and any additional usage terms are shown on the Actor's Pricing page. ### Memory, retries and limits Use 1–100 entries with unique `watchId` values. IDs must remain strings. Defaults: one parallel check, 45-second navigation timeout, two attempts per unique target, and extra source details off. Use **2048 MB** for two parallel checks; workloads of 10/20/50 products have been checked. The input ceiling is 100 entries; 100-product throughput has not been benchmarked. HTTP is tried first, with a browser fallback when needed. US residential proxy is the current default connection. `includeRawData=true` saves sanitized source details as separate DEBUG records in the run key-value store. It never prints those records to the run log or mixes them into the observation dataset. ### Common outcomes and next steps | Code / outcome | Next step | |---|---| | `SOURCE_BLOCKED`, `SOURCE_TIMEOUT`, `SOURCE_HTTP_ERROR`, `SOURCE_NETWORK_ERROR` | Keep the last validated metrics and try a later bounded run. | | `NO_PRODUCT_DATA` | Open the direct product URL and check that it still resolves to that product. | | `IDENTITY_MISMATCH` | Review the URL; the response points to a different product. | | `VARIANT_UNCONFIRMED` | Check the SKU ID or use product-level monitoring. | | `BUDGET_LIMIT` | Reduce the watchlist or increase your approved spending cap. | | Invalid input / failed run / missing SUMMARY | Correct the input or inspect the run status. Do not import an incomplete dataset. | `NO_DATA` in SUMMARY means the run finished its checks without usable observations. It is different from an Apify `FAILED` run. ### Export and API In the run's dataset, choose **Export** and select JSON or CSV. Export all fields for a connector. CSV blanks represent missing data, not zero; import IDs and labels as literal text. For an asynchronous API start, save the example as `input.json` and store your token privately: ```bash curl -X POST \ "https://api.apify.com/v2/actors/6EAxcKlzd0X1nb63D/runs?waitForFinish=0&memory=1024&timeout=600&maxTotalChargeUsd=0.10" \ -H "Authorization: Bearer $APIFY_TOKEN" \ -H "Content-Type: application/json" \ --data @input.json ``` Save the returned `data.id`, then poll `GET /v2/actor-runs/`. After SUCCEEDED, read: - `GET /v2/key-value-stores//records/SUMMARY` - `GET /v2/datasets//items?format=json&offset=0&limit=100&desc=false&clean=false` Read every page until the count matches SUMMARY. Keep the token in the Authorization header, never in a worksheet cell or URL. ### Use with Google Sheets or another history store Your external connector starts a run, validates **SUCCEEDED + SUMMARY + the complete dataset**, and imports idempotently by `observationId`. Re-reading a dataset must not create duplicate history. A new run produces new observation IDs; `watchKey` stays stable for the same product/SKU. Keep UTC `observedAt` values and compare compatible prices, currencies and count precision. Retain the last validated metric when a new check is UNKNOWN. A first observation is a baseline. Derive price/review/sold-counter changes from spaced history; daily growth estimates describe public-counter movement, not exact US daily sales. The Actor does **not** create a Google spreadsheet, write to Sheets, store Google credentials, maintain multi-day history, create schedules or send notifications. Those belong to your connector and account. You may save an Apify Task for your own watchlist; enabling a paid schedule is a separate choice. # Changelog This Actor's version history is a separate document: https://apify.com/nexascout/tiktok-shop-product-monitor/changelog.md # Actor input Schema ## `schemaVersion` (type: `string`): Stable Google Sheets contract version. ## `region` (type: `string`): Only the US market is supported. ## `watchlist` (type: `array`): Paste 1–100 direct US product URLs as entries with unique, stable watchId values. Add skuId as a string only for a specific variant. Replace the example URLs with your products. ## `proxyConfiguration` (type: `object`): US residential proxy is the current collector baseline. Proxy and platform costs may apply even without usable data. ## `maxConcurrency` (type: `integer`): Use 1 with 1024 MB. For 2 parallel checks, allocate 2048 MB in run options. ## `navigationTimeoutSecs` (type: `integer`): Maximum duration of one source navigation, in seconds. ## `maxAttemptsPerProduct` (type: `integer`): First attempt uses HTTP; subsequent attempts use a browser. No additional automatic source retries. ## `includeRawData` (type: `boolean`): Optional sanitized source details in separate DEBUG records. Off by default; never printed to the run log. ## Actor input object example ```json { "schemaVersion": "1.0", "region": "US", "watchlist": [ { "watchId": "goli-001", "url": "https://shop.tiktok.com/us/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799", "label": "Goli gummies" }, { "watchId": "manspot-001", "url": "https://shop.tiktok.com/us/pdp/body-hair-trimmer-by-manspot-waterproof-ceramic-heads-ultra-smooth-shave/1730383241618035288", "label": "Manspot trimmer" } ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" }, "maxConcurrency": 1, "navigationTimeoutSecs": 45, "maxAttemptsPerProduct": 2, "includeRawData": false } ``` # Actor output Schema ## `observations` (type: `string`): One flat contract 1.0 observation per watch entry; missing values remain null. ## `summary` (type: `string`): Final counts and data status. Missing for an incomplete run. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "watchlist": [ { "watchId": "goli-001", "url": "https://shop.tiktok.com/us/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799", "label": "Goli gummies" }, { "watchId": "manspot-001", "url": "https://shop.tiktok.com/us/pdp/body-hair-trimmer-by-manspot-waterproof-ceramic-heads-ultra-smooth-shave/1730383241618035288", "label": "Manspot trimmer" } ] }; // Run the Actor and wait for it to finish const run = await client.actor("nexascout/tiktok-shop-product-monitor").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "watchlist": [ { "watchId": "goli-001", "url": "https://shop.tiktok.com/us/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799", "label": "Goli gummies", }, { "watchId": "manspot-001", "url": "https://shop.tiktok.com/us/pdp/body-hair-trimmer-by-manspot-waterproof-ceramic-heads-ultra-smooth-shave/1730383241618035288", "label": "Manspot trimmer", }, ] } # Run the Actor and wait for it to finish run = client.actor("nexascout/tiktok-shop-product-monitor").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "watchlist": [ { "watchId": "goli-001", "url": "https://shop.tiktok.com/us/pdp/goli-ashwagandha-gummies-with-vitamin-d-ksm-66-vegan-non-gmo/1729587769570529799", "label": "Goli gummies" }, { "watchId": "manspot-001", "url": "https://shop.tiktok.com/us/pdp/body-hair-trimmer-by-manspot-waterproof-ceramic-heads-ultra-smooth-shave/1730383241618035288", "label": "Manspot trimmer" } ] }' | apify call nexascout/tiktok-shop-product-monitor --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,nexascout/tiktok-shop-product-monitor" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/6EAxcKlzd0X1nb63D/builds/047eucI42X4KtrTcn/openapi.json