Instagram ハッシュタグ検索 API: ハッシュタグで投稿を探す
Instagram のハッシュタグ検索は、ハッシュタグが付いた公開の写真と動画を2回の呼び出しで取得します。user_id と q を指定して GET /ig_hashtag_search を呼ぶとハッシュタグの ID が返り、GET /<HASHTAG_ID>/top_media で人気の投稿、/recent_media で直近24時間に公開された投稿を一覧できます。アカウントは、ローリング7日間で30個の異なるハッシュタグを検索できます。必要なのは Facebook Login または Unified Login です。
easyCoexistence は Instagram Login で Instagram と接続します。
ビジネスアカウントまたはクリエイターアカウントが、ローリング7日間で検索できる異なるハッシュタグの数。
recent_media が返すのは、検索時点から24時間以内に公開されたメディアのみです。
top_media は1ページあたりの結果数が最も多く、after カーソルでのみページングできます。
Meta の3つの構成を比較した説明では、Instagram API のハッシュタグ検索は Instagram Login で行うとされています。
ハッシュタグ ID は静的かつグローバルで、アプリやユーザーが違っても同じ ID になります。
ハッシュタグ検索はどのように動きますか?
2つのステップで行います。Instagram のビジネスアカウントまたはクリエイターアカウントの代理として、その ID を user_id に指定します。q にハッシュタグ名を指定して GET /ig_hashtag_search を呼ぶと ID が返ります。Meta によればこの ID は静的かつグローバルなので保存できます。続けて user_id と fields を指定して GET /<HASHTAG_ID>/top_media または /recent_media を呼ぶと、投稿が一覧で返ります。
GET /ig_hashtag_search?user_id=<IG_ID>&q=coffee
{ "data": [ { "id": "<HASHTAG_ID>" } ] }
GET /<HASHTAG_ID>/recent_media
?user_id=<IG_ID>
&fields=id,media_type,permalink,timestamp,like_count,comments_counttop_media と recent_media の違いは何ですか?
top_media は、そのハッシュタグが付いた人気の写真と動画を返します。人気度は再生数と視聴者の反応を組み合わせて Meta が判断します。recent_media は、直近に公開されたものを返します。対象は検索時点から24時間以内に公開されたメディアに限られ、Meta は応答が時系列順になるとは限らないと注記しています。どちらも公開メディアのみを返し、プロモーション、ブースト、広告のメディアは含みません。結果は after カーソルを使い、1ページ50件ずつページングします。
どのフィールドが返りますか?
両方のエッジについて、Meta のリファレンスに載っているメディアフィールドが返ります。対象は公開の写真と動画のみです。
- id、
media_type(CAROUSEL_ALBUM、IMAGE、VIDEO)、permalink、timestamp。 - caption と
comments_count。所有者が いいね数 を非表示にしていなければlike_countも返ります。 - アルバムのメディアは children、その他のメディアは
media_url。ただし著作権で保護された音源やライセンス音源を含む動画はmedia_urlが返りません。 - username は返りません。Meta はハッシュタグ検索で得たメディアでの username の取得を認めていません。
上限はどのくらいですか?
Meta はアカウントごと、ハッシュタグごとに上限を設けています。
- ローリング7日間で異なるハッシュタグ30個まで。ハッシュタグは最初に検索した時点から数えられ、その期間内に再度検索しても無料で、7日間のタイマーはリセットされません。
- 保存済みの ID があっても、
top_mediaまたはrecent_mediaを取得するとハッシュタグの検索として数えられます。 - GET /<
IG_ID>/recently_searched_hashtagsで、アカウントが今週検索した異なるハッシュタグの一覧を取得できます。 - ストーリーズ上のハッシュタグや、検索クエリ内の絵文字はサポートされていません。Meta が機密性または不適切と判断したハッシュタグは、汎用的なエラーを返します。
- この方法で見つけたメディアには、API からコメントできません。
ハッシュタグ検索には何が必要ですか?
Instagram Public Content Access 機能と instagram_basic 権限について App Review の承認が必要です。これはアプリがこの機能を使う前に Meta が求める条件です。また、リンクされた Page のタスクを実行できる人の Facebook Login によるユーザーアクセストークン、または Unified Login のトークンが必要です。Meta の概要では、ハッシュタグ検索は Instagram Login ではサポートされていないとされています。呼び出しは Instagram のアカウントごとの呼び出し枠ではなく、Meta Platform のレート制限の対象になります。Meta が挙げる許可された用途は、ハッシュタグキャンペーンのコンテンツの把握、ブランドに対する公開の評判の把握、コンテストの応募者の特定などです。
easyCoexistence でハッシュタグを検索できますか?
easyCoexistence は Instagram Login で Instagram と接続します。この接続で扱えるのは、接続したアカウント自身の投稿、コメント、メンション、インサイトです。Meta がハッシュタグ検索を提供しているのは Facebook Login と Unified Login のみのため、この接続の対象外です。代わりに接続で扱えるのは、list_social_posts によるアカウント自身の投稿と、届いたコメントおよびメンションのエンドポイントへの転送です。
よくある間違い
- テストに週間の枠を使ってしまう。新しいハッシュタグはすべて7日間で30個の枠に数えられ、ID を保存済みでもメディアを取得すると枠を消費します。
- ハッシュタグの結果で username を要求する。Meta はハッシュタグ検索で得たメディアについて username を返しません。
- recent_media をアーカイブとして扱う。対象は検索前の24時間に公開されたメディアで、厳密な時系列順とは限りません。
- Instagram Login のトークンで呼び出す。Meta はその構成ではハッシュタグ検索をサポートしていないとしています。
Claude、ChatGPT、または自社のコードから、Meta の公式 API を通じてアカウント自身の投稿、コメント、メンション、インサイトを扱えます。コメントとメンションは届いた時点でエンドポイントに転送できます。料金は接続ごとに月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の3日間は無料です。
よくある質問
App Review なしで Instagram API のハッシュタグ検索はできますか?
いいえ。アプリがハッシュタグ検索を呼び出す前に、Meta は Instagram Public Content Access 機能と instagram_basic について App Review の承認を求めています。
ハッシュタグで投稿したユーザーを確認できますか?
ユーザー名では確認できません。Meta はハッシュタグの結果から username を除外しています。各投稿の permalink で Instagram 上の投稿を開けます。
ハッシュタグ検索にストーリーズは含まれますか?
含まれません。Meta はストーリーズのハッシュタグをサポートしておらず、両方のエッジが返すのは公開の写真と動画のみです。
同じハッシュタグを再度検索すると、2回分として数えられますか?
数えられません。7日間の期間内の再検索は30個の枠に含まれず、ハッシュタグのタイマーもリセットされません。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日