SuperAPI AI Directory
Partner with us中文AI newsFavorites
Skillslinkfox-tiktok-shop-product-detail

linkfox-tiktok-shop-product-detail

Data & analytics

View repository

Updated 10-16 06:23

About this skill

TikTok Shop Product Detail Lookup

Fetch the current public detail of one TikTok Shop product by product URL or 19-digit product ID, with an optional marketplace region.

Core Concepts

  • One product per call: productInput identifies one product; this is not a search or ranking tool.
  • Marketplace context: region selects the storefront context and defaults to US.
  • Readable grouped data: the service returns a stable, readable set of product-detail groups.
  • Current snapshot: values reflect what the public storefront exposes at request time, not historical analytics.

Data Fields

Each object in data may contain these top-level groups:

Field Description
productId TikTok Shop product ID
status Platform product status code; do not infer availability from this field alone
title Product title
category Category name and ID
pricing Currency, sale price, original price, discount, and source pricing fields
sales Public sold count and related sales display data
inventory Total stock, SKUs, variant properties, prices, and default selection
media Product image URLs and image metadata
seller Seller ID, shop name, rating, location, and available shop data
reviews Public review summary when available
shipping Logistics and shipping modules when available
actions Purchase-button and favorite-state data
additional Other readable promotion, rights, review-entry, and product modules

Nested fields vary by product and region. Preserve the returned values rather than inventing missing fields.

Parameter Guide

Parameter Required Default Description
productInput Yes - TikTok HTTPS URL on tiktok.com or a subdomain, using the default HTTPS port and a path containing product/<19-digit-id>; or a 19-digit product ID passed as a string
region No US Uppercase storefront code: US, GB, ID, MY, TH, VN, PH, SG, DE, FR, IT, or ES

How to call

  • API endpoint：POST /tiktok/shop/product/detail(for complete parameters/response/error codes, see references/api.md）
  • Python script：python scripts/tiktok_shop_product_detail.py '<JSON 参数>' [--inline]
  • Cost constraints: This tool consumes compute; by default, the same parameter combination in the same session is called only once, and the script has a 24h local cache. On failure/empty results, do not automatically switch keywords, paginate, or change ZIP codes to probe continuously; if further retrieval is needed, first explain to the user that additional consumption will be incurred.

Output strategy (default script behavior)：

  • Alwayswrite the complete response to <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-tiktok-shop-product-detail-<timestamp>.json（<cwd> is the working directory when the script is executed, which in Claude Code is the current project directory;<session> is taken from the environment variable SESSION_ID, automatically aggregated according to the user's task;writing to /tmp is prohibited, if the current directory is not writable, report an error)
  • Response body ≤ 8 KB: after saving to disk, print the complete JSON to stdout
  • Response body > 8 KB: after saving to disk, stdout outputs only a summary (top-level fields, common counts such as total/costToken, length of the largest list field + first 3 samples)
  • Add --inline to force full printing to stdout (also saved to disk)

Data reading suggestions: first look at the summary to determine whether it is sufficient; when specific fields are needed, prefer using jqorConvertFrom-Json to extract on demand from the saved json file, avoiding putting the entire JSON into context.

Resolve authentication and compute issues

When the following abnormal situations occur, use references/onboarding.md to guide problem resolution:

Abnormal situation

  • API Key not configured: the environment variable is not configured LINKFOX_AGENT_API_KEY, and LINKFOXAGENT_API_KEY。
  • Response 401 or 402 status code。
  • Response indicates insufficient compute or balance: the message contains “insufficient compute balance/insufficient billing/insufficient balance/quota exceeded/insufficient balance/package expired/recharge required/please recharge” or similar meaning.

Usage Examples

Product URL

python scripts/tiktok_shop_product_detail.py '{"productInput":"https://shop.tiktok.com/view/product/1729937400435937604","region":"US"}'

Product ID for the UK storefront

python scripts/tiktok_shop_product_detail.py '{"productInput":"1729937400435937604","region":"GB"}'

Display Rules

  1. Lead with the product title, product ID, requested region, category, and returned status.
  2. Show sale/original price with the returned currency; never convert currencies unless the user asks separately.
  3. Present SKU variants, variant prices, and stock in a table when available.
  4. Render product images inline when useful, but avoid flooding the response with every image.
  5. Show seller, public sold count, review summary, and shipping information only when present.
  6. Treat status, stock, and purchase-button data together; do not call a product “available” from one field alone.
  7. Report missing, empty, or inconsistent fields as unavailable rather than estimating them.
  8. For large nested sections, summarize first and read exact fields from the saved JSON only as needed.

Important Limitations

  1. Public fields can vary by product, seller, region, and storefront context.
  2. URL inputs must include a product/<19-digit-id> path segment; use the 19-digit product ID directly when another TikTok URL format is unavailable.
  3. A product may be removed, unavailable, or out of stock and still return structured metadata.
  4. This tool does not provide historical price/stock trends, ranking lists, or guaranteed sales analytics.
  5. This tool does not manage an authorized seller account or edit listings; use the TikTok Shop ERP product skill for seller operations.
  6. The readable response can be large because SKU, media, shipping, and additional modules retain nested source fields.

User Expression & Scenario Quick Reference

Applicable — one known TikTok Shop product:

User Says Scenario
“Check the product details of this TikTok Shop link” URL detail lookup
“What does this 19-digit TikTok product ID sell?” Product ID lookup
“Look at this product's price, SKUs, and inventory” Current listing audit
“Extract this TikTok product's images and shop information” Media and seller extraction

Not applicable:

  • TikTok product search, bestseller rankings, or multi-product screening
  • Historical GMV, creator, livestream, or video-attribution analytics
  • Authorized shop listing creation, editing, price changes, or stock changes
  • TikTok video-page or creator-profile analysis

Compute consumption rules

Consumes 63 compute.

Users pay fees due to compute consumption. Repeated queries for different regions or different products are billed separately; before continuing to call, the user should be informed of the additional consumption.

Feedback:

Auto-detect and report feedback via the Feedback API when the described capability differs from actual behavior, results miss the user's intent, the user expresses praise or dissatisfaction, or the skill can be improved. Follow references/api.md without interrupting the user's flow.

For more high-quality, professional cross-border e-commerce skills, visit LinkFox Skills.