Threads 洞察報告 API

您可以使用 Threads 洞察報告 API 讀取用戶所擁有 Threads 的洞察報告。

權限

Threads 洞察報告 API 要求根據您的目標節點取得適當的存取憑證和權限。測試時，您可以透過使用 Graph API 測試工具輕鬆產生憑證，並向您的應用程式授予權限。

• threads_basic：如要向所有 Threads API 端點發出任何呼叫，此為必要項目。
• threads_read_replies：如要向洞察報告端點發出 GET 呼叫，此為必要項目。

限制

• 用戶洞察報告的 since 和 until 參數不適用於 2024 年 4 月 13 日（Unix 時戳 1712991600）之前的日期。

影音內容洞察報告

如要擷取可用的洞察報告衡量數據，請傳送 GET 要求至 /{threads-media-id}/insights 端點，並附上含有要傳回的逗號分隔衡量數據清單之 metric 參數。

注意：

• 傳回的衡量數據不會擷取嵌套回覆的衡量數據。
• REPOST_FACADE 帖子將會傳回一個空陣列，因為這類帖子由其他用戶發佈。

可用衡量數據

要求範例

curl -s -X GET \
  -F "metric=likes,replies" \
	-F "access_token=<THREADS_ACCESS_TOKEN>"
"https://graph.threads.net/v1.0/<THREADS_MEDIA_ID>/insights" 

回覆範例

{
  "data": [
    {
      "name": "likes",
      "period": "lifetime",
      "values": [
        {
          "value": 100
        }
      ],
      "title": "Likes",
      "description": "The number of likes on your post.",
      "id": "<media_id>/insights/likes/lifetime"
    },
    {
      "name": "replies",
      "period": "lifetime",
      "values": [
        {
          "value": 10
        }
      ],
      "title": "Replies",
      "description": "The number of replies on your post.",
      "id": "<media_id>/insights/replies/lifetime"
    }
  ]
}

用戶洞察報告

如要擷取可用的用戶洞察報告衡量數據，請傳送 GET 要求至 /{threads-user-id}/threads_insights 端點，並附上 metric 參數，以及 since 和 until 參數（選用）。

參數

用戶衡量數據

要求範例

curl -s -X GET \
  -F "metric=views" \
  -F "access_token=<ACCESS_TOKEN>" \
"https://graph.threads.net/v1.0/<THREADS_USER_ID>/threads_insights" 

時間序列衡量數據回應範例

{
  "data": [
    {
      "name": "views",
      "period": "day",
      "values": [
        {
          "value": 10,
          "end_time": "2024-07-12T08:00:00+0000"
        },
        {
          "value": 20,
          "end_time": "2024-07-15T08:00:00+0000"
        },
        {
          "value": 30,
          "end_time": "2024-07-16T08:00:00+0000"
        }
      ],
      "title": "views",
      "description": "The number of times your profile was viewed.",
      "id": "37602215421583/insights/views/day"
    }
  ]
}

總值衡量數據回應範例

{
  "data": [
    {
      "name": "views",
      "period": "day",
      "total_value" : {
        "value": 1
      }
      "title": "views",
      "description": "The number of times your profile was viewed.",
      "id": "37602215421583/insights/views/day"
    }
  ]
}

連結總值回覆範例

{
  "data": [
    {
      "name": "clicks",
      "period": "day",
      "link_total_values": [
        {
          "value": 11,
          "link_url": "https://ai.meta.com/blog/"
        }
      ],
      "title": "clicks",
      "description": "The number of times users clicked on a link.",
      "id": "37602215421583/insights/clicks/day"
    }
  ]
}

錯誤代碼