主題標籤搜尋

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

限制

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

需求

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

端點

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

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

常見用途

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

若要取得有特定主題標籤的所有相片和影片,請先使用 /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"     
    }
  ]
}