Skip to main content
GET
認証済みプロファイルに関連付けられた利用可能な Instagram 広告アカウントを取得します。 このエンドポイントを使用すると、基本的なアカウント情報および広告アカウントの主要メトリクスにアクセスできます。
  • metrics オブジェクトには、アカウント内のすべての広告にわたる集計パフォーマンスデータが含まれます
  • 結果は 10 分間キャッシュされ、パフォーマンスを最適化して Instagram への API 呼び出しを削減します
  • JSON レスポンス中のアカウントステータスは、activedisabledunsettledpending_risk_reviewpending_settlementin_grace_periodpending_closureclosedany_activeany_closed のいずれかになります
これらのエンドポイントを利用するには、広告管理権限を付与して Facebook 経由で接続された Instagram ビジネスアカウントが必要です。この権限がない場合は、Facebook 経由で再連携してください。Instagram Login はサポートされていません。Meta 広告アカウントには Facebook と Instagram 両方の広告が含まれる場合があり、アカウント一覧は Instagram 専用の一覧ではありません。送信された広告および履歴は Instagram のみを対象とします。
広告 URL には facebook または instagram を使用してください。その他のプラットフォーム値を指定すると、HTTP 400 と code: 101 が返されます。

Header Parameters

Query Parameters

number
デフォルト:100
返される広告アカウントの数を制限します。