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 處理已連接帳戶本身的貼文、留言、提及及洞察數據,其留言與提及亦可在到達時轉發至您的端點。
一個商業或創作者帳戶在滾動的 7 天內可查詢的不重複主題標籤數目。
recent_media 只返回查詢前 24 小時內發布的媒體。
top_media 每頁的結果數目上限,且只可用 after 游標翻頁。
Meta 比較三種設定時指出,搭配 Instagram Login 的 Instagram API 不支援主題標籤搜尋。
主題標籤 ID 是靜態且全域的,同一標籤對每個應用程式及用戶都保持相同的 ID。
主題標籤搜尋如何運作?
分兩步進行,代表 Instagram 商業或創作者帳戶執行,該帳戶的 ID 放在 user_id 中。GET /ig_hashtag_search 的 q 設為主題標籤名稱,即會返回其 ID;Meta 指該 ID 為靜態且全域,因此可以儲存。接著以 user_id 與 fields 呼叫 GET /<HASHTAG_ID>/top_media 或 /recent_media,即會列出貼文。
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_counttop_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 標明該設定不支援主題標籤搜尋。
每個連接每月 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 監察
驗證日期