Instagram オーディオダウンローダー API
1回の POST で公開 Instagram リールや動画から音声を抽出。レスポンスは永久 MP3 ダウンロード URL と標準化されたトラックメタデータを返します。
- 1回の POST、1つの音声ファイル
- 永久ダウンロード URL
- すべての公開投稿タイプに対応
- 標準化されたトラックメタデータ
- 冪等キーサポート
- サーバーサイドキー必須
リクエスト例
curl -X POST "https://api.agentbody.io/v1/instagram/audio/download" \
-H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
-H "Content-Type: application/json" \
-d '{"url":"YOUR_URL"}'レスポンス例
OpenAPI 仕様に記載されたレスポンス。
Retained Instagram audio file URL and normalized public track metadata.
{
"artist": "Example Artist",
"audio_type": "licensed",
"audio_url": "https://api.apify.com/v2/key-value-stores/example/records/audio_DcSAqhCTTrX.m4a",
"cover_url": "https://example.com/cover.jpg",
"duration_ms": 175453,
"file_size_bytes": 1833377,
"is_trending": true,
"post_url": "https://www.instagram.com/reel/DcSAqhCTTrX/",
"shortcode": "DcSAqhCTTrX",
"title": "Example Track"
}機能特徴
instagram.audio_download 操作は1つの公開 Instagram 投稿から音声トラックを抽出します。サーバーが API キーを保持；エンドポイントは1回の呼び出しで永久ダウンロード URL と標準化されたメタデータを返します。
1回の POST、1つの音声ファイル
POST /v1/instagram/audio/download に公開 Instagram URL を送信します。成功した 200 は shortcode、post_url、audio_url、title、artist、duration_ms、file_size_bytes、cover_url、audio_type、is_trending を返します——ダウンローダーパイプラインに必要なすべてが1つのレスポンスに含まれています。
永久ダウンロード URL
audio_url は期限切れの CDN リダイレクトではなく、完全に保存されたファイルを指しています。どのサーバー、どの IP、いつでもダウンロードできるため、抽出を再実行せずにキューワーカー、メディアサーバー、またはエンドユーザーに直接渡すことができます。
すべての公開投稿タイプに対応
url パラメータはリール、標準動画投稿、IGTV リンクを受け入れます。API は投稿の音声トラックを自動的に解決します；非公開、削除、または制限された投稿はファイルではなく 400 または 502 エラーを返します。
標準化されたトラックメタデータ
すべてのレスポンスには、トラックタイトル、アーティスト名、再生時間（ミリ秒）、ファイルサイズ（バイト）、カバー画像 URL、音声分類（licensed、original、または none）、トレンドフラグが含まれます——クリエイターのアップロード方法に関係なく、すべての投稿で一貫しています。
冪等キーサポート
Idempotency-Key ヘッダーを渡して、重複課金なしで失敗したリクエストを安全に再試行します。ゲートウェイはキーで重複を排除するため、ネットワーク再試行が同じ投稿の2回目の抽出をトリガーすることはありません。
サーバーサイドキー必須
エンドポイントはサーバーが保持する AgentBody API キーが必要です。クライアントサイドコードでキーを公開しないでください；すべての呼び出しをバックエンド経由でルーティングしてキーを安全に保ち、使用量を追跡します。
使い方
API で Instagram 音声抽出を3ステップで統合。
API キーを取得
無料 AgentBody アカウントを作成し、ダッシュボードから API キーを生成します。キーはすべてのリクエストを認証し、残高に対する使用量を追跡します。
投稿 URL を POST
/v1/instagram/audio/download に POST リクエストを送信し、リクエストボディに公開 Instagram 投稿 URL を含めます。安全な再試行のために Idempotency-Key ヘッダーを含めます。
ダウンロードリンクを受信
成功した 200 レスポンスは永久 audio_url とトラックメタデータを返します。リンクから直接 MP3 をダウンロードするか、メディアパイプラインに渡してストレージと配信を行います。
よくある質問
Instagram オーディオダウンローダー API はどのように動作しますか？
/v1/instagram/audio/download に POST リクエストと公開 Instagram 投稿 URL を送信します。API は音声トラックを抽出し、MP3 ファイルとして保存し、タイトル、アーティスト、再生時間、ファイルサイズを含む標準化されたメタデータとともに永久ダウンロード URL を返します。
どの Instagram URL 形式がサポートされていますか？
API はリール URL（instagram.com/reel/{shortcode}）、標準動画投稿 URL（instagram.com/p/{shortcode}）、IGTV URL（instagram.com/tv/{shortcode}）、共有リンクを受け入れます。投稿は公開アクセス可能である必要があります；非公開または制限された投稿はエラーを返します。
レスポンス形式は何ですか？
成功した 200 レスポンスは JSON オブジェクトを返します：shortcode、post_url、audio_url（永久 MP3 ダウンロードリンク）、title、artist、duration_ms、file_size_bytes、cover_url、audio_type（licensed/original/none）、is_trending（ブール値）。
レート制限や使用上限はありますか？
各成功した抽出は、ゲートウェイ管理価格で AgentBody 残高から固定金額を消費します。アカウント残高を超える個別のレート制限はありません；失敗したリクエスト（400、502 など）は課金されません。再試行時の重複課金を防ぐために Idempotency-Key ヘッダーを使用してください。
非公開 Instagram アカウントから音声を抽出できますか？
いいえ。API は公開利用可能な投稿のみを処理できます。非公開アカウント、削除された投稿、年齢制限コンテンツは Instagram プラットフォームによって拒否され、400 または 502 エラーを返します。
この API を使用して Instagram 音声をダウンロードするのは合法ですか？
自分が所有している、保存する許可を得ている、またはその他の合法根拠がある公開利用可能なコンテンツにのみ API を使用してください。著作権法と Instagram の利用規約を尊重してください。API は非公開または制限されたコンテンツには一切アクセスできません。