instagram/
tagged-posts

1つ以上のユーザー名を指定し、そのプロフィールがタグ付けされた公開Instagram投稿を収集して、キャプション、投稿者、メディア、メンション、表示中のエンゲージメントを返します。

Instagram Tagged Posts API

プロフィールのタグ付け
投稿のコンテキスト
公開コンテンツ
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Tagged Posts

Instagramのタグ付けされた投稿は、投稿単位のタグで他のプロフィールを示す公開コンテンツで、メンションされたユーザー名を含む場合もあり、キャプション、投稿者、メディア、ハッシュタグ、タイムスタンプ、表示中のエンゲージメントを備えています。これらのコンテンツと関係性のシグナルは、タグ付けのモニタリング、帰属の確認、クリエイター調査、構造化されたコンテンツアーカイブに活用できます。

Instagram Tagged Posts API の主な機能

  • プロフィールのタグ付けを検出公開Instagramユーザー名を対象として指定し、対象アカウント自身の投稿ではなく、そのプロフィールをタグ付けした投稿を返します。
  • 投稿と投稿者の識別情報投稿ID、ショートコード、投稿URL、キャプション、正規化された投稿者プロフィールのフィールドを受け取り、追跡可能なコンテンツレコードとして利用できます。
  • タグ付けユーザーとメンションの情報構造化された tagged_users の情報をハッシュタグや返されたメンションとあわせて保持し、投稿との関係の種類を区別できるようにします。
  • メディアと表示中のエンゲージメント正規化された画像・動画の参照情報と、各公開投稿で提供される表示中のいいね数・コメント数・視聴回数・再生回数を返します。
  • 投稿のコンテキスト正規化された投稿日時、収集日時、product_type の情報を含め、時系列での確認や投稿フォーマットの分類に利用できます。

Instagram Tagged Posts API のパラメータ

パラメータ必須説明
usernames必須@ を付けない1つ以上の公開Instagramプロフィールのユーザー名です。カンマまたは改行で区切って指定します。
results_limit任意タスクがリクエストするタグ付け投稿レコードの最大件数です。1〜2,000の整数で指定し、デフォルトは100です。

Instagram Tagged Posts API の使い方

対象プロフィールのユーザー名を非同期タスクとして送信し、返されたタスクIDをポーリングして、正規化されたタグ付け投稿をカーソルページネーションで読み取ります。

  1. 先頭に @ を付けない1つ以上の公開Instagramユーザー名を用意します。
  2. usernames と、1〜2,000の範囲で任意の results_limit を /v1/instagram/tagged-posts に POST します。
  3. status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
  4. /v1/tasks/{task_id}?limit=50 を読み取り、results.has_more が true の間は results.next_cursor を渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/instagram/tagged-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"usernames":["instagram"],"results_limit":20}'

# Poll GET /v1/tasks/{task_id}
# Read GET /v1/tasks/{task_id}?limit=50 and follow data.results.next_cursor

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

  • プロフィールのタグ付けモニタリング: tagged_users、投稿URL、キャプション、投稿者、タイムスタンプを使い、選んだプロフィールをタグ付けした公開投稿を確認します。
  • キャンペーンとの関連性の確認: キャンペーン用プロフィールのタグ付けに関連する投稿について、キャプション、メディア、タグ付けユーザーの情報、表示中のエンゲージメントを比較します。
  • クリエイターの貢献度調査: 正規化された投稿者情報とプロフィールのタグ付け関係を使い、選んだアカウントに関するコンテンツを投稿している公開クリエイターを特定します。
  • タグ付けコンテンツのアーカイブ: 投稿ID、ショートコード、返されたURL、メディアの参照情報、投稿日時、収集日時を、確認可能なコンテンツレコードとして保存します。

Instagram Tagged Posts API 活用のヒント

  • リクエストで正しいプロフィール識別子を使えるよう、送信前に各対象ユーザー名から先頭の @ を取り除いてください。
  • 2つのフィールドを同じものとして扱わず、投稿単位のプロフィールタグは extra.tagged_users から、返されたメンション文字列は mentions から読み取ってください。
  • 繰り返し収集したデータは投稿IDまたはショートコードで重複を排除し、確認と追跡のために返された投稿URLを保持してください。
  • 正規化された公開レコードはソース側で null になり得るフィールドをそのまま保持するため、メディア、エンゲージメントのカウンター、投稿者のフラグ、タイムスタンプが欠けるケースを許容してください。
  • タグ付け投稿の結果が多い場合に最初のページで途切れないよう、results.has_more が true の間は results.next_cursor で取得を続けてください。

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

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

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

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

Instagram Tagged Posts API — よくある質問

Instagram Tagged Posts APIは、送信した1つ以上のユーザー名で特定されるプロフィールをタグ付けした公開投稿を取得するためのプログラムインターフェースです。正規化された投稿と投稿者の識別情報、キャプション、メディア、タグ付けユーザーの情報、メンション、タイムスタンプ、表示中のエンゲージメントを返します。

いいえ。このエンドポイントは対象プロフィールをタグ付けした投稿を探すものです。mentions は、公開結果に含まれている場合に該当する投稿とあわせて返されるフィールドであり、メンションされた投稿を別途検索するものではありません。

公開プロフィールのユーザー名を使い、空でない usernames 配列を送信してください。入力のマッピング時に先頭の @ は除去されます。results_limit は任意で、1〜2,000の整数を指定でき、デフォルトは100です。

extra.tagged_users は、投稿について返された構造化されたプロフィールタグの情報を保持します。mentions は、正規化されたコンテンツレコード内でメンションとして返されたユーザー名の別個のリストです。

Tagged Postsは、選んだプロフィールをタグ付けした公開投稿を探します。一方、Instagram Postsは、送信したユーザー名自身が投稿したコンテンツを収集します。

レコードには、ID、ショートコード、URL、キャプション、投稿者情報、メディア、ハッシュタグ、メンション、タグ付けユーザー、product type、投稿日時と収集日時、表示中のいいね数・コメント数・視聴回数・再生回数が含まれる場合があります。

返されるのは公開されている該当投稿のみです。削除済み、制限付き、非公開、ログインが必要な投稿や、ソース側で省略されたレコード・フィールドがあると、結果が部分的または空になることがあります。

1ページあたり最大500件のタスク結果を読み取り、has_more が true の間は next_cursor で続きを取得してください。

成功した正規化結果は1レコードにつき0.5クレジットで、基本料金はかかりません。結果が空の場合は基本料金のみのポリシーにより0クレジットです。