instagram/
post-info

既知のURLから公開Instagram投稿、リール、旧IGTVのアイテムを取得し、キャプション、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメントを返します。

Instagram Post Info API

URLを直接指定
投稿のメタデータ
公開コンテンツ
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Post Info

Instagram投稿の詳細レコードは、個々の公開投稿、リール、旧IGTVのアイテムを、キャプション、投稿者情報、メディアの参照情報、投稿日時、表示中のエンゲージメント、ソースの product type によって表します。これらのフィールドは、既知のURLの情報補完、コンテンツのカタログ化、エンゲージメントのスナップショット、フォーマットの比較に活用できます。

Instagram Post Info API の主な機能

  • コンテンツURLの直接照会プロフィールの収集や探索を行わずに、既知の公開Instagramの /p/、/reel/、/tv/ のURLを照会します。
  • キャプションと投稿者の情報公開キャプションのテキストを、取得可能な投稿者ID、ユーザー名、表示名、アバターの参照情報とあわせて返します。
  • メディアとエンゲージメントの詳細公開されている画像・動画の参照情報を、表示中のいいね数・コメント数・視聴回数・再生回数とあわせて正規化します。
  • 追跡可能な正規化レコード標準化された各投稿レコードに、送信したURLと取得可能なソースの product type を保持します。

Instagram Post Info API のパラメータ

パラメータ必須説明
urls必須必須。InstagramコンテンツのURLです。カンマまたは改行で区切って指定します。対応するホストは instagram.com と www.instagram.com で、パスは /p/、/reel/、/tv/ のいずれかで始まる必要があります。

Instagram Post Info API の使い方

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

  1. パスが /p/、/reel/、/tv/ のいずれかで始まり、コンテンツのショートコードを含む公開 instagram.com のURLを1つ以上用意します。
  2. urls を /v1/instagram/post-info に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 から data.results.items を読み取り、results.has_more が true の間は results.next_cursor をたどって続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/post-info" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"urls\":[\"$INSTAGRAM_POST_URL\"]}"

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

Instagram Post Info API の主なユースケース

  • 既知の投稿の情報補完: 保存済みのInstagramコンテンツURLのリストに、キャプション、投稿者、メディア、投稿日時、表示中のエンゲージメントのフィールドを追加します。
  • コンテンツカタログの正規化: 投稿、リール、旧IGTVが混在するリンクを、固定の識別情報と取得元の情報を備えた一貫したレコードに変換します。
  • 公開エンゲージメントのスナップショット: 選んだコンテンツについて、収集時点で返された表示中のいいね数・コメント数・視聴回数・再生回数を記録します。
  • コンテンツフォーマットの比較: media フィールドとソースの product type を使い、既知のフィード投稿、リール、旧IGTVのアイテムで取得できるメタデータを比較します。

Instagram Post Info API 活用のヒント

  • 接頭部分だけのパスは形式チェックを通過してもレコードが返らないことがあるため、/p/、/reel/、/tv/ の後に実際のショートコードを含めてください。
  • 複数URLのタスクを入力と照合する場合は extra.input_url を保持してください。重複したURLはまとめられ、一意のURLごとに最大1件のレコードが生成されます。
  • 送信したURLよりレコードが少なくなるケースに対応し、コンテンツが利用できない場合や公開されていない場合に備えて、投稿者、指標、メディア、日時、product type のフィールドは任意項目として扱ってください。

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

  • Instagram Posts API — ユーザー名から、公開投稿、メディア、ハッシュタグ、メンション、タイムスタンプ、エンゲージメントを取得します。
  • Instagram Reels API — ユーザー名から、公開リール、メディア、オーディオ、ハッシュタグ、メンション、エンゲージメントを取得します。
  • Instagram Comments API — 投稿URLから、公開コメント、投稿者、タイムスタンプ、いいね、返信を取得します。
  • Instagram Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、リンク、アカウント属性、カテゴリ、表示中のカウントを取得します。
  • Instagram Transcript API — 公開投稿またはリールのURLから、文字起こしテキスト、言語、形式、元のURL、ショートコードを抽出します。
  • Instagram Post Likers API — 投稿URLの、表示されているいいねしたユーザーの一覧からアカウントを取得し、ユーザー名、名前、アイコン、認証バッジの有無を返します。

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

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

Instagram Post Info API — よくある質問

Instagram Post Info APIは、既知のInstagram URLから個々の公開投稿、リール、旧IGTVのアイテムを取得するためのプログラムインターフェースです。正規化されたキャプション、投稿者、メディア、投稿日時、表示中のエンゲージメント、入力に関する情報のフィールドを返します。

パスが /p/、/reel/、/tv/ のいずれかで始まる instagram.com または www.instagram.com のURLを送信してください。接頭部分の後には実際のコンテンツのショートコードを含めてください。接頭部分だけのパスは検証を通過しても、レコードが返らないことがあります。

レコードには、ID、ソースURL、キャプション、投稿者情報、表示中のいいね数・コメント数・視聴回数・再生回数、メディアの参照情報、投稿日時と収集日時、送信した入力URL、ソースの product type が含まれる場合があります。

重複した入力はまとめられ、非公開、削除済み、制限付き、形式が不正、またはその他の理由で利用できないコンテンツではレコードが生成されないことがあります。一意のURLごとに返されるアイテムは最大1件です。

保存された結果1件につき0.5クレジットで、タスクの基本料金はかかりません。保存されたレコードがないタスクでは、結果に対する課金は発生しません。