取得門市數據洞察

回傳 Sofia 為每個已連結帳號收集的最新有效數據。尚未收集到數據的帳號顯示 awaiting，絕不會顯示為零。

GEThttps://api.sofia-post.com/api/v1/establishments/{id}/insights

GET/v1/establishments/{id}/insights

API 金鑰或存取權杖僅保存在此分頁中，且僅傳送到 api.sofia-post.com。id (path)period (query)

curl -X GET 'https://api.sofia-post.com/api/v1/establishments/{id}/insights' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

授權

Authorizationstring必填
你的個人金鑰或 OAuth 存取權杖，以 Bearer <token> 傳送。

路徑參數

idstring必填
門市的識別碼。

查詢參數

periodstring
統計週期；省略時為最近 28 天。
允許的值： last24Hourslast7Dayslast28Days

回應

200application/json

每個已連結帳號的數據。

establishmentIdstring必填
門市的識別碼
periodstring必填
數據涵蓋的週期
允許的值： last24Hourslast7Dayslast28Days
dataobject[]必填
每個已連結帳號的數據
顯示子屬性
- platformstring必填
  網絡的平台識別碼
- viewsobject必填
  內容被展示或播放的次數。Instagram 稱之為 views；同一帳號可能被多次計入，因此絕不能與觸及互換。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- reachobject必填
  週期內至少看過一次內容的獨立帳號數。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- reachDeltaPercentobject必填
  觸及相對上一週期的變化，帶正負號的百分比。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- accountsEngagedobject必填
  與內容互動過的獨立帳號數。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- totalInteractionsobject必填
  讚好、留言、收藏、分享及其他受支援的互動總數。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- likesobject必填
  週期內的讚好數。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- commentsobject必填
  週期內的留言數。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- sharesobject必填
  週期內的分享數。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- savesobject必填
  週期內的收藏數。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- engagementRatePercentobject必填
  總互動數除以觸及帳號數，以百分比表示。由 Sofia 計算，並非平台報告的數據。觸及缺失或為零時不可用。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- engagementDeltaPointsobject必填
  互動率相對上一週期的變化，以百分點計。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- followersDeltaobject必填
  週期內粉絲的淨變化。Meta 對粉絲不足 100 的 Instagram 帳號不提供，以 below-follower-threshold 報告，既不是錯誤，也不是 0。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- postsPublishedDuringPeriodobject必填
  週期內發布的帖文數。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- followersTotalobject必填
  已連結個人檔案報告的粉絲絕對數量。在 Instagram 上來自 instagram_business_basic，而非 Insights。值為 0 的 available 表示平台報告了零；缺失則是帶原因的 unavailable，二者絕不是同一個數據。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- postsTotalobject必填
  已連結個人檔案報告的網絡上帖文絕對總數（歷史累計）。約定與 followersTotal 相同：報告的零仍是零，缺失仍是缺失。
  顯示子屬性
  - statusstring必填
    平台是否確實報告了該指標。available 可能帶有值 0，這是實際測得的零。unavailable 從不帶值。
    允許的值： availableunavailable
  - valuenumber
    測得的數值。僅在狀態為 available 時出現；0 是真實的值。
  - reasonstring
    指標缺失的原因。below-follower-threshold 是 Meta 對粉絲不足 100 的帳號不提供受眾指標，不是錯誤。permission-denied 是已連結帳號缺少 Insights scope，在所有者重新連結前一直如此，絕非暫時性的。not-collected 是 Sofia 自己尚未在此端點測量該數據，從未向平台請求，所以不怪平台。
    允許的值： not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    平台可能仍在補全此時間視窗時為 true；Instagram 的部分數據最多延遲 48 小時發布。
  - sourceMetricstring
    該數據來自的平台欄位，TikTok 為 full_video_watched_rate，Facebook 為 post_video_view_time。兩個網絡把不同的東西稱作「完播」；沒有這個欄位，報告會把它們當作可比較的項目並排放置。
  - granularitystring
    數據涵蓋的範圍：累計總數、一小時、一天、網絡彙總的整個請求週期，或影片的一秒。每日序列、週期彙總和累計總數不是同一種測量，不能畫在同一座標軸上，也不能相互求和。
    允許的值： lifetimehourdayperiodvideo-second
- hasInsightsDataboolean必填
  至少有一次 Insights 呼叫成功時為 true。粉絲數和帖文數也來自基礎個人檔案 scope，因此僅憑它們的存在不能證明 Insights 可讀。
- mayBeDelayedboolean必填
  平台可能仍在補全此時間視窗時（最長 48 小時）為 true。
- socialAccountIdstring必填
  這些數據所屬的已連結帳號。
- collectionobject必填
  這些數據背後的收集資訊。
  顯示子屬性
  - statestring必填
    awaiting-first-collection：帳號已連結但還沒有有效回應，所有指標均顯示 not-collected。
    允許的值： collectedawaiting-first-collection
  - isOutdatedboolean必填
    後續嘗試未成功，或下一次收集已延遲超過一小時時為 true。數據對其自身的視窗和日期仍然有效，只是不是最新的。
  - isCollectingboolean必填
    該帳號的收集正在執行時為 true。
  - collectedAtnumber
    網絡作出回應的時間（unix ms）。
  - windowStartnumber
    向網絡請求的時間視窗的起點（unix ms）。
  - windowEndnumber
    向網絡請求的時間視窗的終點（unix ms）。
  - completenessstring
    partial：網絡只回應了視窗的一部分，或部分指標失敗。
    允許的值： completepartial
  - nextCollectionAtnumber
    下一次收集的預計時間（unix ms）。
  - lastFailedAttemptobject
    最近一次嘗試，在所示數據之後結束且未成功時給出。
    顯示子屬性
    atnumber必填
    該次嘗試結束的時間（unix ms）
    outcomestring必填
    deferred：網絡要求 Sofia 等待（速率限制、配額）。failed：其他情況。
    允許的值： faileddeferred
    reasonstring
    Sofia 歸類的原因（reauthentication-required、platform-error 等）。
- reachDailySeriesnumber[]
  每日觸及值。平台未回傳序列時不出現，絕不用零填充。
- engagementDailySeriesnumber[]
  每日互動率，以百分比表示。Instagram 上不出現：total_interactions 沒有時間序列模式，因此不存在可信的每日比率。
- followersDailySeriesnumber[]
  每日粉絲淨變化。平台不報告時不出現。
- fetchedAtnumber
  網絡作出回應的時間（unix ms）。首次收集成功前不出現。

401

權杖缺失、未知、已過期或已被撤銷。

403

權杖沒有 insights:read scope。

404

不在權杖所屬 Workspace 內的門市。

4XXapplication/json

其他任何錯誤，以錯誤結構回傳。

取得門市數據洞察

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/establishments/<id>/insights' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "establishmentId": "string",
  "period": "last24Hours",
  "data": [
    {
      "platform": "instagram",
      "views": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reach": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reachDeltaPercent": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "accountsEngaged": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "totalInteractions": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "likes": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "comments": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "shares": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "saves": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "engagementRatePercent": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "engagementDeltaPoints": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "followersDelta": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "postsPublishedDuringPeriod": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reachDailySeries": [
        0
      ],
      "followersDailySeries": [
        0
      ],
      "followersTotal": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "postsTotal": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "hasInsightsData": true,
      "mayBeDelayed": false,
      "fetchedAt": 1739539200000,
      "socialAccountId": "acc_123",
      "collection": {
        "state": "collected",
        "collectedAt": 1739539200000,
        "completeness": "complete",
        "isOutdated": false,
        "isCollecting": false
      }
    }
  ]
}