登入開始免費試用
easyCoexistence 官方 API

Instagram 主題標籤搜尋 API:按主題標籤找貼文

Instagram 主題標籤搜尋分兩步,找出帶有某主題標籤的公開相片及影片。先呼叫 GET /ig_hashtag_search,附上 user_id 與 q,取得該標籤的 ID;再呼叫 GET /<HASHTAG_ID>/top_media 列出最受歡迎的貼文,或呼叫 /recent_media 列出過去 24 小時內發布的貼文。帳戶在滾動的 7 天內最多可查詢 30 個不重複主題標籤,並須使用 Facebook Login 或 Unified Login。

easyCoexistence 以 Instagram Login 連接 Instagram,讓 Claude、ChatGPT 或您自行開發的程式碼,能透過 Meta 官方 API 處理已連接帳戶本身的貼文、留言、提及及洞察數據,其留言與提及亦可在到達時轉發至您的端點。

30

一個商業或創作者帳戶在滾動的 7 天內可查詢的不重複主題標籤數目。

24 hours

recent_media 只返回查詢前 24 小時內發布的媒體。

50

top_media 每頁的結果數目上限,且只可用 after 游標翻頁。

Not supported

Meta 比較三種設定時指出,搭配 Instagram Login 的 Instagram API 不支援主題標籤搜尋。

Static

主題標籤 ID 是靜態且全域的,同一標籤對每個應用程式及用戶都保持相同的 ID。

主題標籤搜尋如何運作?

分兩步進行,代表 Instagram 商業或創作者帳戶執行,該帳戶的 ID 放在 user_id 中。GET /ig_hashtag_search 的 q 設為主題標籤名稱,即會返回其 ID;Meta 指該 ID 為靜態且全域,因此可以儲存。接著以 user_id 與 fields 呼叫 GET /<HASHTAG_ID>/top_media 或 /recent_media,即會列出貼文。

Finding a hashtag's ID, then its recent posts
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_count

top_media 與 recent_media 有何分別?

top_media 返回帶有該主題標籤、最受歡迎的相片及影片,Meta 以瀏覽次數與觀眾互動的綜合數據判斷受歡迎程度。recent_media 返回最新發布的媒體,限於查詢前 24 小時內發布的媒體,Meta 並指出其回應未必按時間順序排列。兩者都只返回公開媒體,不包括推廣貼文、加強推廣貼文及廣告媒體,並以 after 游標每次翻 50 項。

會返回哪些欄位?

Meta 參考資料列出兩個端點均適用的媒體欄位,兩者均只返回公開相片及影片:

  • id、media_type(CAROUSEL_ALBUM、IMAGE 或 VIDEO)、permalink 及 timestamp。
  • caption 及 comments_count,以及 like_count,除非擁有者已隱藏讚好數。
  • 相簿媒體返回 children,其他媒體返回 media_url,但含版權或授權音訊的影片不返回 media_url。
  • 不包括 username:Meta 不允許在主題標籤搜尋結果的媒體上使用此欄位。

有哪些限制?

Meta 按帳戶及主題標籤設定上限:

  • 滾動的 7 天內最多 30 個不重複主題標籤。標籤由首次查詢起計,期內再次查詢不計入配額,亦不會重新計算其 7 天。
  • 即使標籤的 ID 已儲存,呼叫 top_media 或 recent_media 仍計為查詢該主題標籤。
  • GET /<IG_ID>/recently_searched_hashtags 列出該帳戶在本星期內搜尋過的不重複主題標籤。
  • 不支援限時動態中的主題標籤及查詢中的表情符號;Meta 認為敏感或冒犯性的主題標籤會返回一般錯誤。
  • 以此方式找到的媒體不能透過 API 留言。

主題標籤搜尋需要什麼?

須通過 App Review 審核,取得 Instagram Public Content Access 功能及 instagram_basic 權限,應用程式才可使用主題標籤搜尋;另須有來自 Facebook Login 的用戶存取權杖,適用於可代表連結專頁執行任務的人士,或使用 Unified Login 權杖。Meta 的總覽列明主題標籤搜尋不支援 Instagram Login,其呼叫受 Meta 平台速率限制約束,而非 Instagram 的每帳戶呼叫配額。Meta 列明的允許用途包括:尋找您主題標籤推廣活動的內容、了解公眾對品牌的觀感,以及識別比賽參加者。

可以透過 easyCoexistence 搜尋主題標籤嗎?

easyCoexistence 以 Instagram Login 連接 Instagram,可存取已連接帳戶本身的貼文、留言、提及及洞察數據。Meta 只為 Facebook Login 及 Unified Login 提供主題標籤搜尋,因此不在此連接的範圍內。連接改為涵蓋:透過 list_social_posts 取得帳戶本身的貼文,以及其留言與提及,並會在到達時轉發至您的端點。

常見錯誤

  • 把每週配額花在測試上。每個新主題標籤都計入 7 天內的 30 個,即使已儲存 ID,取得其媒體仍會計入配額。
  • 在主題標籤結果中要求 username。Meta 不會在透過主題標籤搜尋找到的媒體上返回此欄位。
  • 把 recent_media 當作存檔。它只涵蓋查詢前 24 小時內發布的媒體,而且並非嚴格按時間順序排列。
  • 使用 Instagram Login 權杖呼叫。Meta 標明該設定不支援主題標籤搜尋。
使用 EasyCoexistence 完成這項設定

每個連接每月 US$ 9 起,最低降至 US$ 0.75,連接越多越便宜,首 3 天免費試用。

常見問題

Instagram API 無需 App Review 也能搜尋主題標籤嗎?

不能。應用程式呼叫主題標籤搜尋前,Meta 要求先通過 Instagram Public Content Access 功能及 instagram_basic 的 App Review 審核。

能否看到用主題標籤發佈貼文的人?

不能看到用戶名稱,因 Meta 不會在主題標籤結果中提供。每則貼文的 permalink 可在 Instagram 上打開該貼文。

主題標籤搜尋會包括限時動態嗎?

不會。Meta 不支援限時動態中的主題標籤,兩個端點均只返回公開相片及影片。

重複查詢同一主題標籤會計算兩次嗎?

不會。7 天期內的重複查詢不計入 30 個的配額,也不會重新計算該主題標籤的計時。

繼續閱讀

兩分鐘內連接您的第一個頻道。

無需等待平台審核。連接 WhatsApp、Instagram、TikTok 或其他頻道,然後請您的 AI 發佈貼文、回覆訊息或匯報數據,並看着它運作。

  • 免費試用 3 天
  • 隨時取消
  • 只用官方 API
  • 24/7 監察

驗證日期