Instagram Video Download API

認証付き GET リクエスト 1 回で、公開 Instagram 投稿の URL、キャプション、クリエイター、エンゲージメント指標を整えられた JSON で取得。ダウンローダー系ワークフローとデータパイプラインにそのまま使えます。

単一の REST エンドポイント
URL または投稿 ID 入力
構造化 JSON 出力
投稿とクリエイターの文脈
予測可能なエラーコード
5 言語のサンプル

リクエスト例

curl "https://api.agentbody.io/v1/instagram/post?post_id=1234567890123456789&url=https%3A%2F%2Fwww.instagram.com%2Fp%2FDcLs3w6GZGH%2F" \
  -H "Authorization: Bearer <YOUR_AGENTBODY_API_KEY>"

レスポンス例

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

Successful Gateway result.

{
  "id": "example_id"
}

機能特徴

Instagram Video Download API を使って公開投稿の詳細——URL、キャプション、クリエイター、エンゲージメント指標——を取得し、ダウンローダー系製品、調査パイプライン、コンテンツ監視に活用します。

単一の REST エンドポイント

Bearer API キーと公開投稿の URL または投稿 ID を付けて GET /v1/instagram/post を呼び出します。Instagram 動画ダウンロード API はドキュメント化された HTTP リクエスト 1 回で投稿詳細を返すため、ブラウザ駆動スクレイパーや非公式クライアント SDK を維持せずに投稿情報を取得できます。

URL または投稿 ID 入力

公開投稿の URL をそのまま送信するか、そこから抽出した投稿 ID を送信できます。パイプラインがすでに持っている方を使えばよく、両方とも同じ構造化レスポンスに解決されるため、ユーザーからのリンクを別の解析ステップなしで受け付けられます。

構造化 JSON 出力

予測可能な JSON レスポンスで、id、url、name、text、username、media_type、created_at、および再生・いいね・コメント・シェア数を含む metrics オブジェクトを受け取ります。投稿レコードの保存、コレクションの構築、下流分析パイプラインへの供給に適した構造です。

投稿とクリエイターの文脈

すべてのレスポンスで、投稿 URL がキャプション、クリエイターのユーザー名、投稿日とペアで返されます。ダウンローダーのワークフロー、アーカイブシステム、調査ツールは、文脈のない裸のリンクではなく、完全で引用可能な公開投稿の記録を得られます。

予測可能なエラーコード

失敗はドキュメント化されたステータスコードで処理します。400 は無効なリクエスト、401 は API キーの欠落または誤り、402 は残高不足、502、503、504 は一時的な上流の問題です。各レスポンスが問題の種別を識別するため、リトライとアラートのロジックはシンプルに保てます。

5 言語のサンプル

このページのリクエスト例は、API の OpenAPI 定義から curl、JavaScript、Python、Java、Go で自動生成されています。すでに使っている言語と HTTP クライアントをそのまま採用でき、統合は標準的な認証付き GET 1 回です。

使い方

次の 6 ステップで Instagram Video Download API を呼び出します。公開投稿の URL または ID を渡し、返された詳細をアプリケーションで処理します。

API キーを作成

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

公開投稿を選ぶ

詳細が必要な公開 Instagram 動画・リールを選び、URL をコピーするか投稿 ID を抽出します。非公開の投稿、削除済みの投稿、ストーリーズは解決できないため、カバレッジが必要な場合は代替を用意してください。

GET リクエストを構築

url または post_id クエリパラメータを付けて /v1/instagram/post に認証付き GET リクエストを送信します。このページの生成例が curl、JavaScript、Python、Java、Go での正確なリクエストを示しているため、サービスが使っている HTTP クライアントにそのまま合わせられます。

キーはサーバー側に

バックエンド、サーバーレス関数、定期ジョブなど、API キーがブラウザに露出しない場所から呼び出します。エンドユーザーに検索を提供する場合は、自分のエンドポイントでプロキシし、キーと課金を自分の管理下に置いてください。

JSON レスポンスを解析

返された id、url、name、text、username、media_type、created_at、metrics の各フィールドを読み取ります。製品に必要なフィールドだけを保存し、投稿 URL はクリエイターとキャプションの文脈とペアで保持し、保持期間は自社のプライバシーポリシーに合わせてください。

エラーを正しく処理

400 はリクエストを修正、401 は有効なキーを設定、402 は残高を解決してください。502、503、504 は投稿自体の恒久的な問題ではなく一時的な上流の状態を示すため、バックオフ付きでリトライしてください。

よくある質問

Instagram Video Download API とは何ですか？

Instagram Video Download API は、認証付き GET エンドポイント /v1/instagram/post です。公開 Instagram 投稿の詳細——URL、キャプション、クリエイターのユーザー名、投稿日、メディアタイプ、エンゲージメント指標——を構造化 JSON で返します。公開投稿の URL または投稿 ID と Bearer API キーを送信し、レスポンスをアプリケーションで処理します。

無料の Instagram 動画ダウンロード API はありますか？

無料の AgentBody アカウントで始められ、すべての呼び出しはアカウントのクレジットで実行されるため、本格的な利用前に無料で試せます。従量課金の価格はこのページの固定数値ではなくゲートウェイが管理するため、現在の 1 回あたりのコストはコンソールで確認してください。

Instagram ダウンロード API スクレイパーの代替になりますか？

公開投稿の詳細に関しては、はい。ブラウザ自動化、プロキシ、パースコードを維持する Instagram ダウンロードスクレイパーの代わりに、ドキュメント化された 1 つの REST エンドポイントを呼び出して安定した JSON フィールドを受け取れます。API が読み取るのは公開データのみで、非公開や削除済みの投稿を回避する手段ではありません。

レスポンスにはどのフィールドが含まれますか？

成功レスポンスには id、url、name、text、username、media_type、created_at、および再生・いいね・コメント・シェア数を含む metrics オブジェクトが含まれます。url フィールドが投稿のリンクで、metrics はリクエスト時点のエンゲージメントを記録します。これらのフィールドは保存、検索、分析のワークフローに直接使えます。

動画ファイルやダウンロードリンクは返りますか？

投稿 URL を含む構造化された投稿詳細が返ります。再エンコードされたメディアファイルではありません。アプリケーションが扱うのは公開投稿の記録——リンク、クリエイター、キャプション、統計——です。メディア処理が必要な場合は、Instagram の規約の範囲内で独自のパイプラインで行ってください。

API エラーはどう処理すればよいですか？

400 はリクエストの形を修正し、401 は Bearer キーを直し、402 は残高を解決してください。502、503、504 は一時的な上流の失敗としてバックオフ付きでリトライします。リトライ前にステータスとエラーコードを記録し、パイプラインが不正なリクエストと一時的な問題を区別できるようにしてください。