Instagram 平台

主題標籤搜尋

尋找使用特定主題標籤標註的公開 Instagram 媒體。

限制

  • 您可以代表 Instagram 商業或創作者帳戶在連續 7 天內最多查詢 30 個不重複的主題標籤。查詢主題標籤後，系統便會將此查詢在 7 天內計入此限額。在此時間範圍內對同一主題標籤提出的後續查詢將不計入此限額，並且不會重設其 7 天初始查詢計時器。
  • 您無法在透過 API 發現且帶有主題標籤媒體的物件上留言。
  • 不支援限時動態上的主題標籤。
  • 不支援在主題標籤查詢中使用表情符號。
  • 倘若要求中包含我們認定為敏感性或有冒犯性的主題標籤，API 將傳回一般錯誤。

必要條件

如要使用此 API，您必須通過應用程式審查並要求批准以下事項：

端點

主題標籤搜尋 API 由以下節點和關係連線組成：

有關支援的欄位、參數和用途要求，請參閱每個端點的參考文件。

常見用途

獲取以主題標籤標註的媒體

如需獲取具有特定主題標籤的所有相片和影片，首先使用 /ig_hashtag_search 端點，並包含作出查詢所用的主題標籤和 Instagram 商業或創作者帳戶編號。例如，如果代表編號為 17841405309211844 的 Instagram 商業帳戶作出查詢，則可以透過執行以下查詢來獲取「#coke」主題標籤的編號：

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

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

{
  "id" : "17873440459141021"
}

現在您已經擁有主題標籤編號（17873440459141021），您可以查詢其 /top_media 或 /recent_media 關係連線，並包含商業帳戶編號，以獲取具有「#coke」主題標籤的一系列媒體物件。例如：

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

此操作將傳回以下回應：

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