instagram/
hashtag-posts

1つ以上のハッシュタグに関連する公開Instagram投稿を収集し、投稿者情報、キャプション、メディア、取得元ハッシュタグ、タイムスタンプ、表示中のエンゲージメント指標を返します。

Instagram Hashtag Posts API

ハッシュタグで探索
投稿レコード
期間・メディアのフィルター
結果1件あたり0.5クレジット
準備完了
準備完了

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

README

SocQ 編集 · 更新

Instagram Hashtag Posts

Instagramハッシュタグ投稿は、検索したハッシュタグに関連付けられた公開の写真やリールで、キャプション、クリエイター情報、メディア、タイムスタンプ、表示中のエンゲージメントを含みます。これらのコンテンツと取得元のシグナルは、トピックの探索、ハッシュタグ間の比較、クリエイター調査、期間を区切ったモニタリングに活用できます。

Instagram Hashtag Posts API の主な機能

  • 複数ハッシュタグの収集# の有無を問わず1つ以上のハッシュタグを送信でき、results_limit は送信したハッシュタグごとに個別に適用されます。
  • 期間・メディアのフィルター探索の対象を過去1時間、1日、1週間、1か月、1年に絞り込み、すべての投稿かリールのみかを選択できます。
  • 正規化された投稿レコード投稿ID、ショートコード、正規URL、キャプション、投稿者情報、メディアの参照情報、ハッシュタグ、メンション、タイムスタンプを1つの形式で受け取れます。
  • 取得元の情報とエンゲージメント各レコードを生成した送信ハッシュタグを、取得可能ないいね数、コメント数、視聴回数、再生回数とあわせて保持します。

Instagram Hashtag Posts API のパラメータ

パラメータ必須説明
hashtags必須空でない1つ以上のハッシュタグです。# の有無は問いません。カンマまたは改行で区切って指定します。
results_limit任意ハッシュタグごとにリクエストするレコードの最大件数です。デフォルトは100で、10〜2,000の整数を指定できます。
published_within任意任意。投稿期間を hour、day、week、month、year のいずれかで指定します。
media_type任意コンテンツのフィルターです。all は対応しているすべての投稿タイプを含み、reels は結果をリールのみに絞り込みます。

Instagram Hashtag Posts API の使い方

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

  1. 先頭の # の有無を問わず、重複のない1つ以上のハッシュタグを用意します。
  2. hashtags と、任意の results_limit、published_within、media_type フィールドを /v1/instagram/hashtag-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/hashtag-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hashtags":["travel","photography"],"results_limit":20,"published_within":"week","media_type":"all"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

  • トピック別のコンテンツ探索: キャンペーン、イベント、コミュニティ、業界のハッシュタグに関連する公開投稿を、確認しやすいデータセットとして構築します。
  • ハッシュタグ間の比較: 各レコードを生成した送信ハッシュタグを保持したまま、表示中のエンゲージメントとコンテンツの傾向を比較します。
  • 最新リールのモニタリング: 投稿期間とリールのみのフィルターを組み合わせ、選んだハッシュタグに関するタイムリーなショート動画を確認します。
  • クリエイター・コンテンツの情報補完: 投稿の識別情報、投稿者情報、キャプション、メディア、表示中の指標を、調査、キャンペーン、モデレーションのレコードと結合します。

Instagram Hashtag Posts API 活用のヒント

  • コレクターは送信された値をそれぞれ個別に処理するため、入力ハッシュタグの重複を排除し、トピックごとに表記を1つに統一してください。
  • results_limit はリクエスト全体ではなくハッシュタグごとに適用されるため、取得量はハッシュタグ単位で見積もってください。
  • 定期的なモニタリングで期間とコンテンツタイプをそろえたい場合は、published_within と media_type を組み合わせて使ってください。
  • 重複する結果は固定の投稿ID、ショートコード、正規URLで排除し、取得元の記録として extra.hashtag は保持してください。
  • ソース側の状況は投稿ごとに異なるため、メディア、カウンター、タイムスタンプなどの公開フィールドは任意項目として扱ってください。

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

  • Instagram Search API — キーワードまたはハンドル名で公開プロフィールを検索し、アカウント情報と表示中のアカウントシグナルを返します。
  • Instagram Comments API — 投稿URLから、公開コメント、投稿者、タイムスタンプ、いいね、返信を取得します。
  • Instagram Profiles API — ユーザー名から、公開プロフィールのアカウント情報、プロフィール文、リンク、アカウント属性、カテゴリ、表示中のカウントを取得します。
  • Instagram Post Info API — 既知の公開投稿、リール、旧IGTVのURLを検索し、キャプション、投稿者情報、メディア、タイムスタンプ、表示中のエンゲージメント、入力情報を返します。
  • Instagram Reels Search API — テキストクエリで公開リールを検索し、キャプション、クリエイター、メディア、タイムスタンプ、表示中のエンゲージメント、クエリ情報を返します。
  • Instagram Hashtag Search API — キーワードに一致するハッシュタグを検索し、ハッシュタグ名、ID、タグページのURL、公開投稿数を返します。

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

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

Instagram Hashtag Posts API — よくある質問

Instagram Hashtag Posts APIは、送信した1つ以上のハッシュタグに関連する公開Instagram投稿を取得するためのプログラムインターフェースです。正規化された投稿の識別情報、キャプション、投稿者、メディア、タイムスタンプ、取得元ハッシュタグの情報、表示中のエンゲージメント指標を返します。

空でない hashtags 配列を送信してください。値の先頭の # は付けても省略してもかまいません。results_limit は10〜2,000を指定でき、デフォルトは100で、ハッシュタグごとに個別に適用されます。

published_within は hour、day、week、month、year を受け付けます。media_type は all または reels を受け付け、フィールドを省略した場合は all が使用されます。

正規化された結果には、ID、ショートコード、URL、キャプション、投稿者、メディア、ハッシュタグ、メンション、created_at、collected_at、表示中のいいね数・コメント数・視聴回数・再生回数に加え、一致した入力を示す extra.hashtag が含まれる場合があります。

返された正規化レコード1件につき0.5クレジットで、基本料金はかかりません。見積もりはハッシュタグごとの results_limit に送信したハッシュタグ数を掛けて算出し、最終的な使用量は実際に返されたレコード数に基づきます。