店舗のインサイトを取得する

Sofia が連携アカウントごとに収集した最新の有効な数値を返します。未収集のアカウントは 0 ではなく 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必須
店舗の ID。

クエリパラメーター

periodstring
期間。省略すると直近 28 日間です。
使用できる値： last24Hourslast7Dayslast28Days

レスポンス

200application/json

連携アカウントごとの数値。

establishmentIdstring必須
店舗の ID
periodstring必須
数値が対象とする期間
使用できる値： last24Hourslast7Dayslast28Days
dataobject[]必須
連携アカウントごとの数値
子属性を表示
- platformstring必須
  ネットワークのプラットフォーム ID
- viewsobject必須
  コンテンツが表示または再生された回数。Instagram では views と呼ばれ、同じアカウントを複数回数えることがあるため、リーチとは決して同一視できません。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- reachobject必須
  期間中にコンテンツを 1 回以上見たユニークアカウント数。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- reachDeltaPercentobject必須
  前の期間と比べたリーチの変化。符号付きのパーセントです。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- accountsEngagedobject必須
  コンテンツに反応したユニークアカウント数。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- totalInteractionsobject必須
  いいね、コメント、保存、シェアなど、対応するインタラクションの合計。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- likesobject必須
  期間中のいいね数。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- commentsobject必須
  期間中のコメント数。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- sharesobject必須
  期間中のシェア数。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- savesobject必須
  期間中の保存数。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- engagementRatePercentobject必須
  総インタラクション数をリーチしたアカウント数で割った値（パーセント）。プラットフォームの報告値ではなく Sofia が計算します。リーチがない、または 0 の場合は利用できません。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- engagementDeltaPointsobject必須
  前の期間と比べたエンゲージメント率の変化（ポイント）。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- followersDeltaobject必須
  期間中のフォロワー純増減。Meta はフォロワー 100 人未満の Instagram アカウントでは提供せず、エラーでも 0 でもなく below-follower-threshold として報告されます。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- postsPublishedDuringPeriodobject必須
  期間中に公開された投稿数。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- followersTotalobject必須
  連携プロフィールが報告するフォロワー総数。Instagram では Insights ではなく instagram_business_basic から取得します。値が 0 の available はプラットフォームが 0 を報告したことを、欠落は理由付きの unavailable を意味し、この 2 つは決して同じ数値ではありません。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- postsTotalobject必須
  連携プロフィールが報告する、ネットワーク上の全期間の投稿総数。契約は followersTotal と同じで、報告された 0 は 0 のまま、欠落は欠落のままです。
  子属性を表示
  - statusstring必須
    プラットフォームがこの指標を実際に報告したかどうか。available は 0 を持つことがあり、これは計測された 0 です。unavailable は値を持ちません。
    使用できる値： availableunavailable
  - valuenumber
    計測された数値。ステータスが available の場合のみ存在し、0 は実際の値です。
  - reasonstring
    指標がない理由。below-follower-threshold は、Meta がフォロワー 100 人未満のオーディエンス指標を提供しないもので、エラーではありません。permission-denied は連携アカウントに Insights のスコープがない状態で、オーナーが再連携するまで続き、一時的ではありません。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。2 つのネットワークは異なるものを「完了」と呼ぶため、これがないとレポートで同列に比較されてしまいます。
  - granularitystring
    数値の対象範囲：通算の合計、1 時間、1 日、ネットワークが集計した要求期間全体、または動画の 1 秒。日次の系列、期間の集計、通算の合計は別の計測値のため、同じ軸に描いたり、互いに合算したりしてはいけません。
    使用できる値： lifetimehourdayperiodvideo-second
- hasInsightsDataboolean必須
  Insights の呼び出しが 1 回以上成功した場合は true。フォロワー数と投稿数は基本プロフィールのスコープからも取得されるため、それだけでは Insights を読み取れる証拠になりません。
- mayBeDelayedboolean必須
  プラットフォームがこの期間の数値を補完している間（最大 48 時間）は true です。
- socialAccountIdstring必須
  この数値が属する連携アカウント。
- collectionobject必須
  この数値の背景にある収集情報。
  子属性を表示
  - statestring必須
    awaiting-first-collection：アカウントは連携済みで有効な回答がまだなく、すべての指標が not-collected になります。
    使用できる値： collectedawaiting-first-collection
  - isOutdatedboolean必須
    後の試行が成功しなかった、または次の収集が 1 時間以上遅れている場合は 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[]
  日次のリーチ値。プラットフォームが系列を返さない場合は含まれず、0 で埋められることはありません。
- engagementDailySeriesnumber[]
  日次のエンゲージメント率（パーセント）。Instagram では含まれません。total_interactions には時系列モードがなく、正確な日次の率が存在しないためです。
- followersDailySeriesnumber[]
  日次のフォロワー純増減。プラットフォームが報告しない場合は含まれません。
- fetchedAtnumber
  ネットワークが回答した日時（unix ms）。最初の収集が成功するまでは含まれません。

401

トークンがない、不明、期限切れ、または失効しています。

403

トークンに insights:read スコープがありません。

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
      }
    }
  ]
}