Skip to navigation

How do I turn TikTok Shop product searches and buyer reviews into useful product questions?

To research a product category on TikTok Shop, search products in one region with tiktok.shop.web.fetch_search_products_list_v2, then read reviews of a chosen product ID with tiktok.shop.web.fetch_product_reviews_v2 in the same region. If you already have the product ID, start with the reviews. Hand off variants, usage feedback and delivery issues in separate columns, with each quote tied to the quote’s product.

For example, for yoga mats, check length and thickness before sorting feedback about storage, size or grip. If a reviewer does not state the variant, flag the review for follow-up under the same product.

1. Fix the market and the question

Use the same region in the search and the review requests. BeatAPI V2 supports US, SG, MY, PH, TH, VN, ID, JP, and MX; GB and BR are unavailable. Record the region state the response actually returns.

An unsupported region can return HTTP 200 with data.region_supported: false and the list of supported regions. Record the response as regional unavailability, not as an absence of products or reviews.

2. Search initial candidates

Call tiktok.shop.web.fetch_search_products_list_v2, for example in the US:

{
"action": "tiktok.shop.web.fetch_search_products_list_v2",
"params": {"search_word": "yoga mat", "region": "US", "offset": 0, "page_token": ""}
}

Submit the body to POST https://api.beatapi.io/v1/social-data/call with normal BeatAPI Bearer authentication. Keep the search terms, the market, the time, the original response and the request ID.

Verify the actual product, shop, variant and source before saving the product identifier, and keep the product identifier separate from video or creator IDs. Keep any returned prices, currencies, ratings and sales with their original names and units; leave missing values empty.

Product search does not return fixed top-level paths for the product list, price, sales, or shop. Do not assume data.items or metrics.sold, and do not select the top five by sales automatically. Select relevant products from the actual response first.

3. Read recent selected-product reviews

Call tiktok.shop.web.fetch_product_reviews_v2, starting with all ratings and the most recent reviews:

{
"action": "tiktok.shop.web.fetch_product_reviews_v2",
"params": {"product_id": "<confirmed_product_id>", "region": "US", "page_start": 1, "sort_rule": 2, "filter_type": 1, "filter_value": 6}
}

The V2 review input has no page_size, so record the number of reviews actually returned. The ordering and the filters define the sample; the first batch is not every historical review.

NeedV2 choice
Recent/recommended orderingsort_rule: 2 recent, 1 recommended
All ratingsfilter_type: 1, filter_value: 6
One ratingfilter_type: 1, filter_value: 1–5
Reviews with images/videosfilter_type: 2, filter_value: 1
Platform verified-purchase filterfilter_type: 3, filter_value: 1

For concrete questions, add a low-rating or media sample and keep the selection conditions. A low-rating or media sample alone does not estimate how common an issue is among all buyers. Visual analysis requires media you actually read.

4. Organize relevant findings

The table below illustrates how to classify buyer reviews:

Review directionPreserveFollow-up
Rolled mat does not fit the bagActual variant, bag information and wordingCheck dimensions and included-accessory information
Damaged packaging but usable productSeparate package and product conditionSupport/delivery review
Size fits the buyer’s spaceActual dimensions and situationConditional positive experience
Another thickness solved the problemOriginal variant, correction and outcomeCompare variants and improve selection guidance

Include the following working columns: product and market, the review’s actual identity and source, the supplied rating, the variant, the wording, the topic, the conditions, your reasoning, open items, the time and the request ID.

Match reviews across pages by actual identifiers, and keep translations separate from original wording. Leave unstated variants open. When a rating and the review text disagree, keep both for contextual review.

5. Continue while preserving scope

  1. Increment page_start by 1 when the actual response has has_more=1. Locate has_more in the returned JSON rather than assuming page.next_cursor.

  2. Keep the product, the region, the ordering and the filters unchanged, and save each new original response.

  3. Product search pages separately with offset and page_token; continue with the values the search response actually returns, not with assumed page lengths.

Before each new batch, ask whether the batch adds a variant, a condition or a correction. When you stop because of the page plan, a missing continuation, repeated content or a failure, report the stopping reason and the unfinished scope.

6. Deliver useful findings

Lead with the best-supported issues and positive experiences, each with the wording, the variant, the region and the actual sample scope. Then list product guidance, packaging and delivery, and the questions that need clarification as separate groups. Keep any rating or media filter attached to the conclusions drawn from the filtered sample.

Brief the assistant like this:

Find relevant US yoga mats, verify products/variants and read recent reviews. Separate storage, dimensions, packaging and usage experiences with wording, conditions and sources. Explain low-rating/media follow-ups and preserve their sample scope rather than estimating all-buyer proportions.

Plan the actual search and review pages with the current pricing. An automatic uniform CSV still needs local output mappings; for reading, reuse the saved original responses.

Retrieve details for selected products

If you need evidence for variants, the description or the price, pass the confirmed product_id and the same market region to tiktok.shop.web.fetch_product_detail_v3. Set region explicitly so the detail request matches the search. Record data.region_supported:false as unavailable for the requested market, and keep price, shipping, sales, and variant values only when present in the response. For inventory, orders or refunds of your own store, use your authorized seller records.