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つ以上の公開Instagram投稿またはリールのURLを用意します。
- urls 配列を /v1/instagram/transcript に POST します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- /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 trueInstagram 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 を保持してください。
関連API
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 Followers Count API
- Instagram Search API
- Instagram Comments API
- Instagram Profiles API
- Instagram Followers List API
- Instagram Following List API
- Instagram Hashtag Posts API
- Instagram Reels Search API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Hashtag Search API
- Instagram Account Age Checker API