# TikTok Shop Keyword Search

> TikTok Shop Keyword Search is a paid API for AI agents from api.xona-agent.com, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-15).

Searches the TikTok Shop marketplace by keyword and returns ranked, normalized product listings with pricing, ratings, seller info, and TikTok badges for a specified regional storefront.

## Facts

- Endpoint: POST https://api.xona-agent.com/tiktok/search
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tiktok-shop-keyword-search-6663158c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JLBUWGl2mReptL7kz8-c1

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tiktok-shop-keyword-search-6663158c -d '<json body>'
```

Example prompt: Search TikTok Shop in the US for 'wireless earbuds' and show me the top results including prices, discounts, ratings, and any best-seller or free-shipping badges.

## When to prefer this

Choose this endpoint when you need to search TikTok Shop's marketplace by keyword and want results normalized for direct comparison with Google Shopping, Amazon, or eBay. It is ideal when region-specific TikTok storefronts matter (e.g., UK vs US vs DE catalogs), when you need TikTok-specific signals like units sold and platform badges, or when you want to integrate TikTok Shop data into a multi-marketplace price comparison workflow. Use the free /api/tiktok-shop/quote/search endpoint first to validate requests before paying.

## Known failure modes

- Wrong region code returns unrelated or empty results — ensure the two-letter region matches the desired storefront
- Invalid or missing query string returns an error or empty product list
- Region not supported by TikTok Shop returns no results or an error
- Pagination beyond available results returns an empty products array
- Network or upstream TikTok API timeout results in a 5xx error

## How this service works

Keyword search across the whole TikTok Shop marketplace. Returns ranked products normalized into the same schema as /shop/search, so TikTok Shop results can be compared directly against Google Shopping, Amazon, and eBay. Each product carries price, list price, discount, rating, units sold, seller, and TikTok's own badges (Free shipping, best_seller). Region-partitioned: pass the region whose storefront you want. Call the free POST /api/tiktok-shop/quote/search first to validate the request at no cost.

## Output

Returns a ranked list of products from the specified TikTok Shop regional storefront. Each product includes product name, price (in local currency), list/original price, discount amount or percentage, star rating, units sold count, seller name, and TikTok-applied badges such as 'Free shipping' and 'best_seller'. Results are normalized to the same schema as /shop/search for cross-platform comparison. Optionally includes the raw upstream payload if requested.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "raw": {
   "type": "boolean",
   "description": "Also include the untouched upstream payload under `raw`"
  },
  "page": {
   "type": "number",
   "description": "Page number to retrieve, default 1"
  },
  "query": {
   "type": "string",
   "description": "Product search term, e.g. \"wireless earbuds\" or \"skincare serum\""
  },
  "region": {
   "type": "string",
   "description": "Two-letter region whose storefront to search: US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE (default US). TikTok Shop catalogs are partitioned per country, so the wrong region returns unrelated results. Prices come back in that storefront's own currency, reported in the price.currency field."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tiktok-shop-keyword-search-6663158c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.xona-agent.com](https://www.zero.xyz/host/api.xona-agent.com/llms.txt)