tiktok-shop/
search-suggestions

選んだ市場で、買い物の検索の書き出しに対してTikTok Shopが提案する補完候補を取得し、1から順位付けされた最大20件のキーワードフレーズを、元のクエリと地域とともに返します。

TikTok Shop Search Suggestions API

検索語の一部を入力
最大20件の補完候補
1からの順位
1リクエストあたり0.5クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

TikTok Shop Search Suggestions

TikTok Shop Search Suggestions は買い物客の入力に合わせてショップの検索ボックスが示す補完候補で、それぞれが完全なキーワードフレーズとして、リスト内の位置と提案された市場を持っています。実際に検索されている内容に基づくため、商品名、広告、コンテンツで狙うべき商品バリエーション、対応機種、購入の切り口が浮かび上がります。

TikTok Shop Search Suggestions API の主な機能

  • 検索語の一部から補完候補query には phone case のような検索の書き出しを指定し、各行は phone cases 17 pro max のように買い物客が補完した、より長いフレーズを返します。
  • TikTok Shop自身の候補順rank はTikTok Shopが表示する順に1から候補を番号付けし、1クエリあたり最大20件です。
  • 市場ごとの候補region で US、SG、MY、PH、TH、VN、ID、JP、MX から1つを選び(デフォルトは US)、各行が query と region を繰り返し持つため結果の出どころを追えます。

TikTok Shop Search Suggestions API のパラメータ

パラメータ必須説明
query必須補完する買い物の検索の書き出しです(例:phone case)。
region任意検索する市場です。US、SG、MY、PH、TH、VN、ID、JP、MX から選びます。デフォルトは US です。

TikTok Shop Search Suggestions API の使い方

買い物の検索の書き出しを送信し、補完候補を順位順に読み取ります。

  1. {"query": "phone case", "region": "US"} を /v1/tiktok-shop/search-suggestions に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から keyword と rank を読み取り、has_more が true の場合は results.next_cursor で残りを取得します。
curl -X POST "https://api.socq.ai/v1/tiktok-shop/search-suggestions" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"phone case","region":"US"}'

TikTok Shop Search Suggestions API の主なユースケース

  • 商品タイトルに入れるキーワードの選定: 機種、サイズ、バリエーションを含む keyword のフレーズを選び、商品タイトルや説明文に組み込みます。
  • 広告・コンテンツ用キーワードセットの作成: 複数のシードクエリの keyword 列を集め、広告、動画のキャプション、コンテンツ企画に使うキーワードリストを作ります。
  • 候補の移り変わりの追跡: 同じ query と region を時間をおいて再実行し、keyword ごとの rank を比べて、上昇、下降、新登場のフレーズを把握します。
  • 市場ごとの補完傾向の比較: 1つのクエリを複数の地域に送って keyword のリストを並べ、各市場の買い物客が同じ言葉をどう補完するかを見比べます。

TikTok Shop Search Suggestions API 活用のヒント

  • 候補はクエリの書き出しを延長したものなので、完全なフレーズではなく短い語幹をシードにしてください。長いフレーズでは補完の余地がほとんど残りません。
  • 返ってきた keyword を新しい query として送り直すと1階層深く掘れ、1つのシードがより長いフレーズのツリーに広がります。
  • 関連する語幹から同じフレーズが返ることがあるため、複数のシードの結果は行の id でもある keyword で重複を除いてください。
  • 有望な keyword は同じ region を付けて TikTok Shop Search に渡し、その候補の背後にある商品を確認してください。

TikTok Shop Search Suggestions API 以外に別の種類の公開TikTok Shopデータが必要な場合は、これらのAPIをご利用ください。

  • TikTok Shop Search API — キーワードと市場地域で公開TikTok Shopの商品を検索し、出品者、価格、メディア、評価、レビュー、販売数の各フィールドを返します。
  • 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 Hot Products API — 地域コードで選んだTikTok Shop市場の売れ筋商品を、ランキング順に価格と通貨、販売数、評価、ショップとともに取得します。
  • TikTok Shop Categories API — TikTok Shop市場のカテゴリツリー全体を、カテゴリID、名前、英語のスラッグ、階層、親カテゴリ、パスとともに取得します。

他のプラットフォームを見る

TikTok Shopのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

TikTok Shop Search Suggestions API — よくある質問

TikTok Shop Search Suggestions APIは、1つの市場で買い物の検索の書き出しに対してTikTok Shopが示す補完候補を取得するためのプログラムインターフェースです。提案されたキーワードフレーズを最大20件、それぞれの順位、元のクエリ、地域とともに返します。

1リクエストにつき query は1つです。複数のシードキーワードを扱うには、シードごとに1リクエストずつ送り、結果を keyword でまとめてください。

1回の呼び出しにつき0.5クレジットで、最大20件の候補が返ります。料金は候補の件数ではなく呼び出しごとにかかります。