tiktok/
search-photos

キーワードでTikTokの写真カルーセル投稿だけを検索します。動画は除外し、全スライドの画像に加えて、キャプション、ハッシュタグ、投稿者、再生数・いいね数・コメント数・シェア数を取得できます。

TikTok Photo Search API

キーワード検索
写真投稿のみ
カルーセルの全画像
結果1件あたり0.6クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

TikTok Photo Search

TikTokの写真投稿は、キャプション、ハッシュタグ、サウンドとともに公開されるスワイプ式の静止画セットで、動画と同じく再生数、いいね数、コメント数、シェア数が集計されます。こうした投稿だけを検索すれば、コーデ一覧やレシピの手順からリスト形式、商品まとめまで、あるテーマにどんなビジュアルの形式が効いているかがわかります。

TikTok Photo Search API の主な機能

  • 写真投稿だけを取得結果はすべて写真カルーセルで動画は除外されるため、キーワード検索が動画の結果に埋もれません。
  • 全スライドとサイズmedia には投稿のすべての画像が、スライドの順に type、url、幅、高さとともに並びます。
  • エンゲージメントと投稿の文脈metrics に、いいね数、コメント数、シェア数、再生数、閲覧数が入ります。投稿ごとに、text のキャプション、ハッシュタグ、メンション、サウンド、投稿者のプロフィール項目も付きます。

TikTok Photo Search API のパラメータ

パラメータ必須説明
query必須写真投稿を探すキーワードです。
results_limit任意取得する写真投稿の件数です。1〜500の範囲で指定し、デフォルトは20です。

TikTok Photo Search API の使い方

キーワードで検索し、一致する写真投稿をページごとに取得します。

  1. {"query": "outfit ideas", "results_limit": 20} を /v1/tiktok/search-photos に POST します。
  2. status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
  3. results.items から写真投稿を読み取り、has_more が true の間は results.next_cursor を渡して続きを取得します。
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}'

# media holds every image of each carousel, in slide order.

TikTok Photo Search API の主なユースケース

  • スライドショー形式のベンチマーク: キーワードのカルーセルについて、media の画像枚数と、いいね数・コメント数・シェア数・再生数を比べると、何枚構成が反応を得ているかがわかります。
  • キャプションとハッシュタグの調査: キーワードで反応の良い写真投稿から text と hashtags を読み取り、成果の出ているコンテンツをクリエイターがどう書き、どうタグ付けしているかを調べます。
  • ビジュアルトレンドのボード作成: ファッション、フード、旅行などのコンテンツ向けに、outfit ideas のようなキーワードの上位投稿のスライド画像を集めて、参考ボードを作ります。

TikTok Photo Search API 活用のヒント

  • いいね数そのものではなく、いいね数・コメント数・シェア数の合計を views_count で割った値で順位づけすると、小さなアカウントの良質な投稿が大きなアカウントに埋もれません。views_count が空または0の投稿は除いてください。
  • テーマの言い回しごとに別のクエリとして実行し(outfit ideas と ootd など)、結果を統合するときは id で重複を除いてください。1つのスライドショーが複数のクエリに一致することがあります。
  • ファイルが必要な場合は、タスクの完了後すぐにスライド画像をダウンロードしてください。TikTokは有効期限つきの署名付きリンクで配信しています。
  • サウンドごとにまとめるときは audio.title ではなく audio.id を使ってください。多くの写真投稿はクリエイター自身のサウンドを使っていて、そのタイトルは「オリジナル楽曲」のような汎用的な表記にすぎないためです。

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

  • TikTok Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、アカウント属性、オーディエンス数を取得します。
  • TikTok Hashtags API — 指定したハッシュタグの公開動画、クリエイター、メディア、サウンド、エンゲージメントを取得します。
  • TikTok Comments API — 公開トップレベルコメント、投稿者、エンゲージメント、メンション、クリエイターとのやり取りを示すフラグを取得します。
  • TikTok Search API — キーワードで公開動画を検索します。対応する並び順と公開日のフィルターを指定できます。
  • TikTok Live Room Info API — ルームIDと配信者IDの組み合わせで既知のライブ配信ルーム1件を検索し、ステータス、配信者情報、カバーメディア、視聴者数を返します。
  • TikTok Comment Keywords API — 動画のコメントで最も多く出てくるキーワードを、その根拠となるコメントとともに探します。

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

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

TikTok Photo Search API — よくある質問

TikTok Photo Search APIは、キーワードでTikTokの写真カルーセル投稿を検索するためのプログラムインターフェースです。投稿ごとのすべての画像に加え、キャプション、投稿者、ハッシュタグ、再生数・いいね数・コメント数・シェア数を返します。

このエンドポイントが返すのは写真カルーセルだけで、動画は結果に含まれません。

実用上は同じです。TikTokはこの形式を写真投稿やフォトモードと呼び、クリエイターはスライドショーやカルーセルと呼びます。ここでの結果は、そうした投稿1件が1レコードで、スライドは media に入ります。

すべてです。media にスライドの順にすべての画像が並び、それぞれに url、幅、高さが付きます。

いいえ。結果に含まれるのはいいね数、コメント数、シェア数、再生数、閲覧数で、保存数はありません。

Top Search はキーワードに対して動画と写真カルーセルが混ざって返りますが、Photo Search はカルーセルだけを残すため、どの結果にも media に画像が入っています。

results_limit には1〜500を指定でき、デフォルトは20です。返された写真投稿は1件につき0.6クレジットで、一致する写真投稿がない検索は無料です。