{"uid":"cap_JLBUWGl2mReptL7kz8-c1","slug":"tiktok-shop-keyword-search-6663158c","name":"TikTok Shop Keyword Search","description":"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.","url":"https://api.xona-agent.com/tiktok/search","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_h3TLDYKlOpjTz2YzCxFFB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Cross-marketplace price comparison","prompt":"Search TikTok Shop in the US for 'noise cancelling headphones' and give me the top results with prices and ratings so I can compare them against what I'm seeing on Amazon."},{"title":"Best-seller discovery for dropshipping","prompt":"Find the best-selling skincare serums on TikTok Shop's UK storefront — I want to see ratings, units sold, price versus list price, and any best_seller badges."},{"title":"Regional product research","prompt":"Look up 'phone stand' on TikTok Shop in Germany and return the first two pages of results with seller names, prices in local currency, and any discounts shown."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:49:10.984Z","isFirstParty":false}