TikTok Shopでの商品リサーチは、3つの問いから始まります。その市場で何が売れているのか、カテゴリには何が含まれているのか、買い物客は検索で何を入力しているのか、です。SocQはこれまでも商品検索、ストアのカタログ、商品ページ、レビュー、クリエイターのショーケースを返していました。それらの比較はTikTok Shop APIとスクレイパーのおすすめ7選をご覧ください。2026-11-17には、この3つの問いに直接答える4つのエンドポイントがTikTok Shopプラットフォームのページに追加されました。
このガイドでは、各エンドポイントが返すデータ、リクエストの形、料金、そしてそれらを組み合わせてカテゴリを一巡する方法を説明します。
結論:
POST https://api.socq.ai/v1/tiktok-shop/<endpoint>にJSONボディを送信します。返されたtask_idを保存し、statusがsucceededになるまでGET /v1/tasks/{task_id}をポーリングして、data.results.itemsを読み取ります。
新しく追加されたTikTok Shopエンドポイント
1 SocQクレジット = $0.005です。
| エンドポイント | 返すデータ | 料金 |
|---|---|---|
| TikTok Shop Hot Products API | 市場の売れ筋商品をTikTok Shopの表示順で返す。価格、販売数、評価、ショップを含む | 商品1件あたり0.5クレジット($0.0025) |
| TikTok Shop Categories API | 市場のカテゴリツリー全体。カテゴリごとに1行で、ID、階層、親カテゴリを含む | 1回の呼び出しにつき0.5クレジット($0.0025) |
| TikTok Shop Category Products API | 1つのカテゴリ内の商品。価格、販売数、評価、レビュー、ショップを含む | 商品1件あたり0.5クレジット($0.0025) |
| TikTok Shop Search Suggestions API | 入力途中のクエリに対する最大20件の検索候補(順位付き) | 1回の呼び出しにつき0.5クレジット($0.0025) |
対応市場
| エンドポイント | regionの値 | デフォルト |
|---|---|---|
| Hot Products | ID、JP、MX、MY、PH、SG、TH、VN | なし(必須) |
| Categories、Category Products、Search Suggestions | US、SG、MY、PH、TH、VN、ID、JP、MX | US |
Hot ProductsはUSに対応していません。米国の商品リサーチには、CategoriesとCategory Productsを使ってください。
認証と非同期タスクの流れ
すべてのリクエストはAPIキーで認証します。送信、タスクのステータス確認、結果の取得のいずれでも同じヘッダーを使います。
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
すべての収集処理はバックグラウンドタスクとして実行されます。
submit -> task_id -> queued -> running -> succeeded
\-> failed
送信リクエストはすぐにdata.task_idとdata.statusを返します。そのIDでタスクをポーリングします。
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
statusがsucceededになると、レスポンスにはresult_count、credits_amount、そしてdata.results.itemsに正規化されたレコードの最初のページが含まれます。limitのデフォルトは50で、最大500まで指定できます。results.has_moreがtrueの場合は、results.next_cursorをcursorとして渡すと次のページを読み取れます。失敗したタスクにはerror_messageが含まれます。
各エンドポイントは省略可能なcallback_urlも受け付けます。タスクが完了するとSocQがタスクの概要をPOSTで1回送信するので、レコードはタスクのエンドポイントから読み取ります。クライアント側でタイムアウトしてもタスクはキャンセルされないため、再送信するのではなく同じタスクIDで照会を再開してください。402はアカウントのクレジット不足を、429はキーがレートまたはクレジットの上限に達したことを意味します。
Hot Products:市場で何が売れているか
Hot Products APIは、市場の売れ筋商品をTikTok Shopのランキング順で返します。各商品には、タイトル、price(金額、通貨、整形済みの文字列)、sold_count、rating、reviews_count、seller、画像、そして商品ページのurlが付きます。regionは必須です。results_limitのデフォルトは50で、1〜200を指定できます。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/hot-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region": "MY", "results_limit": 50}'
使いどころ: 市場ごとに毎週スナップショットを取り、急伸している商品の発見、価格のベンチマーク、仕入れや販促の対象商品の選定に使います。価格はマレーシアならMYRのように現地通貨で返されるため、市場間で比較する前に換算してください。
Categories:カテゴリツリー全体
Categories APIは、市場のすべてのカテゴリを1回の呼び出しで返します。各行には、カテゴリのid、name、英語のslug、level、parent_id、is_leaf、path(上位カテゴリの名前)、cover_url、regionが含まれます。最上位のカテゴリはparent_id: nullかつlevel: 1なので、階層をツリーとして再構築することも、フラットな参照テーブルとして保持することもできます。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/categories" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"region": "US"}'
使いどころ: 市場ごとに1回呼び出し、結果をキャッシュします。Category ProductsにはこのIDが必要で、ツリーはTikTok Shopのカテゴリを自社のカタログに対応付ける際にも役立ちます。
Category Products:買い物客のようにカテゴリを閲覧する
Category Products APIは、Categories APIで得た数値のcategory_idを受け取り、そのカテゴリの商品をタイトル、価格、販売数、評価、レビュー、ショップ、画像とともに返します。regionのデフォルトはUSです。results_limitのデフォルトは30で、1〜500を指定できます。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok-shop/category-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"category_id": "601450", "region": "US", "results_limit": 30}'
使いどころ: サブカテゴリ間で価格帯を比較したり、カテゴリのベストセラーが時間とともにどう変わるかを追跡したりするのに使います。
Search Suggestions:買い物客が入力する言葉
Search Suggestions APIは、ショッピング検索の入力途中の文字列をqueryで受け取り、TikTok Shopが提示する順に、1位からの順位付きで最大20件の検索候補を返します。各行にはkeyword、送信したquery、そのrank、regionが含まれます。regionのデフォルトはUSです。(ドキュメント)
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"}'
使いどころ: 商品掲載、広告、コンテンツのためのキーワードリサーチに使います。phone caseの場合、ドキュメントの例で最上位の候補はphone cases 17 pro maxで、買い物客がどの機種向けに購入しているかが分かります。得られた候補をTikTok Shop Searchに渡すと、それぞれの候補でどの商品が上位に表示されるかを確認できます。
3回の呼び出しでカテゴリを一巡する
1つの市場での典型的なリサーチの流れは次のとおりです。
- 市場ごとにCategoriesを1回呼び出し、ツリーを保存します(0.5クレジット)。
- 関心のある末端カテゴリ(
is_leaf: true)を選び、それぞれについてCategory Productsを呼び出します。 - 各カテゴリの中心となる商品ワードでSearch Suggestionsを呼び出し、買い物客がどのような言葉で検索しているかを確認します。
10カテゴリ × 各30商品で300商品、つまり150クレジットです。ツリー(0.5)と検索候補の呼び出し10回(5)を加えると、合計155.5クレジット、約$0.78になります。Hot Productsが対応している市場では、50商品のスナップショットを追加すると25クレジット($0.125)かかります。
フィールドは注意して読む
3つの商品エンドポイントでは、商品の行が同じ正規化された形をしています。SocQのほかのフィールドと同様に、取得元が提供しない値は0ではなくnullになります。ドキュメントの例では、表示されている商品のrating、reviews_count、sold_countがnullになっています。これらの値で商品を順位付けする前に、販売数や評価の欠損はゼロではなく不明として扱ってください。
個別の商品をさらに詳しく調べるには、そのurlをTikTok Shop Product API(現在は米国リージョンのみ対応)とProduct Reviews APIに渡します。TikTok Shopのデータを取得するほかの方法については、TikTok Shop APIの代替サービスをご覧ください。LIVE配信中に販売される商品は、TikTokの新エンドポイントガイドで紹介しているTikTok Live Shopping APIで扱えます。
よくある質問(FAQ)
TikTok Shopのセラーアカウントやパートナーアカウントは必要ですか?
いいえ。これらのエンドポイントは公開されているTikTok Shopのデータを読み取るもので、認証にはSocQのAPIキーを使います。
Hot ProductsでUSが受け付けられないのはなぜですか?
USはHot Productsのregionの値に含まれていないためです。Hot Productsが対応しているのはID、JP、MX、MY、PH、SG、TH、VNです。ほかの3つのエンドポイントはUSに対応しており、デフォルトでもこの値を使います。
カテゴリIDはどこで取得できますか?
Categories APIから取得します。各行のidが、同じregionでCategory Productsに渡すcategory_idになります。
各エンドポイントはどのように課金されますか?
CategoriesとSearch Suggestionsは、返される行数にかかわらず1回の呼び出しにつき0.5クレジットです。Hot ProductsとCategory Productsは、返された商品1件あたり0.5クレジットです。
1つのクエリで検索候補は何件返されますか?
最大20件で、TikTok Shopの表示順に1位から順位が付きます。
TIKTOK SHOP API
公開TikTok ShopのURLでワークフローを試す
公開データの入力を送信すると、取得元をたどれるコンテキスト付きの正規化レコードを受け取れます。
TikTok ShopのAPIを見る