# TikTok Shop scraper API with Gemini: find the 1688 wholesaler

> TikTok Shop sourcing with Gemini: 1688 image search on video covers found the same item for 4 of 6 products, sold locally at 3.6–4.0x cost.

- Canonical page: https://everyinfra.com/en/blog/tiktok-shop-scraper-api
- Published: 2026-11-18T02:06:00+08:00 · Fact-checked: 2026-11-18T01:53:00+08:00

From 00:14 to 01:33 Singapore time on November 18, 2026, we ran a sourcing chain on EveryInfra. It went from TikTok Shop best-seller lists in Southeast Asia to 1688 image search for the same item, and then to the markup. Three TikTok Shop capabilities (best-sellers, category products and shop search) plus one MCP call returned 503 on all 70 calls and charged nothing. So we took Malaysian and Philippine shopping videos from TikTok video search and sent the covers of 6 products to 1688 image search.

13 of the 30 candidates were the same item, and 4 of the 6 products had at least one same-item match. In Malaysia, the median Shopee and Lazada retail prices for similar flying fairy toys and massage slippers were 4.0 and 3.6 times the 1688 cost. Grey wide-leg sweatpants in the Philippines reached only 1.7 times. A handheld fan that also takes photos matched only plain fans in image search. The Chinese keyword for "camera fan" found the 2-in-1 product, at more than 5 times the price.

> **Key points**
>
> - The chain has four steps: TikTok Shop best-seller list (`tiktok/shop_hot_products`, 0.000806 USD per call), 1688 image search (0.005556 USD), keyword search on 1688 and Taobao, and the markup after currency conversion. Gemini 4 Hydrogen calls the APIs through remote MCP, compares images and fills in a sheet that follows a JSON Schema.
> - During the test, the best-seller list returned 503 every time and charged nothing. Image search on 6 products from `tiktok/search` video covers returned 30 candidates. 13 (43%) were the same item, against 60% with product photos in an earlier test.
> - Markup (median Shopee and Lazada retail price of similar items ÷ 1688 cost of the same item): fairy toy 4.0, slippers 3.6, sweatpants 1.7. For an LED ring desk fan, neither side matched, so its 0.85 is not usable.
> - Image search cannot see function. A fan that takes photos matched plain fans (median 17 CNY, about 2.55 USD); a keyword with the function word gave a median of 98 CNY (about 14.70 USD).
> - Per 100 products: about 0.84 USD of EveryInfra data, and about 0.42 USD of Gemini with 300 px thumbnails and the Batch API. All live calls in this article cost 0.0574 USD.

Gemini makes the decisions in the chain. It picks the candidate image that shows the same item, writes the Chinese keyword and fills in the sheet. The Gemini code in this article is a configuration example; we did not run it on Gemini. Every number on the data side comes from real calls in the time window above. One author labelled the matches by eye, with rules written in advance.

## The sourcing chain has four steps

