Use case

Track TikTok Shop product prices, sales and ratings

Turn TikTok Shop product links into JSON with price, sales, rating, shop and variants, to track competitors and pick products to sell.

Prepaid, no subscriptionREST or MCPOne key for models, data and agents
TikTok Shoplovelyjsonitems[0]"title": "Portable blender 380 …"price": "19.99""sales": "12.4K sold""rating": 4.6"shop": "Brightline Home""variants": 5

TikTok Shop is where a video turns into a sale, and a product's price, sales count and rating can change within days of it going viral. If you sell the same kind of product, or you are choosing what to sell next, you need those numbers on a schedule. Lovely Router reads them for you. Send product links, get one JSON object per product, pay per product from a prepaid balance. Call it from a script, a pricing sheet or an AI agent.

Hand it to your AI agent

Copy this prompt into Claude Code, Cursor, Codex or any coding agent. It tells the agent where the docs are and how to use your API key.

Track TikTok Shop product prices, sales and ratings. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the inputs (links, keywords or accounts) and how many results you need>
01

How it works

010203
  1. Copy the link of each TikTok Shop product you track: rival listings, a supplier's items, products you are thinking of listing. The tool accepts /view/product/ and /pdp/ links.

  2. Run the tool with a cap

    Send the links in productUrls to POST /v1/tools/tiktok-shop-product/run with max_results and the store region. The run holds its maximum cost and returns the products as JSON.

  3. Store and compare

    Save each run with a date. Compare it with the last run for price changes, sales growth, rating moves and variants that vanish.

02

Get a TikTok Shop product with one request

TikTok Shop product takes product links in productUrls, each as an object with a url, and a store region. One link is one product, and one run reads up to 20:

curl https://lovelyrouter.com/v1/tools/tiktok-shop-product/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "input": {
    "productUrls": [
      {
        "url": "https://shop.tiktok.com/view/product/1731753318135730868"
      }
    ],
    "region": "US"
  },
  "max_results": 1
}'

The region sets the store country and currency. Prices are never converted, so a product from the GB store comes back in that store's currency. A run still going after 60 seconds returns 202; Run a tool shows how to poll.

03

What each product holds

Field groupWhat you get
PriceThe listed price; some stores hide it, and those rows say priceStatus=masked
DemandSales shown on the page
ReputationRating
SellerThe shop that sells the product
OptionsVariants

Supported regions are US, GB, SG, MY, TH, VN, PH, ID, MX and JP. The UK store hides price digits.

04

Recipes

Watch a rival's hero product

Run its link every morning with max_results set to 1, store price and sales, and alert on a price drop or a jump in sales.

Rank candidates by demand

Take 20 links from a category you are scouting, run them in one call, sort by sales, and look at the rating and variants of the top five.

Compare prices across stores

Run the same product in the US and the SG store with the matching region, and compare the listed prices in their own currencies.

Check a supplier's claims

Compare the sales and rating on the page with what a supplier tells you before you order stock.

Link a viral video to a product

Find a trending video with tiktok-search, open the product it promotes, and record the product's numbers weekly to see how long the lift lasts.

Prefer plain words? Connect the MCP server and tell Claude Code or Cursor: "Read these 12 TikTok Shop product links from products.txt in the US region and give me a table of price, sales, rating and shop, sorted by sales. Set max_results to 12."

06

What you pay

You pay per product: starting a run holds its maximum cost, the per-call fee plus the per-product fee times max_results, and the run settles to what it returned. The rest of the hold goes back to your balance. A run that fails or times out pays only for the products it delivered, and a run refused at the start costs nothing.

Reading 100 products is billed as 100 products. There is no subscription and no monthly minimum: top up from $5, and one balance pays for tools and models. The card above shows today's price; pricing lists every tool.

07

Frequently asked questions

?
Which TikTok Shop countries are supported?+

The region field accepts US, GB, SG, MY, TH, VN, PH, ID, MX and JP. Pick the store the product is listed in.

Are prices converted to dollars?+

No. Prices come back as the store lists them and are never converted. Convert in your own code if you compare stores.

Why does a price show as masked?+

The UK store hides price digits. Those rows say priceStatus=masked instead of giving a number.

How many products can one run read?+

Up to 20 product links per run. For a longer list, start several runs.

Do I need a subscription?+

No. You add credit to a prepaid balance and each run draws it down. Failed runs pay only for the products they delivered, and nothing renews automatically.

Looking for more? See the rest of the tool catalog and the pricing page.

One prepaid key for models, data and agents

No subscription. Top up, use what you need, see every charge in your logs.