instagram/
transcript

公開Instagram投稿やリールのURLから文字起こしレコードを抽出し、テキスト、言語、形式、ソースURL、ショートコードを正規化された構造で返します。

Instagram Transcript API

投稿・リールの文字起こし
プレーンテキストまたはWebVTT
ソースに紐づくレコード
結果1件あたり0.7クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Transcript

Instagramの文字起こしレコードには、公開投稿やリールの音声から生成されたテキストが含まれ、言語、出力形式、ソースURL、ショートコード、収集日時を備えています。これらのレコードは、発話内容の検索、アクセシビリティの確認、コンテンツのインデックス作成、ソースに紐づいた調査に活用できます。

Instagram Transcript API の主な機能

  • 複数のソースURL1つ以上の公開Instagram投稿またはリールのURLを送信し、発話を含むメディアの文字起こしレコードを受け取れます。
  • カルーセルに対応した結果1つのカルーセル投稿から複数のメディアの文字起こしが得られる場合は、それぞれ別の文字起こしレコードとして保持します。
  • 正規化されたテキストと取得元情報文字起こしテキストを、言語、プレーンテキストまたはWebVTTの形式、ソースURL、メディア識別子、ショートコード、収集日時とあわせて返します。

Instagram Transcript API のパラメータ

パラメータ必須説明
urls必須1つ以上の公開Instagram投稿またはリールのURLです。カンマまたは改行で区切って指定します。

Instagram Transcript API の使い方

公開InstagramメディアのURLを非同期タスクとして送信し、タスクIDをポーリングして、正規化された文字起こしレコードをすべてカーソルページネーションで読み取ります。

  1. 1つ以上の公開Instagram投稿またはリールのURLを用意します。
  2. urls 配列を /v1/instagram/transcript に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、入力URLごとにレコードが0件または複数件になる場合も照合し、results.has_more が true の間は results.next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/transcript" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.instagram.com/reel/DHsD6HGqJhp/"]}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Instagram Transcript API の主なユースケース

  • 発話内容の検索: 文字起こしテキストを言語、ソースURL、ショートコードとともにインデックス化し、選んだ公開投稿やリールを発話中の語句で検索できるようにします。
  • 投稿・リールの調査: 厳選したURLセット全体で文字起こしテキストを確認し、ソースの確認用にメディア識別子と収集日時を保持します。
  • 字幕・アクセシビリティの確認: 返されたテキストと形式のメタデータを使って読みやすい書き起こしを作成したり、選んだ公開メディアに利用可能な発話レコードがあるかを確認したりします。

Instagram Transcript API 活用のヒント

  • 意図した各ソースが1回だけ処理されるよう、タスクの開始前に正規の公開投稿・リールURLを使い、完全に重複するものは取り除いてください。
  • 音声のないメディアではレコードが返らず、1つのカルーセルURLから複数のレコードが返ることもあるため、URLだけでなくレコードIDで結果を照合してください。
  • 下流の解析処理は format によって分岐させてください。タイミング構造が重要な場合は WebVTT のキューを保持し、plaintext は区切りのないテキストとして扱ってください。
  • created_at にはInstagramメディアの投稿日時が設定されないため、収集の経緯を追う場合は collected_at を使用してください。
  • 文字起こしテキストを分割する場合は、派生した各セグメントにレコードID、ソースURL、ショートコード、language、format、collected_at を保持してください。

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

  • Instagram Posts API — ユーザー名から、公開投稿、メディア、ハッシュタグ、メンション、タイムスタンプ、エンゲージメントを取得します。
  • Instagram Reels API — ユーザー名から、公開リール、メディア、オーディオ、ハッシュタグ、メンション、エンゲージメントを取得します。
  • Instagram Tagged Posts API — 指定したプロフィールがタグ付けされた公開投稿を、投稿者、メディア、メンション、タグ付けされたユーザーの情報、エンゲージメントとともに取得します。
  • Instagram Audio Reels API — 既知の数値オーディオIDから公開リールを取得し、キャプション、クリエイター、メディア、タイムスタンプ、表示中のエンゲージメント、元のオーディオ情報を返します。
  • Instagram Highlight Items API — 既知のハイライトIDから、保存された公開ストーリーズの項目を、テキスト、投稿者情報、メディア、タイムスタンプ、表示中の指標、取得元の情報とともに取得します。
  • Instagram Post Info API — 既知の公開投稿、リール、旧IGTVのURLを検索し、キャプション、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメント、入力情報を返します。

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

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

Instagram Transcript API — よくある質問

Instagram Transcript APIは、公開Instagram投稿またはリールのURLから文字起こしレコードを抽出するためのプログラムインターフェースです。テキスト、言語、プレーンテキストまたはWebVTTの形式、ソースURL、メディア識別子、ショートコード、収集日時を返します。

公開Instagram投稿またはリールのURLを含む、空でない urls 配列を送信してください。このエンドポイントでは、ユーザー名、検索クエリ、単一の url フィールドは使用できません。

いいえ。発話のないメディアでは文字起こしレコードが返らないことがあり、カルーセル投稿では複数のレコードが生成されることがあります。

いいえ。このエンドポイントが受け付けるのは urls のみです。language は、ソース側で公開されている場合にレコードのメタデータとして返されます。

format は通常 plaintext で、返された文字起こしの内容が WebVTT のマークアップで始まる場合は webvtt になります。レコードには、text、language、ID、ソースURL、ショートコード、null の created_at、collected_at も含まれる場合があります。

返された文字起こしレコード1件につき0.7クレジットで、基本料金はかかりません。見積もりは送信したURLの数をもとに算出され、最終的な使用量はカルーセルから得られた複数のレコードも含め、実際のレコード数に基づきます。