instagram/
posts

1つ以上のユーザー名から公開Instagram投稿を収集し、正規化されたキャプション、投稿者情報、メディア、ハッシュタグ、メンション、タイムスタンプ、表示中のエンゲージメントを返します。

Instagram Posts API

投稿
メディアのメタデータ
公開データ
結果1件あたり0.34クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

Instagram Posts

Instagram投稿は、キャプション、投稿者情報、画像または動画、タイムスタンプ、ハッシュタグ、メンション、表示中のエンゲージメントを含むフィード上のコンテンツです。これらのコンテンツシグナルは、クリエイター調査、キャンペーンの振り返り、メディア分析、過去データのレポーティングに活用できます。

Instagram Posts API の主な機能

  • ユーザー名による投稿収集1つ以上のユーザー名の公開Instagram投稿を、正規化された1つのレスポンス形式で収集します。
  • メディアの参照情報とサイズ公開メディアとサムネイルの参照情報、サイズ、動画の長さを、正規化された media フィールドで返します。
  • 写真・動画のレコード公開されている写真投稿と動画投稿を、同じレスポンス構造に正規化します。
  • コンテンツとエンゲージメントのフィールド各投稿レコードに、キャプション、投稿者情報、投稿日時、表示中の指標、ハッシュタグ、メンションを含めます。
  • 公開データの範囲非公開、削除済み、制限付き、ログインが必要なコンテンツはレスポンスの対象外です。

Instagram Posts API のパラメータ

パラメータ必須説明
usernames必須@ を付けない公開Instagramユーザー名です。カンマまたは改行で区切って指定します。
results_limit任意収集タスクがリクエストするレコードの最大件数です。正の整数で指定してください。

Instagram Posts API の使い方

公開ユーザー名を非同期タスクとして送信し、タスクIDをポーリングして、正規化された投稿レコードをカーソルページネーションで読み取ります。

  1. @ を付けない1つ以上の公開Instagramユーザー名を用意します。
  2. usernames と任意の results_limit を /v1/instagram/posts に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、さらにレコードがある場合は results.next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["natgeo"],"results_limit":25}'

# Poll GET /v1/tasks/{task_id}, then read /v1/tasks/{task_id}?limit=50 and use data.results.

Instagram Posts API の主なユースケース

  • プロフィールの投稿収集: 選んだInstagramユーザー名の公開投稿を、メディアの参照情報と固定IDを備えた正規化レコードとして収集します。
  • コンテンツ調査: 調査チームや分析チームが確認する投稿について、公開キャプション、タイムスタンプ、ハッシュタグ、表示中のエンゲージメント数を収集します。
  • アーカイブワークフロー: 公開投稿のメタデータ、メディアの参照情報、投稿者情報、ソースURL、収集日時を、レビューキュー、レポーティングシステム、社内記録に保存します。
  • キャンペーンの品質確認: クリエイターやブランドのユーザー名で返された公開投稿を確認してから、選んだレコードをキャンペーンデータと結合します。
  • プロフィールのコンテンツ情報補完: 投稿ID、投稿者情報、キャプション、メディアの参照情報、表示中の指標を、既存のプロフィールやキャンペーンのレコードと結合します。

Instagram Posts API 活用のヒント

  • ユーザー名は先頭の @ を付けずに送信し、新しいワークフローを検証している間はバッチを小さく保ってください。
  • ソース側の状況によっては、一部の公開レコードでメディアの参照情報、カウンター、タイムスタンプが欠けることがあります。
  • 429、チャレンジ、一時的なブロックのレスポンスに対しては、積極的にリトライするのではなく、控えめなリトライとバックオフを適用してください。
  • プロフィール単位のリール収集には Reels API、アカウントの発見には Search API、公開コメントスレッドが重要な場合は Comments API を使用してください。
  • 非公開アカウント、ストーリーズ、ハイライト、ログインが必要なフィールドを前提にしたワークフローは設計しないでください。

Instagram Posts API 以外に別の種類の公開Instagramデータが必要な場合は、これらのAPIをご利用ください。

  • Instagram Reels API — ユーザー名から、公開リール、メディア、オーディオ、ハッシュタグ、メンション、エンゲージメントを取得します。
  • Instagram Comments API — 投稿URLから、公開コメント、投稿者、タイムスタンプ、いいね、返信を取得します。
  • Instagram Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、リンク、アカウント属性、カテゴリ、表示中のカウントを取得します。
  • Instagram Tagged Posts API — 指定したプロフィールがタグ付けされた公開投稿を、投稿者、メディア、メンション、タグ付けされたユーザーの情報、エンゲージメントとともに取得します。
  • Instagram Transcript API — 公開投稿またはリールのURLから、文字起こしテキスト、言語、形式、元のURL、ショートコードを抽出します。
  • Instagram Post Info API — 既知の公開投稿、リール、旧IGTVのURLを検索し、キャプション、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメント、入力情報を返します。

他のプラットフォームを見る

Instagramのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Instagram Posts API — よくある質問

Instagram Posts APIは、1つ以上のInstagramユーザー名について、公開されている投稿を収集するAPIです。正規化されたキャプション、投稿者情報、メディアの参照情報、ハッシュタグ、メンション、タイムスタンプ、表示中のエンゲージメント数を返します。

現在のエンドポイントは、1つ以上の公開ユーザー名を受け付けます。個別の投稿URLやショートコードはリクエストの入力として使用できません。

はい。公開結果にメディアデータが含まれている場合、正規化されたアイテムに画像や動画のURL、サムネイル、サイズ、動画の長さが含まれることがあります。

主なフィールドは、投稿ID、ショートコード、正規URL、投稿者、キャプション、投稿日時、表示中の指標、メディアの参照情報、ハッシュタグ、メンション、収集日時です。

いいえ。このエンドポイントは公開されている結果のみを収集するため、非公開、削除済み、制限付き、ログインが必要な投稿では、データが限られるかレコードが返らない場合があります。

公開結果に含まれている場合は、公開メディアの参照情報を返せます。ただし、投稿の種類やソースのレスポンスによって取得状況が異なるため、クライアント側ではメディアURLの欠落、期限切れ、アクセス制限に対応してください。

リクエストレートを控えめにし、ユーザー名のバッチを小さくし、429 やチャレンジのレスポンスの後はバックオフを入れ、公開ソースが一時的に利用できない場合は時間をおいてリトライしてください。