这是indexloc提供的服务,不要输入任何密码

關鍵字和主題標籤搜尋

透過特定關鍵字搜尋公開 Threads 影音內容,或按主題標籤搜尋。

限制

  • 用戶可在連續 24 小時內傳送最多 2,200 個查詢。查詢一經傳送,便會計入此 24 小時限額。
  • 此項限制適用於所有應用程式用戶,且不會因應用程式不同而有所差異。如果多個應用程式向同一用戶傳送要求,這些查詢將會計入此用戶的同一限額中。
  • 在此時段內就相同關鍵字傳送的後續查詢也會計入此限額。
  • 無傳回結果的查詢不會計入用戶的這個限額。如果系統沒有傳回結果,請考慮優化或縮短您的查詢。
  • 倘若要求中包含我們認定為敏感性或有冒犯性的關鍵字,API 將傳回空白陣列。

權限

Threads 關鍵字搜尋 API 需要適當的存取憑證和權限。測試時,您可以透過使用 Graph API 測試工具輕鬆產生憑證,並向您的應用程式授予權限。

  • threads_basic:如要向所有 Threads API 端點發出任何呼叫,此為必要項目。
  • threads_keyword_search:如要向關鍵字搜尋端點發出 GET 呼叫,此為必要項目。

如果您的應用程式尚未獲得 threads_keyword_search 權限,系統只會在已通過驗證用戶所擁有的帖子上執行搜尋。獲得批准後,公開帖子便可供搜尋。

關鍵字搜尋

如要按關鍵字搜尋公開 Threads 影音內容,請向 /keyword_search 端點發出 GET 要求,並在要求中加入要查詢的關鍵字。

參數

名稱說明

q

字串

此為必要項目。
要查詢的關鍵字。

search_type

字串

此為選用項目。
指定搜尋行為。

值:

  • TOP預設值):獲取最熱門的搜尋結果。
  • RECENT:獲取最近的搜尋結果。

search_mode

字串

此為選用項目。
指定搜尋模式。

值:

  • KEYWORD預設):查詢將被視作關鍵字。
  • TAG:查詢將被視作主題標籤。

since

此為選用項目。
表示擷取開始日期的查詢字串參數(必須為 Unix 時戳或可由 strtotime(); 剖析的日期/時間表示,時戳必須大於或等於 1688540400 且小於 until 參數)。

until

此為選用項目。
表示擷取結束日期的查詢字串參數(必須為 Unix 時戳或可由 strtotime(); 剖析的日期/時間表示,時戳必須小於或等於當前時戳且大於 until 參數)。

limit

此為選用項目。
表示要求傳回的影音內容物件或記錄數量上限之查詢字串參數,預設值為 25,最大值為 100(僅允許非負數)。

如要取得可用欄位的清單,請參閱影音內容文件。請注意:系統會排除且不會傳回擁有者欄位。

範例要求

curl -s -X GET \
  -F "q=<KEYWORD>" \
  -F "search_type=TOP" \
  -F "fields=id,text,media_type,permalink,timestamp,username,has_replies,is_quote_post,is_reply" \
  -F "access_token=<THREADS_ACCESS_TOKEN>" \
"https://graph.threads.net/v1.0/keyword_search"

範例回應

{
  "data": [
    {
      "id": "1234567890",
      "text": "First Thread",
      "media_type": "TEXT",
      "permalink": "https://www.threads.net/@threadsapitestuser/post/abcdefg",
      "timestamp": "2023-10-17T05:42:03+0000",
      "username": "threadsapitestuser",
      "has_replies": false,
      "is_quote_post": false,
      "is_reply": false
    }
  ]
}

主題標籤搜尋

如要按主題標籤搜尋公開 Threads 影音內容,請向 /keyword_search 端點發出 GET 要求,並在要求中加入要查詢的關鍵字。如要搜尋主題標籤,您需要使用 search_mode 參數並將其值設為 TAG

範例要求

curl -s -X GET \
  -F "q=<TAG>" \
  -F "search_mode=TAG" \
  -F "search_type=TOP" \
  -F "fields=id,text,media_type,permalink,timestamp,username,has_replies,is_quote_post,is_reply" \
  -F "access_token=<THREADS_ACCESS_TOKEN>" \
"https://graph.threads.net/v1.0/keyword_search"

範例回應

{
  "data": [
    {
      "id": "1234567890",
      "text": "First Thread",
      "media_type": "TEXT",
      "permalink": "https://www.threads.net/@threadsapitestuser/post/abcdefg",
      "timestamp": "2023-10-17T05:42:03+0000",
      "username": "threadsapitestuser",
      "has_replies": false,
      "is_quote_post": false,
      "is_reply": false
    }
  ]
}

與公開 Threads 互動

您可以與最近搜尋的公開 Threads 影音內容互動,操作包括回覆引用轉發

請注意:有關頁面或會列出其他所需權限。

最近搜尋的關鍵字

您可以向 /me 端點發出 GET 要求,並要求取得 recently_searched_keywords 欄位,以擷取目前已通過驗證用戶最近搜尋的關鍵字之清單。

範例要求

curl -s -X GET \
  -F "fields=recently_searched_keywords" \
  -F "access_token=<THREADS_ACCESS_TOKEN>" \
"https://graph.threads.net/v1.0/me"

範例回應

{
  "id": "1234567890",
  "recently_searched_keywords": [
    {
      "query": "some keyword",
      "timestamp": 1735707600000,
    },
    {
      "query": "some other keyword",
      "timestamp": 1735707600000,
    }
  ]
}