TikTok Shop Search
TikTok Shop検索の結果は、選択した市場でキーワードに一致した公開商品で、商品とセラーの情報、価格、画像、評価、レビュー数、販売数を含みます。これらのコマースレコードは、地域別の商品発見、価格比較、セラー調査、再現可能な市場スナップショットに活用できます。
TikTok Shop Search API の主な機能
- キーワードと市場の指定商品クエリと16の対応 region 値のいずれかを組み合わせて、目的の公開市場カタログを検索します。
- 上限付きの重複なし取得20〜2,000件の結果をリクエストでき、取得ページは公開商品のIDで重複が除外されます。
- 商品とセラーの情報商品ID、タイトル、説明文、正規リンク、公開されているセラーまたはショップの詳細を返します。
- 価格と表示中のコマース指標公開されている場合、販売価格、元の価格、通貨、割引、評価、レビュー数、販売数を保持します。
- メディアと商品のコンテキスト公開画像、カテゴリ、SKUの構造、ステータス、検索クエリ、リージョン、取得日時を各レコードに保持します。
TikTok Shop Search API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
query | 必須 | 必須。空でない商品キーワードまたはフレーズです。 |
results_limit | 任意 | 取得する重複のない結果の上限で、20〜2,000を指定できます。デフォルトは100です。 |
region | 任意 | 市場リージョンです。US、GB、DE、FR、IT、ID、MY、MX、PH、SG、ES、TH、VN、BR、JP、IE のいずれかを指定します。デフォルトは US です。 |
TikTok Shop Search API の使い方
具体的な商品フレーズと市場を決めて、非同期の検索リクエストを1件送信します。
- 空でない query を設定し、対応する region を選び、results_limit を20〜2,000の範囲で設定します。
- リクエストを /v1/tiktok-shop/search に POST し、返された task_id を保存します。
- タスクが succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- data.results.items を読み取ります。has_more が true の場合は next_cursor で続きを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"running shoes","results_limit":100,"region":"US"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueTikTok Shop Search API の主なユースケース
- 地域別の商品発見: 選択した市場で、カテゴリ、ニーズ、ブランド、商品フレーズに一致する公開商品を洗い出します。
- 価格と割引の比較: 返された商品間で、取得可能な販売価格、元の価格、通貨、割引のフィールドを比較します。
- 評判と需要の比較: 公開されている評価、レビュー数、販売数を、欠けている指標を0に変換せずに比較します。
- 商品とショップの候補選定: 商品リンク、セラー情報、画像、カテゴリ、SKU情報を使って、詳しく調査する候補を選定します。
TikTok Shop Search API 活用のヒント
- 同じフレーズでも異なる公開カタログに解決されることがあるため、query と region は必ずセットで保存してください。
- results_limit は必要な件数に設定し、タスク結果をすべて読み取るには has_more が false になるまで next_cursor をたどってください。
- 価格、評価、レビュー数、販売数がない場合は、0ではなく取得不可として扱ってください。
- 地域別スナップショットを再現できるよう、すべてのレコードに search_query と collected_at を保持してください。
- 詳細レベルの最新情報で補完したい場合は、選んだPDP URLを TikTok Shop Product API に渡してください。
関連API
TikTok Shop Search API 以外に別の種類の公開TikTok Shopデータが必要な場合は、これらのAPIをご利用ください。
- TikTok Shop Products API — TikTok ShopのストアURL 1件から公開商品を取得し、出品者、価格、メディア、カテゴリ、SKU、評価、レビュー、販売数の各フィールドを返します。
- TikTok Shop Product API — PDP URLからTikTok Shopの公開商品1件を取得し、出品者、価格、メディア、カテゴリ、SKU、評価、レビュー、販売数の各フィールドを返します。
- TikTok Shop Product Reviews API — TikTok ShopのPDP URL 1件について公開レビューを取得し、本文、評価、レビュー投稿者、画像、SKU、国、購入情報の各フィールドを返します。
- TikTok Shop User Showcase API — TikTokユーザー名1件について公開ショーケースの商品を取得し、価格、出品者、メディア、評価、レビュー、販売数、地域情報を返します。
- TikTok Shop Hot Products API — 地域コードで選んだTikTok Shop市場の売れ筋商品を、ランキング順に価格と通貨、販売数、評価、ショップとともに取得します。
- TikTok Shop Search Suggestions API — 1つの市場で、買い物の検索の書き出しに対してTikTok Shopが提案する補完候補を順位付きで最大20件取得します。