Skip to main content
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:
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.
Building with code? The same capability is available as fixed-contract Scenario Methods with automatic provider failover: ecommerce.tiktok_shop.product.search, ecommerce.tiktok_shop.product.get, ecommerce.tiktok_shop.product.reviews, ecommerce.tiktok_shop.product.rank, ecommerce.tiktok_shop.shop.products.

​
FAQ

No. AgentKey holds the upstream access; your agent only needs your AgentKey subscription.
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.
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.