> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentkey.app/llms.txt
> Use this file to discover all available pages before exploring further.

# TikTok Shop product data for AI agents

> Search TikTok Shop by region, read product details and reviews, list a seller's products and pull hot-selling lists through AgentKey, no seller account needed.

TikTok Shop is where short video turns into checkout, and its product pages
are built for the app, not for the open web: every region is a separate
catalog, and the official Partner API only serves sellers and affiliates on
their own accounts. Through AgentKey your agent reads public TikTok Shop
products the same way it reads everything else — `find_tools`,
`describe_tool`, `execute_tool` — naming the region on each call.

## What you can ask

* *"Search TikTok Shop US for 'LED strip lights' and give me the top results with prices."*
* *"Keep paging through TikTok Shop results for 'yoga mat' in the UK until you have 100 products."*
* *"Open this TikTok Shop product in the Indonesia region and summarize the listing."*
* *"Is this product on TikTok Shop in both the US and the UK, and at what price in each?"*
* *"Summarize the reviews for this TikTok Shop product."*
* *"What is selling well on TikTok Shop Malaysia right now?"*

## What's covered

**Search**

* Keyword search within a selected region
* Offset and page-token pagination, so a multi-page search can be continued
  from where it stopped

**Product details**

* The public product detail for a product ID in a selected region — inspect a
  known product after search or catalog discovery

**Reviews, sellers and hot sellers**

* Product reviews; a seller's product list; products by category, with the
  category tree
* A hot-selling product list for the Southeast Asian, Japanese and Mexican
  regions (not the US, the UK or Brazil); it carries no rank, so treat it as a
  set rather than an ordered ranking
* Product and shop IDs resolved from a share link

These come from TikHub and sit under TikTok in the catalog, not under TikTok
Shop, so scope a search with `prefix="social/tiktok"` to reach them.

**Regions**

* Most operations take a region; look a product up in the region where you
  found it, since IDs and prices belong to that regional catalog

## How to use it

Pass the request in plain language and let the router pick the tool:

```text theme={null}
find_tools(q="LED strip lights on TikTok Shop US with prices")
find_tools(q="TikTok Shop 英国站搜瑜伽垫")
find_tools(prefix="ecommerce/tiktok-shop")  # search and detail
find_tools(q="TikTok Shop product reviews", prefix="social/tiktok")  # reviews, sellers, hot sellers
describe_tool("<returned Provider/Operation>")
execute_tool("<Provider/Operation>", { ...params })
```

Prices come back in the currency of the region you selected, not converted.
Always `describe_tool` before executing: it shows the region field and its
accepted values, the pagination tokens, and the per-call cost.

> [!NOTE]
>
> **Building with code?** The same capability is available as fixed-contract
> [Scenario Methods](https://docs.agentkey.app/api-reference/scenario/overview.md) with automatic provider
> failover:
> [`ecommerce.tiktok_shop.product.search`](https://docs.agentkey.app/api-reference/scenario/methods/ecommerce-tiktok_shop-product-search),
> [`ecommerce.tiktok_shop.product.get`](https://docs.agentkey.app/api-reference/scenario/methods/ecommerce-tiktok_shop-product-get),
> [`ecommerce.tiktok_shop.product.reviews`](https://docs.agentkey.app/api-reference/scenario/methods/ecommerce-tiktok_shop-product-reviews),
> [`ecommerce.tiktok_shop.product.rank`](https://docs.agentkey.app/api-reference/scenario/methods/ecommerce-tiktok_shop-product-rank),
> [`ecommerce.tiktok_shop.shop.products`](https://docs.agentkey.app/api-reference/scenario/methods/ecommerce-tiktok_shop-shop-products).

## FAQ

> **Do I need a TikTok Shop seller or Partner Center account?**
>
> No. AgentKey holds the upstream access; your agent only needs your AgentKey
> subscription.

> **Which regions can I query?**
>
> Most operations take a region parameter, and the accepted values differ
> by operation. Run `describe_tool` to see them rather than assuming a
> country is supported.

> **Can I read reviews, a shop's listings or best sellers?**
>
> Yes. Reviews, a seller's product list and a hot-selling list are catalog
> tools from TikHub, filed under TikTok rather than TikTok Shop; scope a
> search with `prefix="social/tiktok"`. The Scenario Methods listed above
> wrap the same data behind a fixed contract.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.