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 の使い方
キーワードで検索し、一致する写真投稿をページごとに取得します。
- {"query": "outfit ideas", "results_limit": 20} を /v1/tiktok/search-photos に POST します。
- status が succeeded になるまで GET /v1/tasks/{task_id} をポーリングします。
- 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 を使ってください。多くの写真投稿はクリエイター自身のサウンドを使っていて、そのタイトルは「オリジナル楽曲」のような汎用的な表記にすぎないためです。
関連API
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 Videos API
- TikTok Comment Replies API
- TikTok Followers List API
- TikTok Following List API
- TikTok User Videos API
- TikTok Trending Feed API
- TikTok Video Transcript API
- TikTok Search Users API
- TikTok Song API
- TikTok Song Videos API
- TikTok Popular Songs API
- TikTok Top Search API
- TikTok User Live API
- TikTok Audience Demographics API
- TikTok Similar Accounts API
- TikTok Reposts API
- TikTok Playlists API
- TikTok Hashtag Views API
- TikTok Sound Search API
- TikTok Live Search API
- TikTok Trending Searches API
- TikTok Creator Search Insights API
- TikTok Live Ranking API
- TikTok Live Shopping API
- TikTok Fake Views Checker API