Instagram to MP4 API

認証付き POST 1 回で公開 Instagram 動画またはリール URL を保持された MP4 ファイルリンクに変換——カバー画像、クリエイター、エンゲージメント統計をきれいな JSON で。

単一 REST エンドポイント
すべての動画リンク形式
完全な文脈付きファイル
リールと IGTV を含む
冪等な課金書き込み
予測可能なエラーコード

リクエスト例

curl -X POST "https://api.agentbody.io/v1/instagram/video/download" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"url":"YOUR_URL"}'

レスポンス例

OpenAPI 仕様に記載されたレスポンス。

Retained Instagram media link and normalized public post metadata.

{
  "author_name": "Example Author",
  "author_username": "example",
  "comment_count": 310,
  "duration_seconds": 29.5,
  "like_count": 18420,
  "media_type": "video",
  "play_count": 512334,
  "post_url": "https://www.instagram.com/reel/DWocNOhgmgg/",
  "shortcode": "DWocNOhgmgg",
  "text": "Example caption",
  "thumbnail_url": "https://example.com/cover.jpg",
  "video_content_type": "video/mp4",
  "video_url": "https://api.apify.com/v2/key-value-stores/example/records/DWocNOhgmgg.mp4"
}

機能特徴

Instagram to MP4 API でダウンローダー、転用パイプライン、コンテンツツールを支えます。動画 URL を入れ、完全な投稿文脈付きの保持 MP4 リンクを得る。

単一 REST エンドポイント

bearer API キーと動画 URL を付けて POST /v1/instagram/video/download を呼びます。API が MP4 を保存し保持されたファイルリンクを返します。ブラウザ自動化もスクレイピング基盤も非公式クライアント SDK の維持も不要です。

すべての動画リンク形式

リールリンク、/p/ 投稿リンク、/tv/ リンク、アプリ共有リンクがすべて同じリクエストで解決します。統合側はユーザーが貼るものをそのまま受け付けます。

完全な文脈付きファイル

毎回のレスポンスは video_url に thumbnail_url、shortcode、キャプション、作者名とユーザー名、再生時間、再生・いいね・コメント数を組み合わせます。ダウンローダーとアーカイブのための完全な記録です。

リールと IGTV を含む

Instagram リール、標準の動画投稿、長めの IGTV 型クリップが同一に解決します。1 つの統合で、ユーザーが貼るあらゆる種類の Instagram 動画をカバーします。

冪等な課金書き込み

動画保存は従量課金です。再試行時に Idempotency-Key ヘッダーを送ると、中断されたレスポンスが同じ動画の二重課金になりません。同一キーの同一リクエストは元の結果を返します。

予測可能なエラーコード

ドキュメント化されたステータスコード：400 は無効なリクエスト、401 はキーの不足または誤り、409 は冪等性の競合、502/503/504 は一時的な上流の問題。各クラスは明確な修正または再試行アクションに対応します。

使い方

次の 6 ステップで Instagram to MP4 API を呼び出します。キーを作成し、動画 URL を渡し、返された MP4 リンクを処理します。

API キーを作成

AgentBody アカウントを作成し、コンソールで API キーを生成します。キーはサーバー環境または承認されたシークレットストアに保管し bearer トークンとして送信します。本番キーをブラウザコードに置かないでください。

公開動画を選択

変換する公開 Instagram 動画またはリールを選び、URL をコピーします。非公開アカウントのリンクと削除済み投稿は解決しません。ワークフローにカバレッジが必要な場合は代替を用意してください。

リクエストを構築

必須の url と Idempotency-Key ヘッダーを付けて /v1/instagram/video/download に POST を送信します。生成例は 5 つの言語での正確なリクエストを示します。

キーはサーバー側に

バックエンド、サーバーレス関数、定期ジョブからエンドポイントを呼びます。API キーがブラウザに出ない場所ならどこでも構いません。エンドユーザーに変換を開放する場合は独自エンドポイントでプロキシしてください。

出力を処理

返された video_url、thumbnail_url、キャプション、クリエイター、エンゲージメントのフィールドを読み取ります。MP4 リンクをメタデータと一緒に保存します。スキーマはリクエスト間で安定です。

エラーを正しく処理

400 はリクエストを修正し、401 は有効なキーを設定し、409 はドキュメント化された冪等キーの動作に従います。502/503/504 は同じキーの下でバックオフ付きで再試行します。

よくある質問

Instagram to MP4 API とは何ですか？

認証付き POST エンドポイント /v1/instagram/video/download です。公開 Instagram 動画またはリールを保持された MP4 ファイルリンクとして保存し、カバー画像 URL、キャプション、クリエイター、再生時間、再生・いいね・コメント数と共にきれいな JSON で返します。

無料の Instagram to MP4 API はありますか？

無料の AgentBody アカウントで始められ、すべての呼び出しはアカウントのクレジットで実行されるため、量を決める前に無料で試せます。従量課金の価格はゲートウェイが管理し、このページの固定数値ではありません。

Instagram のリールを MP4 に変換できますか？

はい——リールは標準の動画投稿と同じリクエストで解決されます。リールの URL を送信すると、レスポンスは MP4 リンクとリールのカバー画像、エンゲージメントを返します。1 つの統合で両方をカバーします。

レスポンスには何が含まれますか？

video_url（保持された MP4 リンク）、thumbnail_url、shortcode、post_url、text（キャプション）、author_name、author_username、media_type、duration_seconds、そして play_count/like_count/comment_count です。

IGTV リンクに対応していますか？

はい——/tv/ リンクはリールや標準投稿と同じ方法で解決されます。1 つのリクエスト構造で、ユーザーが送信するあらゆる種類の動画をカバーします。

API エラーの処理方法は？

400 はリクエスト構造を修正し、401 は bearer キーを修正し、409 はドキュメント化された冪等キーの動作に従います。502、503、504 は一時的な上流の障害としてバックオフ付きで再試行してください。再試行前にステータスとエラーコードをログに残し、パイプラインが不良リクエストと一時的な問題を区別できるようにします。