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つ以上のハッシュタグを用意します。
- hashtags と、任意の results_limit、published_within、media_type フィールドを /v1/instagram/hashtag-posts に POST します。
- status が succeeded または failed になるまで /v1/tasks/{task_id} をポーリングします。
- /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 trueInstagram Hashtag Posts API の主なユースケース
- トピック別のコンテンツ探索: キャンペーン、イベント、コミュニティ、業界のハッシュタグに関連する公開投稿を、確認しやすいデータセットとして構築します。
- ハッシュタグ間の比較: 各レコードを生成した送信ハッシュタグを保持したまま、表示中のエンゲージメントとコンテンツの傾向を比較します。
- 最新リールのモニタリング: 投稿期間とリールのみのフィルターを組み合わせ、選んだハッシュタグに関するタイムリーなショート動画を確認します。
- クリエイター・コンテンツの情報補完: 投稿の識別情報、投稿者情報、キャプション、メディア、表示中の指標を、調査、キャンペーン、モデレーションのレコードと結合します。
Instagram Hashtag Posts API 活用のヒント
- コレクターは送信された値をそれぞれ個別に処理するため、入力ハッシュタグの重複を排除し、トピックごとに表記を1つに統一してください。
- results_limit はリクエスト全体ではなくハッシュタグごとに適用されるため、取得量はハッシュタグ単位で見積もってください。
- 定期的なモニタリングで期間とコンテンツタイプをそろえたい場合は、published_within と media_type を組み合わせて使ってください。
- 重複する結果は固定の投稿ID、ショートコード、正規URLで排除し、取得元の記録として extra.hashtag は保持してください。
- ソース側の状況は投稿ごとに異なるため、メディア、カウンター、タイムスタンプなどの公開フィールドは任意項目として扱ってください。
関連API
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 Followers Count API
- Instagram Posts API
- Instagram Reels API
- Instagram Followers List API
- Instagram Following List API
- Instagram Tagged Posts API
- Instagram Transcript API
- Instagram Audio Reels API
- Instagram Highlight Items API
- Instagram Story Highlights API
- Instagram Trending Reels API
- Instagram Stories API
- Instagram Similar Accounts API
- Instagram Comment Replies API
- Instagram Post Likers API
- Instagram Location Info API
- Instagram Location Posts API
- Instagram Location Search API
- Instagram Account Age Checker API