總覽

您可以使用 Threads API 讓用戶能夠在 Threads 上代表個人建立和發佈內容，並在您的應用程式中只對貼文建立者顯示這些貼文。

限速

對 Threads API 的呼叫會計入呼叫應用程式的呼叫計數。應用程式的呼叫計數是依據各組應用程式與應用程式用戶配對單獨計算，並且是應用程式在連續 24 小時期間內發出的呼叫次數。計算方式如下：

Calls within 24 hours = 4800 * Number of Impressions

曝光次數是過去 24 小時內，應用程式用戶 Threads 帳號的任何內容出現在用戶螢幕畫面上的次數。限速可能也會受到每日 CPU 總時間的影響：

720000 * number_of_impressions for total_cputime 

      2880000 * Number of Impressions for total_time

注意：曝光次數的最小值為 10（所以如果曝光次數少於 10，我們會預設為 10）。

貼文

Threads 個人檔案限制在連續 24 小時內，API 只能發佈 250 則貼文。輪播廣告計為單一貼文。嘗試發佈影音內容容器時，POST /{threads-user-id}/threads_publish 端點會強制執行此限制。建議您的應用程式也強制執行發佈速率限制，尤其是如果您的應用程式允許應用程式用戶排定未來發佈貼文的時程。

若要檢查個人檔案目前的 Threads API 速率限制用量，請查詢 GET /{threads-user-id}/threads_publishing_limit 端點。

注意：此端點需要 threads_basic 和 threads_content_publish 權限。

欄位

名稱	說明
`quota_usage`	過去 24 小時的 Threads 發佈計數。
`config`	Threads 發佈速率限制配置物件，其中包含 `quota_total` 和 `quota_duration` 欄位。

要求範例

curl -s -X GET \
  "https:graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=quota_usage,config&access_token=<ACCESS_TOKEN>"

回應範例

{
  "data": [
    {
      "quota_usage": 4,
      "config": {
        "quota_total": 250,
        "quota_duration": 86400
      }
    }
  ]
}

回覆

Threads 個人檔案限制在連續 24 小時內，只能回覆 1,000 次。

若要檢查個人檔案目前的 Threads 回覆速率限制用量，請查詢 GET /{threads-user-id}/threads_publishing_limit 端點。詳情請參閱回覆管理文件。

注意：此端點需要 threads_basic、threads_content_publish 和 threads_manage_replies 權限。

欄位

名稱	說明
`reply_quota_usage`	過去 24 小時的 Threads 回覆發佈計數。
`reply_config`	Threads 回覆發佈速率限制配置物件，其中包含 `quota_total` 和 `quota_duration` 欄位。

要求範例

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=reply_quota_usage,reply_config&access_token=<ACCESS_TOKEN>"

回應範例

{
  "data": [
    {
      "reply_quota_usage": 1,
      "reply_config": {
        "quota_total": 1000,
        "quota_duration": 86400
      }
    }
  ]
}

刪除

Threads 個人檔案限制在連續 24 小時內，只能刪除 100 次。

若要檢查個人檔案目前的 Threads 刪除速率限制用量，請查詢 GET /{threads-user-id}/threads_publishing_limit 端點。詳情請參閱刪除貼文文件。

注意：此端點需要 threads_basic 和 threads_delete 權限。

欄位

名稱	說明
`delete_quota_usage`	過去 24 小時的 Threads 刪除計數。
`delete_config`	Threads 刪除速率限制配置物件，其中包含 `quota_total` 和 `quota_duration` 欄位。

要求範例

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=delete_quota_usage,delete_config&access_token=<ACCESS_TOKEN>"

回應範例

{
  "data": [
    {
      "delete_quota_usage": 1,
      "delete_config": {
        "quota_total": 100,
        "quota_duration": 86400
      }
    }
  ]
}

地點搜尋

Threads 個人檔案限制在連續 24 小時內，只能搜尋地點 500 次。

若要檢查個人檔案目前的 Threads 地點搜尋速率限制用量，請查詢 GET /{threads-user-id}/threads_publishing_limit 端點。詳情請參閱地點搜尋文件。

注意：此端點需要 threads_basic 和 threads_location_tagging 權限。

欄位

名稱	說明
`location_search_quota_usage`	過去 24 小時的 Threads 地點搜尋計數。
`location_search_config`	Threads 地點搜尋速率限制配置物件，其中包含 `quota_total` 和 `quota_duration` 欄位。

要求範例

curl -s -X GET \
  "https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_publishing_limit?fields=location_search_quota_usage,location_search_config&access_token=<ACCESS_TOKEN>"

回應範例

{
  "data": [
    {
      "location_search_quota_usage": 1,
      "location_search_config": {
        "quota_total": 500,
        "quota_duration": 86400
      }
    }
  ]
}

限制和規格

圖像規格

格式：JPEG 和 PNG 圖像類型是官方支援的圖像貼文格式。
檔案大小：上限 8 MB。
長寬比限制：10:1
寬度下限：320（必要時將放大至此下限）
寬度上限：1440（必要時將縮小至此上限）
高度：依寬度和長寬比變更
色彩空間：sRGB。使用其他色彩空間的圖像會將其色彩空間轉換為 sRGB。

影片規格

容器：MOV 或 MP4（MPEG-4 Part 14），無編輯清單，檔案前面有 moov atom。
音訊轉碼器：AAC，最高 48khz 取樣速率，1 或 2 聲道（單聲道或立體聲）。
影片轉碼器：HEVC 或 H264，逐行掃描，封閉式 GOP，4:2:0 色度二次採樣。
影格速率：23-60 FPS
圖片大小：
- 最大直行數（水平像素）：1920
- 所需的長寬比為 0.01:1 與 10:1 之間，但建議使用 9:16，以避免裁切或空白。
影片位元速率：VBR，最高 100 Mbps。
音訊位元速率：128 kbps。
時間長度：最長 300 秒（5 分鐘），最短大於 0 秒。
檔案大小：上限 1 GB。

其他限制

文字貼文限制為 500 個字元。
輪播貼文必須包含最多 20 則子貼文，最少 2 則子貼文。
其他限制請參閱各端點的參考資料。

後續步驟

開始使用 Threads API