![Diagram: on the left, a phone screen shows a list of products; an arrow points to two product images side by side being compared, then to a sparkle mark, and on the right to a filled-in table.](https://everyinfra.com/articles/tiktok-shop-scraper-api/img-sourcing-flow.webp)

The four steps of the sourcing chain: best-seller list, image search, keyword search, markup. The model does the comparison and fills in the sheet. [Drawn by EveryInfra](https://everyinfra.com)

| Step | Capability | Cost per call (USD) | What you get |
| --- | --- | --- | --- |
| 1 Best-seller list | `tiktok/shop_hot_products` | 0.000806 | 20 products: price, total sold, image address |
| 2 Same-item image search | `alibaba1688/image_search` | 0.005556 | 5 candidates on 1688: list price, minimum order, seller name |
| 3 Keyword search for similar items | `alibaba1688/search`, `taobao/search` | 0.002778, 0.0135 | Wholesale and retail price spread of similar products |
| 4 Markup | No API call | 0 | Markup for each product |

The [TikTok data API](/tiktok-api), [1688 data API](/alibaba1688-api) and [Taobao data API](/taobao-api) pages describe these capabilities and let you try them online. The capability pages are [TikTok Shop best-sellers](/tiktok-api/shop_hot_products), [TikTok Shop category products](/tiktok-api/shop_category_products), [1688 image search](/alibaba1688-api/image_search), [1688 keyword search](/alibaba1688-api/search) and [Taobao search](/taobao-api/search).

## TikTok Shop scraper API: the best-seller endpoint and this 503

`tiktok/shop_hot_products` returns the best-seller list of one TikTok Shop market. It takes only two parameters, `country` and `limit`. The catalog lists 8 markets: Indonesia, Japan, Mexico, Malaysia, the Philippines, Singapore, Thailand and Vietnam, with Malaysia as the default. `limit` goes up to 100; we use 20, at 0.000806 USD per call ([EveryInfra catalog: TikTok](https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok)).

The other entry point, `tiktok/shop_category_products`, returns products by category ID, about 15 per page, with `page_token` for the next page. It also works for the US store and suits a long watch on one category. We chose Malaysia, the Philippines, Thailand and Vietnam. Sellers can ship to all four directly from China or from a local warehouse. We left out Indonesia because of the 100 USD FOB minimum described later.

In the catalog `response_fields`, each product row carries `rank`, `id`, `url`, `name`, `price`, `original_price`, `currency`, `sold_count`, `rating`, `review_count`, `shop_name`, `shop_id` and `image_url`. Sourcing needs three of them: `price` and `currency` for the selling price, `sold_count` for volume, and `image_url` for image search. Prices are in local currency (ringgit, pesos, baht and dong), so you must convert them to one currency before you compare.

### This run: the best-seller list never came back

We started at 00:14 Singapore time on November 18, 2026, with 20 products each from Malaysia, the Philippines, Thailand and Vietnam. To check whether only some markets were affected, we also tried Singapore and Indonesia, as well as `tiktok/shop_category_products` (the beauty category in Malaysia and the US) and `tiktok/shop_search`. By the last call at 01:33 we had made 70 calls, including one MCP call. Every call returned HTTP 503 with the error code `unavailable` and `billing.charged` set to `false`, so none of them cost anything.

The error object said that a retry was allowed: `retryable` was `true`, `retry_after` was 60 seconds and `max_retries` was 2. From 00:49 we retried the four markets in turn every 30 seconds until we stopped at 01:08. At 01:33 we called Malaysia once more, and nothing changed. The first 16 calls left only a summary record; the other 54 each have a request_id. A call through `everyinfra_call_api` over MCP returned the same result.

![Dot timeline. The x-axis runs from 00:14 to 01:06 Singapore time on November 18, 2026. The lower row of grey dots shows TikTok Shop best-seller, category and MCP calls from 00:24 to 01:08, all 503. The upper row of teal dots shows 1688, Taobao, Google Shopping and TikTok video search calls, mostly from 00:53 to 01:04, all 200.](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-calls-timeline.en.light.svg)

For product research, this has two direct effects. First, a best-seller endpoint can be unavailable for a while, so a daily job must allow "this market was not fetched today" and run the other steps anyway. A failed call costs nothing, so retrying after `retry_after` costs time, not money.

Second, the best-seller list is not the only entry point on the TikTok side. At the same time, `tiktok/search` (video keyword search) worked normally. The cover of a shopping video is often a close-up of the product, which you can send straight to image search. So the TikTok side switched to video search: one search for "tiktok shop" videos in Malaysia and one in the Philippines, and products picked from the covers.

### Plan B: pick products from shopping videos

At 00:53 we fetched 20 videos for the keyword "tiktok shop malaysia", and at 01:01 another 20 for "tiktok shop philippines", at 0.000556 USD per call ([TikTok video search](/tiktok-api/search)). Each video in the response has `view_count`, `posted_at`, `is_ad`, `hashtags` and `cover_image_url`.

| Market | Fetched at (Singapore time) | Videos | `is_ad` true | Median views | Posted in the last 60 days | Cover is a product close-up |
| --- | --- | --- | --- | --- | --- | --- |
| Malaysia | 00:53 | 20 | 16 | 182,750 | 10 | 7 |
| Philippines | 01:01 | 20 | 13 | 86,000 | 13 | 3 |

![Grouped bar chart for 20 tiktok shop videos each from Malaysia and the Philippines. is_ad true: Malaysia 16, Philippines 13. Posted in the last 60 days: Malaysia 10, Philippines 13. Cover is a product close-up: Malaysia 7, Philippines 3.](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-videos-bar.en.light.svg)

In Malaysia, 7 of the 20 covers show the product itself. They are a pink cookware set, a pink multi-cooker, a camera-shaped handheld fan and a flying fairy toy. The others are foot massage slippers, a car ornament and a desk fan with an LED ring.

In the Philippines, most covers show people, live-stream notices and brand sales. Only 3 show a product: a printed T-shirt, a pack of gummies and a pair of grey wide-leg sweatpants. This fits the report that Filipino shoppers turned to content creators during 11.11 ([The Manila Times](https://www.manilatimes.net/2026/11/10/news/filipino-shoppers-pivot-to-content-creators-for-1111/2466071)). The more a cover shows a person, the harder it is to use for image search.

We picked 6 products with no clear brand. Four came from Malaysia: the camera-shaped fan (999,800 views), the flying fairy (2.1 million), the massage slippers (358,200) and the LED ring desk fan (3.2 million). Two came from the Philippines: the printed T-shirt (404,100) and the sweatpants (71,200). We skipped the food, the cookware set and the religious car ornament. Food imports need separate paperwork, and a cookware set has many pieces, so image search can match only one of them.

## Instead of the TikTok Shop product scraper: video covers in 1688 image search

We fixed the labelling rules at 00:46, before the first image search at 00:54. There are three labels.

"Same" means that the shape, structure, accessories and main colours match. Only the camera angle, the background or the text stickers can differ. "Similar" means the same kind of product with the same function, but with a visible difference in shape or structure. An example is a holder with a different clamp arm. "Different" means that even the product type does not match.

Only "same" goes into the markup calculation. We log "similar" but do not count it. The three labels are also the enum values of the `match` field in the Gemini structured output. So a person and the model use one scale. Only one person labelled the matches; there was no second judge.

Between 00:54 and 01:03, we sent the `cover_image_url` of each of the 6 covers to `alibaba1688/image_search`. Each call returned 5 candidates and cost 0.005556 USD, so the 6 calls cost 0.0333 USD. Each candidate row has `price`, `currency`, `min_order_quantity`, `order_count`, `supplier_name` and the candidate image `image_url`. We put each cover next to its 5 candidate images and labelled them one by one with the rules above.

![Stacked horizontal bar chart of the labels for the 5 1688 candidates of each of 6 products. Camera-shaped fan: 5 similar. Flying fairy toy: 4 same, 1 different. Massage slippers: 4 same, 1 similar. LED ring desk fan: 1 same, 4 similar. Printed T-shirt: 3 similar, 2 different. Grey sweatpants: 4 same, 1 similar. In total, 13 of 30 candidates are the same item.](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-match-bar.en.light.svg)

| Product (market) | Views | Same / similar / different | 1688 price of same items (CNY) | Seller location of same items |
| --- | --- | --- | --- | --- |
| Camera-shaped fan (Malaysia) | 999,800 | 0 / 5 / 0 | — | — |
| Flying fairy toy (Malaysia) | 2,100,000 | 4 / 0 / 1 | 5.9, 7.9, 8, 16.5 | Shantou, Yiwu, Wuhu |
| Massage slippers (Malaysia) | 358,200 | 4 / 1 / 0 | 11.8, 11.8, 12, 15 | Jieyang, Yiwu |
| LED ring desk fan (Malaysia) | 3,200,000 | 1 / 4 / 0 | 88.8 | Shenzhen |
| Printed T-shirt (Philippines) | 404,100 | 0 / 3 / 2 | — | — |
| Grey wide-leg sweatpants (Philippines) | 71,200 | 4 / 1 / 0 | 18, 18, 18, 22 | Guangzhou, Jieyang |

13 of the 30 candidates were the same item, or 43%, and 4 of the 6 products had at least one same-item match. Our earlier 1688 sourcing article used product photos from online stores ([Claude Code: 1688 sourcing and Yandex Market margins](/blog/claude-code-1688-sourcing-yandex-market-margin)). It found 15 same items in 25 candidates, or 60%. Video covers do worse, and the images show why. A cover has people, large titles and several products in one frame, so image search catches only the shape that stands out most.

The 4 same-item matches for the flying fairy ranged from 5.9 to 16.5 CNY, almost a threefold spread. The one with the most orders was a Yiwu trader at 5.9 CNY, with 5,691 orders and a minimum order of 1 piece. For the slippers, 4 of 5 candidates were the same item; the second had the same sole in white, which the rules count as similar.

The 4 same-item matches for the sweatpants used one product photo under 3 different shop names. Together they had only 1 order, and each had a minimum order of 1. One photo in several shops with almost no orders suggests resale pages for one batch of goods. Before you order, check the tier prices and the shipping city with `alibaba1688/product_detail`, and ask for a sample first.

![Dot plot of the list prices of 5 1688 candidates for each of 6 products. The log scale runs from 0.5 to 200 CNY. The 4 same items for the flying fairy are between 5.9 and 16.5 CNY. Those for the slippers are between 11.8 and 15 CNY. Those for the sweatpants are between 18 and 22 CNY. The only same item for the LED ring fan is 88.8 CNY. The 5 similar items for the camera-shaped fan are between 5 and 38 CNY, and the T-shirt candidates run from 0.6 to 35 CNY.](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-spread-scatter.en.light.svg)

The two products without a match failed for different reasons. The T-shirt print appeared in 3 candidates, but on a white T-shirt, a white hoodie and a dark long-sleeve shirt, never on a beige T-shirt. The other 2 candidates were a plastic garment bag (0.6 CNY, whose photo showed this T-shirt inside) and a basketball team jacket.

## Keyword search on 1688 and Taobao: a reference for cost

Image search returns only 5 candidates per call. A "same" match gives a concrete wholesale price. When there is no match, you still want to know what this kind of product usually costs on 1688.

`alibaba1688/search` searches by Chinese keyword, returns up to 100 rows (20 by default), and accepts `relevance`, `popular`, `price_asc` or `price_desc` for `sort`. Each row includes `price_min`, `min_order_quantity`, `order_count`, `supplier_name` and the shipping city ([EveryInfra catalog: 1688](https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688)). We sort by `popular`, take 20 rows and use the median price as the usual wholesale level for this kind of product. Taobao's `taobao/search` returns retail prices, up to 20 rows per call, so it shows what similar products cost in Chinese retail. It costs more than 1688 (0.0135 USD per call), so we call it for only a few products.

A person writes the Chinese keyword from the TikTok product name; it is not a machine translation. Product names in Southeast Asian stores often pile up functions, model numbers and sale words. If you translate such a name word for word and search with it, most results do not match. Keep only the product type and one or two key features, with no brand and no sale words. An example is the Chinese for "magnetic phone holder". Gemini can do this step too, but the instructions must state this rule.

### The camera-shaped fan: image search saw only a fan

The Malaysian video with 999,800 views has the caption "2-in-1 Camera Fan", and each device on the cover has a screen. It is a handheld fan that also takes photos and video. The 5 image search candidates were all plain handheld fans: one for the neck, one with a digital display, one with a mist spray. None matched the shape, and none could take photos, so the rules label all 5 as similar. Their median list price was 17 CNY.

At 00:58 we searched 1688 for the Chinese keyword for "camera fan", sorted by `popular`, for 20 rows at 0.002778 USD. 19 of the 20 titles contained the words for camera, video, gimbal or recorder. 6 said outright that they were a 2-in-1 fan and camera, at 18 to 115 CNY. The median list price of the 19 rows was 98 CNY, more than 5 times that of the 5 fans from image search. So the cost of this kind of product is around 90 CNY, and the 17 CNY from image search belongs to a different product.

On Google Shopping Malaysia, the same words ("camera fan") returned mostly cooling fans for cameras. Only 2 titles named a handheld fan or a 2-in-1, at 131.68 and 174.46 MYR.

![Dot plot for the same camera-shaped handheld fan. The lower row shows the list prices of the 5 image search candidates, between 5 and 38 CNY. The upper row shows the 20 list prices from the keyword search for camera fan, mostly between 65 and 128 CNY.](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-kw-scatter.en.light.svg)

Rule: image search sees shape, not function. Sometimes the product on a cover has a function that you cannot see, such as a camera, a mist spray or Bluetooth. Then read the function word from the video caption. Join it with the product type into a keyword and search again. When the two results disagree, trust the keyword search that includes the function word. Gemini can read the cover and the caption together, so it suits this step better than image retrieval alone.

Keyword search also shows the price range of a whole product type. Take the "magnetic phone holder" in the screenshot further down. Its 20 rows sorted by `popular` ran from 2.6 to 47 CNY, with a median of 18.9 CNY. Among the 9 rows with over 1,000 orders, the cheapest cost 2.6 CNY and the most expensive 47 CNY. An 18-fold spread under one keyword means that the 1688 cost is a range, not one number. Match the same item first, then look at its tier prices.

![Scatter plot of 20 results for the 1688 keyword magnetic phone holder, sorted by popular. The x-axis shows list price from 2.6 to 47 CNY; the y-axis shows order count on a log scale from 1 to 80,000. The 9 rows with over 1,000 orders are teal and spread from 2.6 to 47 CNY.](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-1688-scatter.en.light.svg)

On Taobao we made one call, for the Chinese keyword for "induction flying fairy", at 0.0135 USD. It returned 10 rows with retail prices from 8.8 to 32.8 CNY and a median of 16.9 CNY. That is 2.1 times the 7.95 CNY median 1688 cost of the same item. Taobao gives the retail price inside China, which tells you what the item sells for at home. If the price in Southeast Asia is less than twice the Chinese retail price, little is left after cross-border shipping and platform fees.

| Price level for the flying fairy | Capability | Price | In USD | Times the 1688 cost |
| --- | --- | --- | --- | --- |
| 1688 same item (median of 4) | `alibaba1688/image_search` | 7.95 CNY | 1.19 | 1.0 |
| Taobao retail (median of 10) | `taobao/search` | 16.9 CNY | 2.54 | 2.1 |
| Malaysia online retail (median of 11) | `google_shopping/search` | 19.51 MYR | 4.77 | 4.0 |

## Markup: local retail reference price over 1688 cost

Markup = the local online retail reference in US dollars ÷ the 1688 cost of the same item in US dollars. The retail reference is the median Shopee and Lazada price for similar items on Google Shopping in Malaysia or the Philippines. All conversions use the European Central Bank reference rates of November 17, 2026 ([ECB reference rates](https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html), fetched through [Frankfurter](https://github.com/hakanensari/frankfurter)). 1 USD = 6.6661 CNY, 4.0935 MYR, 63.676 PHP and 33.84 THB. The ECB does not publish a VND rate, so for VND we use 25,747 from open.er-api on the same day. The 1688 price is the list price that image search or keyword search returns. It is not the tier price for your order size and does not include shipping inside China.

Without the best-seller list we also had no TikTok Shop selling prices. Instead we used `google_shopping/search` for local online retail prices, at 0.000556 USD per call ([Google Shopping data API](/google-shopping-api)). We set the country to `my` or `ph`.

We fixed the filter rule before we fetched any data. Keep only rows whose merchant is Shopee or Lazada. The title must also contain the product type, such as fairy, slipper, fan or sweatpants. Then take the median price.

This drops brand stores such as Toys"R"Us, adidas and Uniqlo, and collectors' items on eBay. Most of what remains are offers from the same kind of cross-border sellers on other platforms. It is not the TikTok Shop selling price, and it is not a checked same-item price. It is the price level of similar products in the same market. For the fairy toy, the 11 rows only had "fairy" in the title, and they ran from 8.81 to 48 MYR.

| Product (market) | Median 1688 cost of same items | Median local retail reference for similar items (rows) | In USD | Markup |
| --- | --- | --- | --- | --- |
| Flying fairy toy (Malaysia) | 7.95 CNY (1.19 USD) | 19.51 MYR (11 rows) | 4.77 USD | 4.0 |
| Massage slippers (Malaysia) | 11.9 CNY (1.79 USD) | 26.62 MYR (11 rows) | 6.50 USD | 3.6 |
| LED ring desk fan (Malaysia) | 88.8 CNY (13.32 USD) | 46.5 MYR (9 rows) | 11.36 USD | 0.85 |
| Grey wide-leg sweatpants (Philippines) | 18 CNY (2.70 USD) | 299 PHP (5 rows) | 4.70 USD | 1.7 |

![Grouped bar chart for the 4 products with a same-item match. Grey bars show the 1688 cost and teal bars the local retail reference, both in USD. Flying fairy 1.19 vs 4.77 USD, 4.00 times. Massage slippers 1.79 vs 6.50 USD, 3.64 times. LED ring desk fan 13.32 vs 11.36 USD, 0.85 times. Grey sweatpants 2.70 vs 4.70 USD, 1.74 times.](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-markup-bar.en.light.svg)

The fairy toy and the slippers sit between 3.6 and 4.0, but the sweatpants reach only 1.7. Clothing is cheap in Southeast Asian retail. On Lazada Philippines, similar sweatpants sell for 169 to 369 PHP. Say sweatpants that cost 18 CNY sell for 299 PHP. Then little is left after platform fees of 8.2% to 9.2%, the category commission and international shipping. The next section lists those fees.

Read the 0.85 for the LED ring desk fan with care. The one same-item match on 1688 is listed at 88.8 CNY by an "electronics market display cabinet" seller with only 7 orders, so this cost is not reliable. The 9 retail rows in Malaysia include a small desk fan at 15.58 MYR and a brand-name table fan at 179 MYR. None has this LED ring design.

When neither side lines up, the markup means nothing. Mark this row "to check" and leave it out of the ranking. The model should follow the same rule: if there is only one same-item match, or no same item among the retail rows, leave `markup` empty.

## Markup is not margin: fees, commission and import tax

The markup is the ratio between the local retail price of similar items and the 1688 cost of the same item. Before the seller keeps any money, the platform takes its fees. Then come freight to the market, last-mile delivery, and import tax. These items change by country and by category. The public rules below are not tax advice. They explain why the markup needs a wide buffer.

Start with platform fees. TikTok Shop Malaysia posted a notice on October 16, 2026. From 00:00 on October 31, Malaysia time, it changed the Marketplace and Mall commission rates.

The notice says that the platform charges only on sales, with no new flat, listing or monthly fees. The commission is the item price minus the seller discount, multiplied by the category rate ([TikTok Shop Malaysia Seller Center: Commission fee](https://seller-my.tiktok.com/university/essay?knowledge_id=6907739532281602&lang=en)). Malaysia also charges a 3.78% transaction fee, SST included. On top of that comes a platform support fee of RM 0.54 per order ([TikTok Shop Malaysia: Platform Support Fee](https://seller-my.tiktok.com/university/essay?knowledge_id=7992113007347457&lang=en)).

The Philippines fee page has more lines. The transaction fee is 2.24%. The shipping service fee is 5% for Mall sellers and 5.5% for Marketplace sellers, capped at PHP 100 per item. An order processing fee of PHP 5 applies to each order. A seller growth fee of 1% or 1.5% applies by category ([TikTok Shop Philippines Seller Center: Seller fees](https://seller-ph.tiktok.com/university/essay?knowledge_id=2675772847064834&lang=en)). The percentage items alone add up to 8.2% to 9.2% per order, before the category commission.

Next, import rules. Malaysia charges a 10% sales tax on low-value goods sold online and sent from abroad, for items up to RM 500. The rule started on January 1, 2024 ([Malaysia Ministry of Finance press release](https://www.mof.gov.my/portal/en/news/press-release/sales-tax-on-imported-low-value-goods-sold-online)). Singapore charges GST on low-value goods that overseas sellers sell to local buyers. Overseas vendors above the turnover thresholds must register ([IRAS: Overseas businesses](https://www.iras.gov.sg/taxes/goods-services-tax-(gst)/gst-and-digital-economy/overseas-businesses)).

Thailand removed its THB 1,500 exemption from January 1, 2026. All goods bought online from abroad now pay 7% VAT and import duty ([Thailand Public Relations Department](https://thailand.prd.go.th/en/content/category/detail/id/2078/iid/440097)). On November 10, 2026, the Thai cabinet approved a new duty of up to 30% on goods imported through e-commerce platforms. Customs expects it to start next year ([Reuters, 2026-11-10](https://www.reuters.com/business/retail-consumer/thailand-approves-tax-increase-e-commerce-imports-finance-minister-says-2026-11-10/)).

Vietnam ended the VAT and import duty exemption for express parcels under VND 1 million on February 18, 2025 ([VietNamNet](https://vietnamnet.vn/en/vietnam-ends-tax-free-status-for-low-value-imports-sent-via-express-services-2360167.html)). Indonesia sets a minimum FOB price of USD 100 per item for direct foreign sales to consumers ([US Commerce country guide: Indonesia eCommerce](https://www.trade.gov/country-commercial-guides/indonesia-ecommerce)). That rule blocks the "ship cheap items from China" route in Indonesia, so our test skips the Indonesian market.

![Stacked bar chart of known percentage fees and taxes before category commission. Malaysia: 3.78% transaction fee plus 10% sales tax on low-value imports, 13.78% in total. Philippines: 2.24% transaction fee, 5.5% shipping service fee and 1.5% growth fee, 9.24% in total. Thailand: only the 7% VAT, without duty.](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-fees-bar.en.light.svg)

| Market | Public rule used here | Effective or approved | Effect on markup |
| --- | --- | --- | --- |
| Malaysia | New category commission; 3.78% transaction fee; RM 0.54 per order; 10% sales tax on imported low-value goods | 2026-10-31; 2024-01-01 | Fees and tax scale with price, so discount the markup first |
| Philippines | 2.24% transaction fee; 5%–5.5% shipping service fee; PHP 5 per order; 1%–1.5% growth fee | Fee structure since 2025-01-15 | About 8.2%–9.2% plus category commission |
| Thailand | 7% VAT and duty on all online imports; cabinet approved up to 30% duty | 2026-01-01; approved 2026-11-10 | Direct shipping may cost more next year |
| Vietnam | No more VAT and duty exemption for low-value express parcels | 2025-02-18 | Small parcels pay tax too |
| Indonesia | Minimum FOB USD 100 per item for direct foreign sales | Since 2023 | Cheap items cannot ship direct |

For one product, the answer depends on its category, on whether you run a local or a cross-border shop, and on the freight route. Check each rule in the seller center and the customs text of each country. The table supports one point only. A markup of 2x usually leaves little after commission, fees, freight and tax. A markup of 4x or 5x leaves room for the rest of the costs.

## The Gemini side: four features, four jobs

Gemini does four jobs in this chain. It calls the data API, it compares product photos, it fills a table with fixed columns, and it reads the full batch in one pass. Each job maps to one feature in the Gemini API docs. We read every page below on November 18, 2026.

For the first job, the API call, the Gemini Interactions API can attach a remote MCP server. You add an object with `type` set to `mcp_server` to the `tools` list. You give it a `name` and a `url` ([Gemini API docs: Remote MCP](https://ai.google.dev/gemini-api/docs/function-calling#mcp)). The same section lists two limits. Remote MCP works only with Streamable HTTP servers, not SSE servers. Server names must not contain a hyphen, so use snake_case.

The field table has two more fields that matter for a data API. The `headers` field sends key-value pairs with every request, for example an auth token. The `allowed_tools` field limits which server tools the model can call. The EveryInfra remote MCP lives at `https://api.everyinfra.com/mcp` and uses Streamable HTTP ([MCP spec: Transports](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports)).

At 00:19 Singapore time on November 18, we sent one `initialize` request to that server. It answered in 0.140 seconds with protocol version `2025-06-18` ([MCP spec: Lifecycle](https://modelcontextprotocol.io/specification/2025-06-18/basic/lifecycle)). The next `tools/list` call returned 12 tools. Product research needs only three of them. `everyinfra_list_capabilities` lists capabilities and prices, `everyinfra_call_api` fetches data, and `everyinfra_get_job` reads async jobs. Only the second one costs money.

If you put these three names in `allowed_tools`, the model cannot touch support tickets or account settings. An earlier article connects a Gemini managed agent to this remote MCP for brand monitoring ([Gemini Managed Agents with remote MCP for brand monitoring](/blog/gemini-managed-agents-remote-mcp-brand-monitoring)). For a weekly Shopee product review with a ChatGPT agent, see [ChatGPT agent: weekly Shopee product research](/blog/chatgpt-agent-shopee-weekly-product-research).

| Tool | What it does | Charged | In `allowed_tools` |
| --- | --- | --- | --- |
| `everyinfra_list_capabilities` | Lists capabilities, parameters and `price_usd` | No | Yes |
| `everyinfra_call_api` | Calls one data capability, such as a best-seller list or image search | At catalog price | Yes |
| `everyinfra_get_job` | Reads the result of an async job | No | Yes |
| `everyinfra_get_account` | Shows balance and account details | No | No |
| `everyinfra_create_ticket` | Opens a support ticket | No | No; ask a person first |

![Screenshot of the Remote MCP section in the Gemini API docs. Two limits at the top say that only Streamable HTTP servers work and that server names must not contain a hyphen. The field table below lists type, name, url, headers and allowed_tools. A teal box marks the two limits and the headers and allowed_tools rows.](https://everyinfra.com/articles/tiktok-shop-scraper-api/img-gemini-mcp-doc.webp)

Gemini needs one mcp_server object to attach a remote MCP server. The auth header goes in headers, and allowed_tools limits the tools. Captured on November 18, 2026. [Gemini API docs](https://ai.google.dev/gemini-api/docs/function-calling#mcp)

The second job is image comparison. Gemini image understanding accepts several images in one `input` list. Each image points to a public address through `uri` ([Gemini API docs: Image understanding](https://ai.google.dev/gemini-api/docs/image-understanding)). The doc example asks what is different between two images.

The limits section of that page says that one request can hold up to 3,600 images. An image with both sides at 384 pixels or less costs 258 tokens. A larger image is cut into 768×768 tiles, and each tile costs 258 tokens. The TikTok Shop hot list and the 1688 image search both return product photo addresses. One TikTok photo plus five 1688 candidates makes six images in one request.

The third job is a fixed format. Structured outputs make the model answer in the JSON Schema that you supply. The first use case in the doc is data extraction, and the second is classification into set categories ([Gemini API docs: Structured outputs](https://ai.google.dev/gemini-api/docs/structured-output)). In the Interactions API, you put `mime_type: application/json` and a `schema` inside `response_format`. The Python SDK accepts a schema made from a Pydantic model ([Pydantic docs](https://docs.pydantic.dev/latest/)).

A sourcing sheet has fixed columns: TikTok product id, market, price, units sold, 1688 candidate id, match result, matched cost, and markup. If the schema limits the match field to `same`, `similar` and `different`, your script does not need to parse free text.

The fourth job is one long read. Gemini 4 Hydrogen has a context window of 1,048,576 tokens ([Gemini 4 Hydrogen model page](https://ai.google.dev/gemini-api/docs/models/gemini-4-hydrogen)). Input, thinking and output tokens share this window ([Gemini API docs: Long context](https://ai.google.dev/gemini-api/docs/long-context)). The results of the 16 successful calls in this article total about 231 KB, or roughly 58,000 tokens at 4 bytes per token. One request holds them all.

| Gemini feature | What the docs say | Job in the sourcing chain |
| --- | --- | --- |
| Remote MCP (`mcp_server`) | Streamable HTTP only; snake_case name; auth in `headers`; tool list in `allowed_tools` | Call EveryInfra for hot lists, image search and keyword search |
| Several images per request | Up to 3,600 images; 258 tokens for an image of 384 px or less | Compare 1 TikTok photo with 5 candidates from 1688 |
| Structured outputs (`response_format`) | Output follows a JSON Schema; Pydantic models work | Return the sourcing sheet with fixed columns |
| 1M context | Gemini 4 input, thinking and output share 1,048,576 tokens | Read all markets at once and compare them |
| Batch API | Half the standard paid price, results come back later | Run the daily match job at a lower price |

The price page decides the model. Google released Gemini 4 Hydrogen as generally available on November 12, 2026. It is on the free tier. The paid tier costs $1.50 per million input tokens and $7.50 per million output tokens ([Gemini API release notes, 2026-11-12](https://ai.google.dev/gemini-api/docs/changelog#11-12-2026)). The Batch tier costs half: $0.75 input and $3.75 output ([Gemini API pricing](https://ai.google.dev/gemini-api/docs/pricing)).

Gemini 3.5 Flash-Lite costs $0.30 input and $2.50 output per million tokens. Google describes it as a model for high-volume agent tasks, translation and simple data processing ([Gemini 3.5 Flash-Lite model page](https://ai.google.dev/gemini-api/docs/models/gemini-3.5-flash-lite)).

In its launch post, Google says that Hydrogen adapts cleanly when a tool call fails or a search returns empty. It also says that the model sends file-read and search calls in parallel batches ([Google blog: Introducing Gemini 4 Hydrogen](https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-hydrogen/)). Both points apply here. The 503 errors that the TikTok Shop list endpoints returned throughout our test are the kind of failed tool call that the model must handle.

## Attach EveryInfra to Gemini: configuration example

The code below is a configuration example. It follows the Gemini API docs as of November 18, 2026. We did not open a paid Gemini project, so this code did not run on the Gemini side. The EveryInfra address, tool names and auth format come from our live calls.

```text
# Configuration example: not run on the Gemini side; follows ai.google.dev docs read 2026-11-18
import os
from typing import Literal
from google import genai
from pydantic import BaseModel, Field

class Row(BaseModel):
    tiktok_id: str
    market: Literal["MY", "PH", "TH", "VN", "SG"]
    price_usd: float = Field(description="TikTok Shop price in USD at the day's rate")
    sold_count: int | None
    candidate_id: str | None = Field(description="1688 candidate product id")
    match: Literal["same", "similar", "different", "no_candidate"]
    cost_usd: float | None = Field(description="1688 list price in USD when match is same")
    markup: float | None = Field(description="price_usd / cost_usd, only when match is same")

class Sheet(BaseModel):
    rows: list[Row]

client = genai.Client()  # reads GEMINI_API_KEY

interaction = client.interactions.create(
    model="gemini-4-hydrogen",
    input=(
        "Get the TikTok Shop hot lists for Malaysia and the Philippines, 20 items each. "
        "For the top 3 generic items, run a 1688 image search with the product photo. "
        "Compare the photos and fill the sheet. Calculate markup only when match is same."
    ),
    tools=[{
        "type": "mcp_server",
        "name": "everyinfra",                      # no hyphen, as the docs require
        "url": "https://api.everyinfra.com/mcp",   # Streamable HTTP
        "headers": {"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
        "allowed_tools": ["everyinfra_list_capabilities", "everyinfra_call_api", "everyinfra_get_job"],
    }],
    response_format={"type": "text", "mime_type": "application/json", "schema": Sheet.model_json_schema()},
)
sheet = Sheet.model_validate_json(interaction.output_text)
```

Note three points. Set `name` to `everyinfra`, with no hyphen, because the docs name that limit. Read the key from an environment variable and put it in `headers`. Do not hard-code it. Keep only three tools in `allowed_tools`. Only `everyinfra_call_api` costs money, and the model can first call the free `everyinfra_list_capabilities` to check parameters and prices.

To get the same data without Gemini, send the REST call below. We sent every live call in this article this way, with the key from an environment variable:

```bash
curl -s https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"tiktok","action":"shop_hot_products","params":{"country":"MY","limit":20}}'
```

In the response, `results` is the product list. Each row has `rank`, `id`, `url`, `name`, `price`, `original_price`, `currency`, `sold_count`, `rating`, `review_count`, `shop_name`, `shop_id` and `image_url`, which match `response_fields` in the catalog. `billing.charged_usd` is the amount in USD for that call. A failed call returns 503 with `billing.charged` set to `false` and `charged_usd` set to 0. The error object includes `retry_after` in seconds. For the meaning of HTTP 503, see [RFC 9110](https://www.rfc-editor.org/rfc/rfc9110#name-503-service-unavailable).

These rules fit into one system instruction, passed as the `system_instruction` parameter in the Interactions API ([Gemini API docs: text generation](https://ai.google.dev/gemini-api/docs/text-generation#system-instructions)). The same page says that Gemini 4 and 3.6+ models ignore custom `temperature`, `top_p` and `top_k` values. To get steadier labels, write clear rules; sampling settings will not help. Here is the version we wrote from the labelling rules in this article:

```text
You build a sourcing sheet. Rules:
1. Call everyinfra_list_capabilities once before any paid call. Use only capabilities with available=true.
2. Best-seller lists: tiktok/shop_hot_products, limit 20, one call per market.
3. If a tool result has error.retryable=true, wait error.retry_after seconds and retry at most error.max_retries times.
   If it still fails, mark that market "not fetched" and continue. Never invent numbers.
4. Skip branded items. For each generic item, call alibaba1688/image_search with its image_url.
5. Compare the TikTok image with the 5 candidates. match = same only if shape, structure,
   accessories and main colours all agree; similar if same type and function but visibly different; else different.
6. Keyword for alibaba1688/search: product type plus one or two key features, in Chinese, no brand, no sale words.
7. Convert prices with the rates given in the input. markup = price_usd / cost_usd, only when match = same.
```

## A full round trip: what success and failure look like

### The successful call: what comes back

On November 18, 2026 at 00:16:32 Singapore time, we called `alibaba1688/search` over REST. We used the Chinese keyword for "magnetic phone holder", `sort` set to `popular` and `limit` set to 20. It returned HTTP 200 with `count` 20 and `billing.charged_usd` 0.002778, the same as the catalog price. The `price_min` of the 20 rows ran from 2.6 to 47 CNY, with a median of 18.9 CNY. `order_count` ran from single digits to 80,240, and the shipping cities were mostly Shenzhen, Dongguan, Guangzhou and Shantou.

The second row was a car phone holder listed at 11 CNY, with a minimum order of 1 piece and 80,240 orders. Rows with many orders and a low minimum order suit a small trial order.

![Screenshot of the request and response of one alibaba1688/search call. The request body has platform alibaba1688, action search, a Chinese keyword for magnetic phone holder, sort popular and 20 rows. The response shows status_code 200 and count 20, then two products with id, title, price_min, currency CNY, minimum order, order count, city and seller type. In billing, charged_usd 0.002778 is outlined in teal.](https://everyinfra.com/articles/tiktok-shop-scraper-api/img-api-1688.webp)

A real 1688 keyword search: 20 rows, 0.002778 USD charged, the same as the catalog price. November 18, 2026, 00:16 Singapore time. [EveryInfra API live call](https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688)

Gemini needs only a few fields from this response. `id` and `url` let you trace the row back. `price_min` and `currency` give the wholesale price. `min_order_quantity` shows whether a small order is possible, and `order_count` shows whether the item sells at wholesale. Put these fields in the structured output schema. Then the model will not take a sale word in a title for a price.

### The failed call: what the model sees

At 00:38:09 Singapore time on November 18, 2026, we sent one MCP `tools/call` request to `https://api.everyinfra.com/mcp`. The tool was `everyinfra_call_api`. The arguments were the same ones that Gemini would send in the configuration example. They set `platform` to `tiktok`, `action` to `shop_hot_products`, the market to the Philippines and the limit to 20. At that moment, the TikTok Shop endpoints were failing.

| Field in the result | Value this time | What the model should do |
| --- | --- | --- |
| `isError` | `true` | No data came back, so put no numbers in the sheet |
| `billing.charged` / `charged_usd` | `false` / 0 | Nothing was charged, so a retry is not billed twice |
| `refund.status` | `succeeded` | The held amount was returned |
| `structuredContent.error.retryable` | `true` | A retry is allowed |
| `structuredContent.error.retry_after` | 60 | Wait 60 seconds before the retry |
| `structuredContent.error.max_retries` | 2 | Retry at most 2 times, then mark "not fetched" |

The result had `isError` set to `true` and three text parts. The first part said that the service was temporarily unavailable and gave a request id. The second part was billing: `charged` was `false`, `charged_usd` was 0, and `refund.status` was `succeeded`.

The third part gave next steps for the model. It said that this capability failed 5 times in 10 minutes and that none of the calls cost money. It also said that if other targets fail the same way, the fault is on the server side. In that case, the model must ask the user before it opens a ticket with `everyinfra_create_ticket`. The `structuredContent.error` object also carried `retryable: true`, `retry_after: 60` and `max_retries: 2` in machine-readable form.

Google says that Hydrogen adapts cleanly when a tool call fails ([Google blog](https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-hydrogen/)). In this chain, put that rule in the system prompt. If an error has `retryable` set to true, wait for `retry_after` seconds and retry at most twice. If it still fails, mark that market as "not fetched" in the sheet and move on to the next market. Do not invent numbers. Also tell the model that a failed call costs nothing, so it has no reason to retry again and again.

## Cost: what 100 products cost

The data side uses `price_usd` from the catalog. The best-seller list returns 20 rows for 0.000806 USD per call, so 100 products take 5 calls, about 0.0040 USD. 1688 image search costs 0.005556 USD per call, or 0.56 USD for 100 products. 1688 keyword search costs 0.002778 USD per call, or 0.28 USD for 100 calls.

Taobao keyword search costs 0.0135 USD per call, or 1.35 USD for 100 calls, so we call it for only a few products. Failed and empty calls are not charged. The dozens of TikTok Shop 503 responses during this test cost nothing.

All live calls in this article, 88 in total, cost 0.0574 USD. The table splits that by capability. More than half went to 1688 image search, and the TikTok Shop 503 responses cost nothing.

| Capability | Calls | Succeeded | Charged (USD) |
| --- | --- | --- | --- |
| 1688 image search (`alibaba1688/image_search`) | 6 | 6 | 0.033336 |
| Taobao keyword search (`taobao/search`) | 1 | 1 | 0.0135 |
| 1688 keyword search (`alibaba1688/search`) | 2 | 2 | 0.005556 |
| Google Shopping (`google_shopping/search`) | 5 | 5 | 0.00278 |
| TikTok video search (`tiktok/search`) | 4 | 4 | 0.002224 |
| TikTok Shop lists (best-sellers, category, shop search, MCP) | 70 | 0 | 0 |
| **Total** | 88 | 18 | 0.0574 |

The model side is an estimate, because we did not run anything on Gemini. Each product sends 6 images: 1 TikTok image and 5 candidate images from 1688. We measured 5 product images from 1688. The originals are squares of 800 to 1,920 pixels. With the tiling formula in the documentation, each of these counts as 4 tiles, or 1,032 tokens.

If you add `_300x300.jpg` to a 1688 image address, you get a 300-pixel thumbnail. Both sides are then 384 pixels or less, so each image counts as only 258 tokens ([Gemini API docs: image understanding](https://ai.google.dev/gemini-api/docs/image-understanding)). For text, we assume 800 input tokens, 150 output tokens and 500 thinking tokens per product. The pricing page says that the output price includes thinking tokens ([Gemini API pricing](https://ai.google.dev/gemini-api/docs/pricing)).

![Grouped bar chart of the 5 1688 product images we measured. The originals are 1920, 800, 1080, 1200 and 1000 pixels wide and 120 to 363 KB. Each counts as 1,032 tokens by the formula in the docs. With the _300x300.jpg suffix they are all 300 pixels, 17 to 44 KB, and count as 258 tokens each.](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-tokens-bar.en.light.svg)

![Horizontal bar chart of the cost per 100 products. Data side: TikTok best-seller list 0.0040 USD, 1688 image search 0.56 USD, 1688 keyword search 0.28 USD, Taobao keyword search 1.35 USD. Model side: Gemini 4 Hydrogen with full-size images 1.54 USD, with 300 px thumbnails 0.84 USD, Hydrogen Batch with thumbnails 0.42 USD, Gemini 3.5 Flash-Lite with thumbnails 0.23 USD.](https://everyinfra.com/articles/tiktok-shop-scraper-api/fig-cost-bar.en.light.svg)

| Per 100 products | Input tokens | Output tokens (with thinking) | Cost (USD) |
| --- | --- | --- | --- |
| Gemini 4 Hydrogen, full-size images | 699,200 | 65,000 | 1.54 |
| Gemini 4 Hydrogen, 300 px thumbnails | 234,800 | 65,000 | 0.84 |
| Hydrogen Batch, 300 px thumbnails | 234,800 | 65,000 | 0.42 |
| Gemini 3.5 Flash-Lite, 300 px thumbnails | 234,800 | 65,000 | 0.23 |
| EveryInfra: best-seller list + 1688 image search + 1688 keyword search | — | — | 0.84 |

Thumbnails cut the Hydrogen input tokens by two thirds, and the cost drops from 1.54 USD to 0.84 USD. The Batch API halves it again to 0.42 USD. With Batch and thumbnails, data and model together cost about 1.26 USD per 100 products. Of that, 0.56 USD is 1688 image search, a little over 40%. Hydrogen is also on the free tier, so you can test your rules there at low volume. The free-tier limits are on the [Gemini API rate limits](https://ai.google.dev/gemini-api/docs/rate-limits) page.

## Run it daily: use the change in sold_count to spot rising products

The `sold_count` on the best-seller list is the running total that the shop page shows. A two-year-old product and a product that took off last week can show similar totals. To see what sells fast now, you must read the list at two times and use the difference.

On November 18, 2026, we searched YouTube videos for "tiktok shop scraper". The top three results show two steps. First, the model estimates revenue as sold count × price and sorts by it. Second, the same product is read twice, 24 hours apart, and the difference gives an estimate of daily sales.

Viktor Automates posted a video on October 22, 2026 ([Build Your Own TikTok Shop Scraper In ChatGPT, YouTube](https://www.youtube.com/watch?v=lLUydphbjIo)). In it, the channel connects a custom MCP in ChatGPT and runs it once a day as a scheduled task. The author of a scraping API posted a video about the US store in August 2025 ([Unofficial TikTok Shop API, YouTube](https://www.youtube.com/watch?v=9s8ylkAiipg)). It says that one search on the web page takes 20 to 30 seconds and that verification pages are frequent. All three videos cover only the US store. None of them continues to 1688 or Taobao to find a source.

| Video | Channel and date | Market | Method shown |
| --- | --- | --- | --- |
| Build Your Own TikTok Shop Scraper In ChatGPT | Viktor Automates, 2026-10-22 | US | ChatGPT with a custom MCP, run daily as a scheduled task |
| Unofficial TikTok Shop API | A scraping API author's channel, 2025-08-15 | US | An API instead of page scraping; one web search takes 20 to 30 seconds and often hits verification |
| TikTok Shop Scraper: Find What's Actually Selling | Channel of a scraping platform, 2026-08-07 | US | Revenue estimated as sold × price, then sorted |

### What changed in 40 minutes

We tested the "read twice, compare" step on the one TikTok source that worked. At 00:53 and again at 01:33 Singapore time, we fetched 20 videos for "tiktok shop malaysia" with `tiktok/search`. Only 11 of the 20 videos came back both times; 9 were new. 10 of those 11 changed position, so a search result is not a fixed list. The flying fairy and the massage slippers from our picks were among the 9 that dropped out.

The counts moved less than the order. Views changed on only 4 of the 11 videos, and likes on 4. Every view count of 10,000 or more in our three video files ends in 00. So large view counts are rounded, and a gain of less than 100 views in 40 minutes does not show. Like counts under 10,000 look exact: the camera-shaped fan stayed at 999,800 views but went from 5,868 to 5,869 likes.

| Video (Malaysia) | Position 00:53 → 01:33 | Views 00:53 → 01:33 | Likes 00:53 → 01:33 |
| --- | --- | --- | --- |
| `#BarangViral` product video | 6 → 15 | 456,300 → 458,500 | 1,876 → 1,888 |
| White jeans | 4 → 6 | 331 → 369 | 47 → 49 |
| `#goodthing` product video | 5 → 11 | 384,700 → 385,200 | 1,439 → 1,441 |
| Camera-shaped fan | 13 → 4 | 999,800 → 999,800 | 5,868 → 5,869 |
| `#setperiuk` cookware set | 2 → 8 | 1,000,000 → 1,000,000 | 4,133 → 4,133 |
| LED ring desk fan | 19 → 17 | 3,200,000 → 3,200,000 | 16,900 → 16,900 |

This supports two of the rules below: match by `id`, and compare over 24 hours so that rounded counts have time to move. At 01:33 we also called the Malaysian best-seller list once more. It still returned 503 and cost nothing, which brought the failed TikTok Shop calls to 70.

When you make this a daily job, fix three rules. First, read the list at a fixed time, for example 10:00 Singapore time each day. Then the gaps are equal and you can compare the changes. Second, match products by `id`, not by rank. The rank changes; the `id` does not.

Third, use the change only to sort, not as daily sales. A shop can merge several variants into one count, or correct its count after a sale event. Send the top 10 products by change to the image search step and only log the rest. This keeps the daily cost at a few US cents.

If Gemini runs this step, put the daily comparison into the Batch API. The documentation says that batch jobs cost half the standard price ([Gemini API docs: Batch API](https://ai.google.dev/gemini-api/docs/batch-api)). The target turnaround is 24 hours, and most jobs finish sooner. Product research does not need an answer in seconds. A result the next morning is enough.

## Limits and things to watch

First, the TikTok Shop hot list exists in 8 markets only. The catalog lists Indonesia, Japan, Mexico, Malaysia, the Philippines, Singapore, Thailand and Vietnam for `tiktok/shop_hot_products`. The US, UK and Brazil have no hot list, and a call for them is refused before any charge ([EveryInfra catalog: TikTok](https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok)). For the US market, use `tiktok/shop_category_products` by category or `tiktok/shop_search` by keyword.

Second, shop listings are paused. The catalog marks `tiktok/shop_products` as paused. A call returns 503 at once and costs nothing. So we did not use the route "find a hot shop, then read all its products". Until that capability is back, filter the hot list and the category list by `shop_id` to see what one shop sells.

Third, 1688 image search returns only 5 candidates per call. The catalog also says that it does not return full SKU, stock or seller details ([EveryInfra catalog: 1688](https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688)). After you confirm a match, call `alibaba1688/product_detail` with the candidate URL ($0.001389 per call) to get tier prices and the minimum order. We did not do that step. So the "cost" in this article is the list price from image search or keyword search, not the tier price for your order size.

Fourth, Taobao search cannot page when you add a price filter or sort by sales. You get at most 10 to 20 rows. Plain keyword search can page, but most rows have no sales count and no shop name ([EveryInfra catalog: Taobao](https://api.everyinfra.com/api/v1/social/catalog?platform=taobao)). Taobao prices are retail prices. Use them to see what the Chinese retail market charges, not as a cost price.

Fifth, the TikTok Shop `sold_count` is the running total that the storefront shows. It is not the sales of one day. To estimate daily sales, fetch the list again later and use the difference, as the next section shows.

Sixth, the model can be wrong when it compares photos. The Gemini docs say to use clear, correctly rotated images ([Gemini API docs: Image understanding](https://ai.google.dev/gemini-api/docs/image-understanding)). For a single image, put the text prompt first. Product photos often carry text banners and collages. Let the model return `similar` for unsure pairs, and let a person check them. In this article, one person labelled all 30 pairs. Before a daily run, let Gemini label the same 30 pairs blind, without the human labels. A person then checks the pairs where the two disagree. The agreement rate shows which product types you can leave to the model. Do not count `similar` as a match when you calculate markup.

Seventh, stay away from high-risk categories. The TikTok Shop Malaysia prohibited products guide lists classes of goods that sellers must not sell or import ([TikTok Shop Malaysia: Prohibited products guidelines](https://seller-my.tiktok.com/university/essay?knowledge_id=8927861016708866&lang=en)). Items with batteries, liquids or cosmetics also have extra freight and certification rules in each country. A large markup does not remove those checks.

## What changed in the last 60 days

| Date | Change | What it means for this sourcing chain | Source |
| --- | --- | --- | --- |
| 2026-10-16 | TikTok Shop Malaysia announces new category commission from October 31 | Orders before and after October 31 pay different rates, so recalculate the fee column | [Seller Center notice](https://seller-my.tiktok.com/university/essay?knowledge_id=6907739532281602&lang=en) |
| 2026-10-29 | Local Malaysian small sellers grow sales 140% year on year in the 9.9 campaign; about six in ten users prefer live shopping | More local and live-selling items on the hot list, so cross-border items compete with them on price | [The Rakyat Post](https://www.therakyatpost.com/news/2026/10/29/tiktok-shop-live-becomes-digital-shopfront-for-malaysian-msmes-as-local-sellers-record-140-sales-growth/) |
| 2026-11-05 | TikTok launches a standalone TikTok Shop app in Singapore, Malaysia, Thailand and the Philippines | One more shopping entry point in four markets that this article tests | [TechCrunch](https://techcrunch.com/2026/11/05/tiktok-quietly-launches-a-standalone-tiktok-shop-app/) |
| 2026-11-10 | Thai cabinet approves a duty of up to 30% on e-commerce imports | Tax on cheap goods shipped from China to Thailand can rise next year | [Reuters](https://www.reuters.com/business/retail-consumer/thailand-approves-tax-increase-e-commerce-imports-finance-minister-says-2026-11-10/) |
| 2026-11-10 | Filipino shoppers turn to content creators for 11.11 | Hot items track creator videos, so check the videos with the list | [The Manila Times](https://www.manilatimes.net/2026/11/10/news/filipino-shoppers-pivot-to-content-creators-for-1111/2466071) |
| 2026-11-12 | Gemini 4 Hydrogen is generally available, free tier included, $1.50 per million input tokens on paid tier | Hydrogen can be the default model here, so recalculate model cost | [Gemini API release notes](https://ai.google.dev/gemini-api/docs/changelog#11-12-2026) |
| 2026-11-13 | GitHub Copilot adds Gemini 4 Hydrogen | You can write the sourcing script in your editor with the same model | [GitHub Changelog](https://github.blog/changelog/2026-11-13-gemini-4-hydrogen-in-github-copilot/) |

Two changes that touch money came between late October and mid-November. Malaysia changed its commission table on October 31, and Thailand approved its new e-commerce import duty on November 10. If you built a markup sheet in October, recalculate at least the platform fee column now. For items that ship direct to Thailand, the new duty rate is not final. Use the current 7% VAT plus duty for now, and update the sheet when the new rule starts.

## Getting started

1. Open the free catalog at `https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok`. Check that `shop_hot_products` and `shop_category_products` show `available` as true, and note `price_usd`.
1. Follow the [quickstart](/docs#quickstart) to sign up, add funds and get a key. Put the key in the environment variable `EVERYINFRA_API_KEY`.
1. Run the `curl` call above for one market. Check that you get 20 rows and that `charged_usd` is 0.000806.
1. Pick one generic item. Send its `image_url` to `alibaba1688/image_search`, and look for a match in the 5 candidates.
1. Attach the remote MCP server in Gemini with the configuration above. Ask the model to run the same steps and return the sheet in the schema. Compare its sheet with your manual result.
1. To run it every day, schedule steps 3 and 4 at the same time each day. Use the change in `sold_count` to find rising items. For other setups, see [remote MCP setup](/mcp-server) and the [data market](/market).

## FAQ

### Does TikTok have an API for TikTok Shop products?

"does tiktok have an api" is a Google suggestion for "tiktok shop scraper api". TikTok has two official APIs, and neither is for product research across a market.

The TikTok Shop Partner Center open API serves sellers and service partners. It covers the products, orders and logistics of your own shop ([TikTok Shop developer guide](https://partner.tiktokshop.com/docv2/page/656559fcf4488c02dfe8ce82)). The TikTok Research API has a TikTok Shop shop-details endpoint for approved researchers. Its doc says that it returns only shops that operate in the EU ([TikTok for Developers: TikTok Shop Details API](https://developers.tiktok.com/doc/research-api-specs-query-tiktok-shop-info)). Each call returns at most 10 rows. For public hot lists and category lists in Southeast Asia, use endpoints like `tiktok/shop_hot_products` and `tiktok/shop_category_products`.

### Can I use a tiktok shop scraper from GitHub?

"tiktok shop scraper github" is another suggestion. Open-source projects help you learn the page structure. To run one every day, you must handle proxies, verification pages and layout changes yourself. In a public YouTube walkthrough, the author of one TikTok Shop API names two problems ([Unofficial TikTok Shop API, YouTube](https://www.youtube.com/watch?v=9s8ylkAiipg)). A search takes 20 to 30 seconds, and the site often shows a challenge page. A pay-per-call API puts that work into the price: `tiktok/shop_hot_products` costs $0.000806 per call, and a failed call costs nothing.

### Is there a free tiktok shop scraper?

"tiktok shop scraper free" is also a suggestion. The EveryInfra catalog at `GET /api/v1/social/catalog` needs no key and costs nothing. It shows every capability, parameter and price. Live calls need a key and cost money per call. A 503 or an empty result costs nothing. At catalog price, one best-seller list of 20 products costs 0.000806 USD, so 1,000 products cost about 0.04 USD.

### How do I search 1688 by image?

A Reddit post in r/Alibaba explains how to source on 1688 for clients outside China. The author lists search by image as a key method ([Reddit r/Alibaba](https://www.reddit.com/r/Alibaba/comments/1lxqd52/ive_helped_nonchinese_clients_source_from_1688/)). You upload a product photo and get dozens of sourcing options with prices. The 1688 open platform has an image search API for distribution partners ([1688 open platform: image search](https://open.1688.com/ability/detail?key=1610419169653)). To use it, you must apply and list an app in its service market. Without that process, send one public product image address to `alibaba1688/image_search` and get 5 similar items for $0.005556 per call.

### Do viral TikTok products all come from 1688?

Not always. A Reddit post in r/dropshipping asks where viral TikTok products come from. The author says that many come from the physical wholesale market in Yiwu ([Reddit r/dropshipping](https://www.reddit.com/r/dropshipping/comments/1mx9yvj/where_viral_tiktok_products_actually_come_from/)). Our results agree in part. 4 of our 6 products had a same-item match on 1688. The fairy toy sellers were in Shantou and Yiwu, and the slipper sellers in Jieyang and Yiwu.

Two products had no match. One was a fan that also takes photos, a function that the cover does not show. The other was a printed T-shirt, whose print other sellers used on a white shirt and a hoodie. No match does not mean no source. It means that the "match by image, then compare price" method does not fit that item.

### Is it legal to scrape TikTok Shop data?

"is it legal to scrape tiktok shop data" is a suggestion too. We do not give legal advice, but we can state the scope of the data in this article. We read product names, prices, units sold, ratings and shop names that the TikTok Shop storefront shows to the public. We also read public product lists on 1688 and Taobao. We did not log in to any account, and we did not collect personal data. Ask a qualified lawyer whether your use is lawful under your local law and the platform terms.

### Can a tiktok shop review scraper get product reviews?

Yes. `tiktok/shop_product_reviews` reads reviews by product id, up to 20 per page, for $0.000764 per call. The platform already masks reviewer names ([EveryInfra catalog: TikTok](https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok)). For the few products with a large markup, read one page of 1-star and 2-star reviews. Check whether the complaints are about quality or delivery before you buy stock.

## References

1. Google AI for Developers, "Gemini Developer API pricing," read 2026-11-18, https://ai.google.dev/gemini-api/docs/pricing
1. Google AI for Developers, "Gemini API release notes (Nov 12, 2026: Gemini 4 Hydrogen GA)," 2026-11-12, https://ai.google.dev/gemini-api/docs/changelog#11-12-2026
1. Google AI for Developers, "Gemini 4 Hydrogen model page," read 2026-11-18, https://ai.google.dev/gemini-api/docs/models/gemini-4-hydrogen
1. Google AI for Developers, "Function calling: Remote MCP," read 2026-11-18, https://ai.google.dev/gemini-api/docs/function-calling#mcp
1. Google AI for Developers, "Structured outputs," read 2026-11-18, https://ai.google.dev/gemini-api/docs/structured-output
1. Google AI for Developers, "Image understanding," read 2026-11-18, https://ai.google.dev/gemini-api/docs/image-understanding
1. Google AI for Developers, "Long context," read 2026-11-18, https://ai.google.dev/gemini-api/docs/long-context
1. Google AI for Developers, "Batch API," read 2026-11-18, https://ai.google.dev/gemini-api/docs/batch-api
1. Google AI for Developers, "Gemini 3.5 Flash-Lite model page," read 2026-11-18, https://ai.google.dev/gemini-api/docs/models/gemini-3.5-flash-lite
1. Google AI for Developers, "Using tools with the Gemini API," read 2026-11-18, https://ai.google.dev/gemini-api/docs/tools
1. Google AI for Developers, "Files API," read 2026-11-18, https://ai.google.dev/gemini-api/docs/files
1. Google AI for Developers, "Thinking levels," read 2026-11-18, https://ai.google.dev/gemini-api/docs/thinking
1. Google AI for Developers, "Rate limits," read 2026-11-18, https://ai.google.dev/gemini-api/docs/rate-limits
1. Google AI for Developers, "URL context," read 2026-11-18, https://ai.google.dev/gemini-api/docs/url-context
1. Google blog, "Introducing Gemini 4 Hydrogen for Agentic Workflows," 2026-11-12, https://blog.google/innovation-and-ai/models-and-research/gemini-models/introducing-gemini-4-hydrogen/
1. Ars Technica, "Google rolls out Gemini 4 Hydrogen, finally replacing 3.8 Flash," 2026-11-12, https://arstechnica.com/google/2026/11/google-rolls-out-gemini-4-hydrogen-finally-replacing-3-8-flash/
1. GitHub Changelog, "Gemini 4 Hydrogen in GitHub Copilot," 2026-11-13, https://github.blog/changelog/2026-11-13-gemini-4-hydrogen-in-github-copilot/
1. Model Context Protocol, "MCP specification: Transports (2025-06-18)," 2025-06-18, https://modelcontextprotocol.io/specification/2025-06-18/basic/transports
1. Model Context Protocol, "MCP specification: Lifecycle (2025-06-18)," 2025-06-18, https://modelcontextprotocol.io/specification/2025-06-18/basic/lifecycle
1. GitHub googleapis/python-genai, "Google Gen AI Python SDK," read 2026-11-18, https://github.com/googleapis/python-genai
1. PyPI, "google-genai on PyPI," read 2026-11-18, https://pypi.org/project/google-genai/
1. Pydantic, "Pydantic documentation," read 2026-11-18, https://docs.pydantic.dev/latest/
1. EveryInfra, "EveryInfra data catalog," read 2026-11-18, https://api.everyinfra.com/api/v1/social/catalog
1. EveryInfra, "EveryInfra catalog: TikTok," read 2026-11-18, https://api.everyinfra.com/api/v1/social/catalog?platform=tiktok
1. EveryInfra, "EveryInfra catalog: 1688," read 2026-11-18, https://api.everyinfra.com/api/v1/social/catalog?platform=alibaba1688
1. EveryInfra, "EveryInfra catalog: Taobao," read 2026-11-18, https://api.everyinfra.com/api/v1/social/catalog?platform=taobao
1. TikTok Shop Malaysia Seller Center, "TikTok Shop Malaysia: Commission Fee & Seller Fees Calculations," 2026-10-16, https://seller-my.tiktok.com/university/essay?knowledge_id=6907739532281602&lang=en
1. TikTok Shop Malaysia Seller Center, "TikTok Shop Malaysia: Platform Support Fee," 2026-04-22, https://seller-my.tiktok.com/university/essay?knowledge_id=7992113007347457&lang=en
1. TikTok Shop Philippines Seller Center, "TikTok Shop Philippines: Introduction to Seller Fees," 2026-10-13, https://seller-ph.tiktok.com/university/essay?knowledge_id=2675772847064834&lang=en
1. TikTok Shop Malaysia Seller Center, "TikTok Shop Malaysia: Prohibited Products Guidelines," 2025-03-07, https://seller-my.tiktok.com/university/essay?knowledge_id=8927861016708866&lang=en
1. TikTok Shop Partner Center, "TikTok Shop developer guide," read 2026-11-18, https://partner.tiktokshop.com/docv2/page/656559fcf4488c02dfe8ce82
1. TikTok for Developers, "Research API: TikTok Shop Details API," read 2026-11-18, https://developers.tiktok.com/doc/research-api-specs-query-tiktok-shop-info
1. 1688 Open Platform, "Image search for distribution products (open capability page)," read 2026-11-18, https://open.1688.com/ability/detail?key=1610419169653
1. 1688 Open Platform, "Cross-border sourcing solution (open platform page)," read 2026-11-18, https://open.1688.com/solution/solutionDetail.htm?solutionKey=1697014160788
1. Ministry of Finance Malaysia, "Sales Tax On Imported Low-Value Goods Sold Online," 2023-12-18, https://www.mof.gov.my/portal/en/news/press-release/sales-tax-on-imported-low-value-goods-sold-online
1. Inland Revenue Authority of Singapore, "Overseas businesses supplying remote services and low-value goods," 2026-09-18, https://www.iras.gov.sg/taxes/goods-services-tax-(gst)/gst-and-digital-economy/overseas-businesses
1. Thailand Public Relations Department, "Thailand to Apply Import Tax on All Online Goods from Jan '26," 2025-11-10, https://thailand.prd.go.th/en/content/category/detail/id/2078/iid/440097
1. Reuters, "Thailand approves tax increase on e-commerce imports," 2026-11-10, https://www.reuters.com/business/retail-consumer/thailand-approves-tax-increase-e-commerce-imports-finance-minister-says-2026-11-10/
1. VietNamNet, "Vietnam ends tax-free status for low-value imports sent via express services," 2025-01-05, https://vietnamnet.vn/en/vietnam-ends-tax-free-status-for-low-value-imports-sent-via-express-services-2360167.html
1. International Trade Administration, US Department of Commerce, "Indonesia - eCommerce (Country Commercial Guide)," 2025-11-17, https://www.trade.gov/country-commercial-guides/indonesia-ecommerce
1. European Central Bank, "Euro foreign exchange reference rates," 2026-11-17, https://www.ecb.europa.eu/stats/policy_and_exchange_rates/euro_reference_exchange_rates/html/index.en.html
1. GitHub hakanensari/frankfurter, "Frankfurter (ECB reference rate API)," read 2026-11-18, https://github.com/hakanensari/frankfurter
1. TechCrunch, "TikTok quietly launches a stand-alone TikTok Shop app," 2026-11-05, https://techcrunch.com/2026/11/05/tiktok-quietly-launches-a-standalone-tiktok-shop-app/
1. The Rakyat Post, "TikTok Shop LIVE Becomes Digital Shopfront For Malaysian MSMEs," 2026-10-29, https://www.therakyatpost.com/news/2026/10/29/tiktok-shop-live-becomes-digital-shopfront-for-malaysian-msmes-as-local-sellers-record-140-sales-growth/
1. The Manila Times, "Filipino shoppers pivot to content creators for 11.11," 2026-11-10, https://www.manilatimes.net/2026/11/10/news/filipino-shoppers-pivot-to-content-creators-for-1111/2466071
1. IETF / RFC Editor, "RFC 9110: HTTP Semantics, 503 Service Unavailable," 2022-06, https://www.rfc-editor.org/rfc/rfc9110#name-503-service-unavailable
1. Python documentation, "statistics — Mathematical statistics functions," read 2026-11-18, https://docs.python.org/3/library/statistics.html
1. Reddit r/Alibaba, "I've helped non-Chinese clients source from 1688," 2025, https://www.reddit.com/r/Alibaba/comments/1lxqd52/ive_helped_nonchinese_clients_source_from_1688/
1. Reddit r/dropshipping, "Where viral TikTok products actually come from (hint: not Alibaba) AMA," 2025, https://www.reddit.com/r/dropshipping/comments/1mx9yvj/where_viral_tiktok_products_actually_come_from/
1. YouTube, "Unofficial TikTok Shop API," 2025-08-15, https://www.youtube.com/watch?v=9s8ylkAiipg
1. YouTube, Viktor Automates, "Build Your Own TikTok Shop Scraper In ChatGPT," 2026-10-22, https://www.youtube.com/watch?v=lLUydphbjIo
1. Google AI for Developers, "Text generation: system instructions," read 2026-11-18, https://ai.google.dev/gemini-api/docs/text-generation#system-instructions
1. ExchangeRate-API, "ExchangeRate-API open access endpoint (USD, 2026-11-17)," 2026-11-17, https://open.er-api.com/v6/latest/USD
