SocQはこれまでも、公開されているTikTokのプロフィール、動画、コメント、検索、ハッシュタグに対応してきました。これらについてはTikTokスクレイピングガイドで詳しく説明しています。2026-11-17には、さらに14のTikTokエンドポイントがTikTokのプラットフォームページで公開されました。クリエイターのフォロワーがどこに住んでいるのか、動画の再生数は本物か、今日みんなが何を検索しているのか、LIVE配信でいま何が売られているのか。基本のエンドポイントでは答えられなかった問いに応えるものです。
このガイドでは、新しいエンドポイントを用途別に分け、それぞれのリクエスト例、料金、使いどころを紹介します。
結論: どのエンドポイントも、JSONボディを付けて
https://api.socq.ai/v1/tiktok/<endpoint>にPOSTします。呼び出すとtask_idが返るので、statusがsucceededになるまでGET /v1/tasks/{task_id}をポーリングし、data.results.itemsを読み取ります。
新しいTikTokエンドポイントの一覧
1 SocQクレジット = $0.005です。結果単位で課金されるエンドポイントには基本料金がないため、結果が空なら料金はかかりません。
| エンドポイント | 返される内容 | 料金 |
|---|---|---|
| TikTok Audience Demographics API | フォロワーの国と、その割合およびサンプル数 | 1回あたり20クレジット($0.10) |
| TikTok Fake Views Checker API | フェイク再生スコア、推定フェイク再生数とその割合、トラフィック階層、主な理由 | 1回あたり5クレジット($0.025) |
| TikTok Similar Accounts API | TikTokが類似としておすすめするアカウントと、そのプロフィール文や各種カウント | 1アカウントあたり0.5クレジット($0.0025) |
| TikTok Reposts API | アカウントがリポストした動画と、元の投稿者および統計 | 動画1本あたり0.5クレジット($0.0025) |
| TikTok Playlists API | 公開プレイリストの名前、カバー、動画数 | 1プレイリストあたり0.5クレジット($0.0025) |
| TikTok Trending Searches API | 今日のトレンド検索、約100件のランキング | 1回あたり0.5クレジット($0.0025) |
| TikTok Creator Search Insights API | 人気の検索20件と、人気度スコアおよび7ポイントのトレンド | 1回あたり1クレジット($0.005) |
| TikTok Hashtag Views API | 最大20個のハッシュタグの総動画数と総再生数 | ハッシュタグ1つあたり0.5クレジット($0.0025) |
| TikTok Comment Keywords API | ランク付けされたコメントのキーワードと、その元になったコメント | 1回あたり1クレジット($0.005) |
| TikTok Sound Search API | サウンドとアーティスト、長さ、プレビュー、使用数 | サウンド1つあたり0.6クレジット($0.003) |
| TikTok Photo Search API | フォトカルーセル投稿と、そのすべての画像およびエンゲージメント | 投稿1件あたり0.6クレジット($0.003) |
| TikTok Live Search API | 現在配信中のLIVEと、ホスト、視聴者数、いいね数 | 配信1件あたり0.6クレジット($0.003) |
| TikTok Live Ranking API | LIVEデイリーランキングの最大99人のホストと、ギフトに基づくスコア | 1回あたり0.5クレジット($0.0025) |
| TikTok Live Shopping API | LIVE配信のショッピングバッグに入っている商品と、価格および販売数 | 商品1点あたり0.1クレジット($0.0005) |
認証と非同期タスクの流れ
すべてのリクエストは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がタスクの概要を1回POSTします。レコードはタスクのエンドポイントから読み取ってください。クライアント側でタイムアウトしてもタスクはキャンセルされないため、再送信せずに同じタスクIDで再開してください。402はアカウントのクレジット不足、429はキーがレート制限またはクレジットの上限に達したことを意味します。
契約前にクリエイターを審査する
次の5つのエンドポイントは、クリエイターと契約する価値があるかを判断するのに役立ちます。
Audience Demographicsは、フォロワーのサンプルに含まれるすべての国を、その割合とサンプル内のフォロワー数とともに、多い順に一覧にします。クリエイターのリーチが、自社が販売する市場に届いているかを確認するのに使います。usernameは@があってもなくても動作します。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/user-audience" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame"}'
Fake Views Checkerは、動画またはフォト投稿のURLを受け取り、fake_score、is_suspicious、confidence_level、estimated_fake_views、fake_view_percentage、estimated_organic_views、traffic_tier、main_reasonを返します。任意のcategory(デフォルトはgeneral、ほかにentertainment、education、product、verified_large)で、エンゲージメントのベンチマークを選びます。スポンサー投稿や、リーチに対して費用を払おうとしているクリエイターに対して実行してください。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/fake-views" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
Similar Accountsは、TikTok自身があるユーザー名に類似しているとおすすめするアカウントを、TikTokの並び順で、プロフィール文、フォロワー数、動画数、認証ステータスとともに返します。成果の出ているクリエイターが1人いれば、その周辺に候補リストを広げられます。results_limitのデフォルトは30(1〜300)です。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/similar-users" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "khaby.lame", "results_limit": 30}'
Repostsは、アカウントが自分の投稿以外に何を拡散しているかを示します。リポストした各動画を、元の投稿者、キャプション、再生数、いいね数、ハッシュタグ、動画ファイルとともに、新しい順に返します。results_limitのデフォルトは20(1〜500)です。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/user-reposts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "mrbeast", "results_limit": 20}'
Playlistsは、クリエイターの公開プレイリストを名前、カバー、item_countとともに一覧にします。クリエイターが繰り返し取り組んでいるシリーズや形式が分かります。results_limitのデフォルトは20(1〜100)です。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/user-playlists" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username": "zachking"}'
1人のクリエイターをAudience Demographics、最近の動画3本のFake Views、類似アカウント30件でひととおりチェックすると、20 + 15 + 15 = 50クレジット($0.25)です。
みんなが検索し、話題にしていることを見つける
Trending Searchesは入力が不要で、今日のトレンド検索約100件をTikTokの並び順で、それぞれの検索リンクとともに返します。リストは毎日更新されるため、コンテンツのアイデアを集める朝のフィードとして便利です。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/trending-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
Creator Search Insightsは、人気の検索20件を、0〜100の人気度スコア、7ポイントのトレンド、関連動画数、カテゴリ、ラベルとともに返します。フィールドはすべて任意です。language(デフォルトはen、ほかにar、de、es、fr、id、ja、ko、pt、th、tr、vi)、category(fashion、food、gaming、science、sports、tourism)、filter_byを指定できます。filter_byをcontent_gapにすると、需要はあるのにまだ動画が少ない検索が得られます。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/search-insights" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"language": "en", "category": "food", "filter_by": "content_gap"}'
Hashtag Viewsは、1回のリクエストで最大20個のハッシュタグを、総動画数と総再生数で比較します。存在しないタグはスキップされ、課金されません。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/hashtag-detail" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"hashtags": ["cooking", "booktok"]}'
Comment Keywordsは、にぎわっているコメント欄を代わりに読み解きます。出現頻度の高いキーワードをランキングにし、それぞれに言及しているコメントとそのいいね数を返します。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/comment-keywords" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.tiktok.com/@tiktok/video/7460937381265411370"}'
TikTokがクエリの下に表示する検索語については、TikTok Top Searchガイドを参照してください。
サウンドとフォト投稿を検索する
Sound Searchは、タイトル、アーティスト、雰囲気でサウンドライブラリを検索し、サウンドID、アーティスト、カバー、長さ、再生可能なプレビュー、metrics.videos_countを返します。sort_byはrelevance(デフォルト)、most_used、latestのいずれかで、regionのデフォルトはUSです。取得したIDはTikTok Song Videosで使えるほか、TikTokミュージックチャートガイドのチャートと比較することもできます。results_limitのデフォルトは20(1〜500)です。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/search-music" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "lofi", "results_limit": 20}'
Photo Searchはフォトカルーセル投稿だけを返します。カルーセル内のすべての画像に加え、キャプション、投稿者、ハッシュタグ、再生数、いいね数、コメント数、シェア数が含まれます。results_limitのデフォルトは20(1〜500)です。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/search-photos" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "outfit ideas", "results_limit": 20}'
TikTok LIVEとLIVEショッピングを追跡する
Live Searchは、リクエスト時点で配信中のLIVEを探し、タイトル、ホスト、現在の視聴者数、いいね数、開始時刻を返します。results_limitのデフォルトは20(1〜200)です。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/search-live" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query": "deals", "results_limit": 20}'
Live Shoppingは、配信のショッピングバッグに入っている商品を、タイトル、現在の価格、販売数、販売者、画像とともに一覧にします。Live Searchの各結果のidとauthor.idが、このエンドポイントが受け取るroom_idとuser_idになるため、配信がまだ続いているうちに呼び出してください。results_limitのデフォルトは100(1〜500)で、商品のない配信には課金されません。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/live-products" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"room_id": "7704767945901132575", "user_id": "7153432386608251946", "results_limit": 100}'
Live Rankingは入力が不要で、現在のLIVEデイリーランキングから最大99人のホストを、順位、ギフトに基づくスコア、ユーザー名、フォロワー数とともに返します。(ドキュメント)
curl -X POST "https://api.socq.ai/v1/tiktok/live-ranking" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{}'
特定のアカウントが配信中かどうかを確認するには、TikTok Live Statusガイドで紹介しているエンドポイントを使ってください。
関連するTikTokガイド
TikTok Creative Centerの広告とクリエイター料金はTikTok Creative Center APIガイドで、新しいTikTok ShopのエンドポイントはTikTok Shop商品リサーチガイドで解説しています。SocQとほかのプロバイダーを比較するには、おすすめのTikTokスクレイパーAPI 7選とTikTok APIの代替サービスをお読みください。
よくある質問(FAQ)
リポストやプレイリストがないアカウントでも課金されますか?
いいえ。結果単位のエンドポイントには基本料金がなく、ドキュメントにも結果が空の場合は課金されないと記載されています。
Fake Views Checkerはどのようにフェイクを判定しますか?
動画のエンゲージメントを、categoryで選んだコンテンツの種類のベンチマークと比較し、スコア、推定フェイク再生数とその割合、トラフィック階層、主な理由を返します。最終判断ではなく、確認すべき推定値として扱ってください。
Live Shoppingのroom_idとuser_idはどこで取得できますか?
TikTok Live Searchから取得します。結果のidがroom_id、author.idがuser_idです。配信がまだ続いている必要があります。
Trending SearchesとCreator Search Insightsの違いは何ですか?
Trending Searchesは、TikTokがランク付けした今日の検索約100件のリストで、0.5クレジットです。Creator Search Insightsは、人気度スコアと7ポイントのトレンドが付いた検索20件を返し、言語、カテゴリ、コンテンツギャップで絞り込めます。こちらは1クレジットです。