Instagram 投稿ダウンローダー API

1 回の認証 GET リクエストで公開 Instagram 投稿の URL、キャプション、作成者、エンゲージメント指標を返します——写真・カルーセル・動画投稿対応。

単一 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 投稿ダウンローダー API を使用して公開投稿詳細——URL、キャプション、作成者、エンゲージメント指標——をダウンローダー型プロダクト、リサーチパイプライン、コンテンツモニタリング用に取得。

単一 REST エンドポイント

ベアラー API キーと公開投稿 URL または投稿 ID で GET /v1/instagram/post を呼び出し。Instagram 投稿ダウンローダー API は文書化された HTTP リクエストを通じて投稿詳細を返し、ブラウザ駆動スクレイパーや非公式クライアント SDK を維持せずに投稿情報を取得可能。

URL または投稿 ID 入力

公開投稿 URL を直接、または URL から抽出した投稿識別子を提出——パイプラインが既に持っている形式を使用。両方とも同じ構造化レスポンスに解決され、統合はユーザーからのリンクを別の解析ステップなしで受け入れ可能。

構造化 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 クライアントを採用し、統合を 1 回の標準認証 GET として維持。

使い方

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

API キーを作成

AgentBody アカウントを作成し、コンソールで API キーを生成。キーをサーバー環境または承認済みシークレットストアに保管し、ベアラートークンとして送信。ブラウザコード、パブリックリポジトリ、クライアントサイドバンドルにライブキーを配置しない。

公開投稿を選択

詳細が必要な公開 Instagram 投稿——写真、カルーセル、動画——を選択し、その URL をコピーまたは投稿 ID を抽出。非公開投稿、削除済み投稿、ストーリーは解決しません——ワークフローがカバレッジを必要とする場合は代替を準備。

GET リクエストを構築

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

キーをサーバーサイドに維持

バックエンド、サーバーレス関数、スケジュールジョブからエンドポイントを呼び出し——API キーがブラウザに漏れない場所から。エンドユーザーに検索を公開する場合、独自エンドポイント経由でプロキシし、キーと請求を制御下に維持。

JSON レスポンスを解析

返された id、url、name、text、username、media_type、created_at、metrics フィールドを読み取り。プロダクトが必要とするフィールドのみを保存し、投稿 URL をその作成者とキャプションコンテキストとペアリングし、保持を独自のプライバシーポリシーと整合。

エラーを正しく処理

400 レスポンスはリクエストを修正、401 は有効なキーを設定、402 は残高を補充。502、503、504 レスポンスは一時的な上流状況を示すため、バックオフで再試行——投稿の永続的な問題ではありません。

よくある質問

Instagram 投稿ダウンローダー API とは？

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

無料の Instagram 投稿ダウンローダー API はありますか？

無料 AgentBody アカウントから開始でき、すべての呼び出しはアカウントのクレジットで実行されるため、API はボリュームにコミットする前に無料で試用可能。使用量ベースの価格はゲートウェイが管理し、このページに固定数字は記載しません——現在の呼び出しあたりコストはコンソールで確認。

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

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

Instagram 投稿 API レスポンスには何が含まれますか？

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

API は画像ファイルまたはダウンロードリンクを返しますか？

投稿 URL を含む構造化投稿詳細を返します——再エンコードされたメディアファイルではありません。アプリケーションは公開投稿レコード——リンク、作成者、キャプション、統計——を処理します。メディア処理（ある場合）は Instagram 利用規約内で独自のパイプラインに属します。

API エラーを処理する方法は？

400 でリクエスト形状を修正、401 でベアラーキーを修正、402 で残高を解決。502、503、504 を一時的な上流障害として扱い、バックオフで再試行。再試行前にステータスとエラーコードを記録し、パイプラインが不良リクエストと一時的問題を区別できるようにする。