主題標籤搜尋

尋找標註了特定主題標籤的公開 IG 影音內容。

限制

• 7 天之內，您最多可以代表 Instagram Business 或創作者帳號查詢 30 個不重複的主題標籤。一旦查詢主題標籤後，就會開始按照這項限制計算，為期 7 天。在這個時間範圍內，後續查詢相同主題標籤不會列入限制次數計算，也不會重設查詢一開始的 7 天計時器。
• 您無法針對透過 API 找到的主題標籤影音內容物件留言。
• 不支援限時動態上的主題標籤。
• 不支援主題標籤查詢中的表情符號。
• 如有任何要求包含我們判斷屬於敏感或有冒犯性質的主題標籤，API 會傳回一般錯誤。

需求

要使用這項 API 必須通過應用程式審查，並且要提出下列要求並獲准：

• Instagram Public Content Access 功能
• instagram_basic 權限

端點

主題標籤搜尋 API 包含以下節點和關係連線：

• GET /ig_hashtag_search — 用於取得特定主題標籤的節點編號
• GET /{ig-hashtag-id} — 用於取得關於主題標籤的資料
• GET /{ig-hashtag-id}/top_media — 用於取得有特定主題標籤的最熱門相片和影片
• GET /{ig-hashtag-id}/recent_media — 用於取得最近發佈且有特定主題標籤的相片和影片
• GET /{ig-user-id}/recently_searched_hashtags — 用於確認 Instagram Business 或創作者帳號在當週曾經搜尋過的不重複主題標籤

請參閱每個端點的參考文件，瞭解支援的欄位、參數和使用規定。

常見用途

取得有主題標籤的影音內容

若要取得有特定主題標籤的所有相片和影片，請先使用 /ig_hashtag_search 端點並包含建立查詢之 Instagram Business 或創作者帳號的主題標籤和編號。例如，如果是代表編號 17841405309211844 的 Instagram Business 帳號建立查詢，可執行下列查詢取得「#coke」主題標籤的編號：

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

如此將傳回「#Coke」主題標籤節點的編號：

{
  "id" : "17873440459141021"
}

查到了主題標籤編號（17873440459141021）之後，就可以查詢其 /top_media 或 /recent_media 關係連線並包含 Business 帳號編號，用於取得有「#coke」主題標籤的影音內容物件集合。例如：

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

這樣會傳回如下所示的回應：

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