ハッシュタグ検索

特定のハッシュタグでタグ付けされた公開IGメディアを検索します。

制限

• InstagramビジネスアカウントまたはInstagramクリエイターアカウントに代わってクエリできる一意のハッシュタグは、7日のローリング期間で最大30件です。一度ハッシュタグをクエリすると、7日間にわたってこの制限がカウントされます。この時間枠内で同じハッシュタグをクエリした場合、制限に対するカウントは行われず、最初のクエリで起動した7日間のタイマーはリセットされません。
• APIによって検出されたハッシュタグ付きメディアオブジェクトにコメントすることはできません。
• ストーリーズのハッシュタグはサポートされていません。
• ハッシュタグ内の絵文字のクエリはサポートされていません。
• APIは、Facebookが機密情報または不快な内容であると判断したハッシュタグを含むリクエストに対して一般的なエラーを返します。

要件

このAPIを使用するには、アプリレビューを受けて次の機能とアクセス許可の承認をリクエストする必要があります:

• Instagram Public Content Access機能
• instagram_basicアクセス許可

エンドポイント

ハッシュタグ検索APIは次のノードとエッジで構成されています:

• GET /ig_hashtag_search — 特定のハッシュタグのノードIDを取得します
• GET /{ig-hashtag-id} — ハッシュタグに関するデータを取得します
• GET /{ig-hashtag-id}/top_media — 特定のハッシュタグが付いている人気上位の写真と動画を取得します
• GET /{ig-hashtag-id}/recent_media — 特定のハッシュタグが付いている最近公開された写真と動画を取得します
• GET /{ig-user-id}/recently_searched_hashtags — InstagramビジネスアカウントまたはInstagramクリエイターアカウントで今週検索された一意のハッシュタグを特定します

サポートされるフィールド、パラメーター、および使用方法の要件については、各エンドポイントのリファレンスドキュメントを参照してください。

一般的な用途

ハッシュタグがタグ付けされたメディアを取得する

特定のハッシュタグが付いている写真と動画をすべて取得するには、まず、/ig_hashtag_searchエンドポイントを使用し、ハッシュタグと、クエリを実行するInstagramビジネスアカウントまたはInstagramクリエイターアカウントのIDを指定してクエリを実行します。例えば、IDが17841405309211844であるInstagramビジネスアカウントでクエリを実行する場合、次のクエリで「#coke」ハッシュタグのIDを取得できます。

GET graph.facebook.com/ig_hashtag_search
  ?user_id=17841405309211844
  &q=coke

これにより、「#Coke」ハッシュタグノードのIDが返されます。

{
  "id" : "17873440459141021"
}

ハッシュタグID (17873440459141021)を取得できたので、その/top_mediaまたは/recent_mediaエッジに対するクエリでビジネスアカウントIDを指定し、「#coke」ハッシュタグが付いているメディアオブジェクトのコレクションを取得します。例:

GET graph.facebook.com/17873440459141021/recent_media
  ?user_id=17841405309211844

これにより、次のような応答が返されます。

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    },
    {       
      "id": "17896450804038745"     
    }
  ]
}