TikTok Shop Category Products
TikTok Shop Category Products は市場の1つのカテゴリに登録された商品で、それぞれに商品名、説明、価格と通貨、販売数、評価、レビュー数、ショップ、画像が付いています。カテゴリごとに取得すると、その分野の価格帯、売れ筋商品、活発なショップと、それらがサブカテゴリごとにどう違うかが見えてきます。
TikTok Shop Category Products API の主な機能
- キーワードではなくカテゴリIDで閲覧category_id には TikTok Shop Categories が返す数値IDを指定するため、検索語を推測しなくてもカテゴリの商品を直接読み取れます。
- 9つの市場、デフォルトは米国region は US、SG、MY、PH、TH、VN、ID、JP、MX に対応し、省略すると US になります。
- 1カテゴリあたり最大500商品results_limit は1〜500でデフォルトは30なので、1回のリクエストでカテゴリの簡単なサンプルも深い範囲の取得もできます。
- すべての商品にコマース情報各行には title、text、amount と currency を含む price、sold_count、rating、reviews_count、seller、media の画像と、商品ページの url が入ります。
TikTok Shop Category Products API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
category_id | 必須 | TikTok Shop Categories の id フィールドから取得した数値のカテゴリIDです(例:601450)。 |
region | 任意 | カテゴリの市場です。US、SG、MY、PH、TH、VN、ID、JP、MX から選びます。デフォルトは US です。 |
results_limit | 任意 | 返す商品の数で、1〜500です。デフォルトは30です。 |
TikTok Shop Category Products API の使い方
TikTok Shop Categories からカテゴリIDを取り、その配下の商品を読み取ります。
- {"category_id": "601450", "region": "US", "results_limit": 30} を /v1/tiktok-shop/category-products に POST します。
- GET /v1/tasks/{task_id} をポーリングします。status が succeeded になれば商品の準備は完了です。
- results.items から商品を読み取り、has_more が true の場合は results.next_cursor で次のページをリクエストします。
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}'TikTok Shop Category Products API の主なユースケース
- サブカテゴリ間の価格帯比較: 子カテゴリごとに1回ずつリクエストし、price.amount の分布を比べて、各サブカテゴリの商品がどの価格帯にあるかを確かめます。
- カテゴリの売れ筋の追跡: 同じカテゴリを定期的に再取得して商品の id ごとに sold_count を追い、販売数を伸ばし続けている商品を見つけます。
- 分野内のショップの把握: 商品を seller.id と seller.name でグループ化し、カテゴリ内で商品数がもっとも多いショップや販売数がもっとも多いショップを見つけます。
TikTok Shop Category Products API 活用のヒント
- 市場ごとにカテゴリツリーが異なるため、TikTok Shop Categories でカテゴリIDを取得したときと同じ region を使ってください。
- カテゴリは商品行のフィールドではなくリクエストに由来するため、残す商品には送信した category_id を並べて保存してください。
- 複数のカテゴリや繰り返しの実行をまとめるときは id をキーにし、2回取得された商品を1回だけ数えるようにしてください。
関連API
TikTok Shop Category Products 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 Categories API — TikTok Shop市場のカテゴリツリー全体を、カテゴリID、名前、英語のスラッグ、階層、親カテゴリ、パスとともに取得します。