Ambil insight usaha

Mengembalikan angka valid terbaru yang dikumpulkan Sofia untuk setiap akun yang terhubung. Akun yang belum dikumpulkan terbaca awaiting, tidak pernah nol.

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

GET/v1/establishments/{id}/insights

Kunci API atau access tokenHanya disimpan di tab ini, dan hanya dikirim ke 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"

Otorisasi

Authorizationstringwajib
Kunci pribadi atau access token OAuth Anda, dikirim sebagai Bearer <token>.

Parameter path

idstringwajib
Pengenal usaha.

Parameter query

periodstring
Periode; 28 hari terakhir bila tidak diisi.
Nilai yang diizinkan: last24Hourslast7Dayslast28Days

Respons

200application/json

Angka tiap akun yang terhubung.

establishmentIdstringwajib
Pengenal usaha
periodstringwajib
Periode yang dicakup angka
Nilai yang diizinkan: last24Hourslast7Dayslast28Days
dataobject[]wajib
Angka tiap akun yang terhubung
Tampilkan atribut turunan
- platformstringwajib
  Pengenal platform jaringan
- viewsobjectwajib
  Berapa kali konten ditampilkan atau diputar. Instagram menyebutnya views; akun yang sama bisa terhitung lebih dari sekali, jadi tidak pernah dapat dipertukarkan dengan jangkauan.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- reachobjectwajib
  Akun unik yang melihat konten setidaknya sekali, selama periode.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- reachDeltaPercentobjectwajib
  Perubahan jangkauan dibanding periode sebelumnya, dalam persen bertanda.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- accountsEngagedobjectwajib
  Akun unik yang berinteraksi dengan konten.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- totalInteractionsobjectwajib
  Suka, komentar, simpanan, bagikan, dan interaksi lain yang didukung.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- likesobjectwajib
  Suka selama periode.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- commentsobjectwajib
  Komentar selama periode.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- sharesobjectwajib
  Bagikan selama periode.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- savesobjectwajib
  Simpanan selama periode.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- engagementRatePercentobjectwajib
  Total interaksi dibagi akun yang terjangkau, dalam persen. Dihitung Sofia, bukan angka yang dilaporkan platform. Tidak tersedia bila jangkauan hilang atau nol.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- engagementDeltaPointsobjectwajib
  Perubahan tingkat keterlibatan dibanding periode sebelumnya, dalam poin.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- followersDeltaobjectwajib
  Perubahan bersih pengikut selama periode. Meta menahannya untuk akun Instagram di bawah 100 pengikut, dilaporkan sebagai below-follower-threshold, bukan sebagai kesalahan dan bukan sebagai 0.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- postsPublishedDuringPeriodobjectwajib
  Postingan yang dipublikasikan selama periode.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- followersTotalobjectwajib
  Jumlah mutlak pengikut yang dilaporkan profil yang terhubung. Di Instagram berasal dari instagram_business_basic, bukan dari Insights. available dengan nilai 0 berarti platform melaporkan nol; ketiadaan adalah unavailable beserta alasannya, keduanya tidak pernah sama.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- postsTotalobjectwajib
  Jumlah mutlak postingan di jaringan, sepanjang waktu, yang dilaporkan profil yang terhubung. Kontrak sama dengan followersTotal: nol yang dilaporkan tetap nol, ketiadaan tetap tiada.
  Tampilkan atribut turunan
  - statusstringwajib
    Apakah platform benar-benar melaporkan metrik ini. available bisa membawa nilai 0, yaitu nol hasil pengukuran. unavailable tidak pernah membawa nilai.
    Nilai yang diizinkan: availableunavailable
  - valuenumber
    Angka hasil pengukuran. Hanya ada bila status available; 0 adalah nilai nyata.
  - reasonstring
    Mengapa metrik hilang. below-follower-threshold berarti Meta menahan metrik audiens di bawah 100 pengikut, bukan kesalahan. permission-denied berarti scope Insights tidak ada di akun yang terhubung, permanen sampai pemilik menghubungkan ulang, tidak pernah sementara. not-collected berarti Sofia sendiri belum mengukur angka ini di endpoint ini, platform tidak pernah ditanya, jadi bukan salahnya.
    Nilai yang diizinkan: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True selama platform mungkin masih mengisi jendela ini; Instagram menerbitkan sebagian angka hingga 48 jam terlambat.
  - sourceMetricstring
    Kolom platform asal angka ini, full_video_watched_rate di TikTok, post_video_view_time di Facebook. Dua jaringan menyebut hal berbeda sebagai "penyelesaian"; tanpa ini, laporan akan menyandingkannya seolah sebanding.
  - granularitystring
    Apa yang dicakup angka: total seumur hidup, satu jam, satu hari, seluruh periode yang diminta seperti diagregasi jaringan, atau satu detik video. Deret harian, agregat periode, dan total seumur hidup bukan pengukuran yang sama, jadi jangan digambar di sumbu yang sama atau dijumlahkan.
    Nilai yang diizinkan: lifetimehourdayperiodvideo-second
- hasInsightsDatabooleanwajib
  True bila setidaknya satu panggilan Insights berhasil. Jumlah pengikut dan postingan juga berasal dari scope profil dasar, jadi keberadaannya saja tidak membuktikan Insights dapat dibaca.
- mayBeDelayedbooleanwajib
  True selama platform mungkin masih mengisi jendela ini (hingga 48 jam).
- socialAccountIdstringwajib
  Akun terhubung pemilik angka-angka ini.
- collectionobjectwajib
  Fakta pengumpulan di balik angka-angka ini.
  Tampilkan atribut turunan
  - statestringwajib
    awaiting-first-collection: akun terhubung dan belum ada jawaban valid, setiap metrik terbaca not-collected.
    Nilai yang diizinkan: collectedawaiting-first-collection
  - isOutdatedbooleanwajib
    True bila percobaan berikutnya tidak berhasil, atau pengumpulan berikutnya terlambat lebih dari satu jam. Angka tetap valid untuk jendela dan tanggalnya sendiri; hanya saja tidak terkini.
  - isCollectingbooleanwajib
    True selama pengumpulan untuk akun ini sedang berjalan.
  - collectedAtnumber
    Kapan jaringan menjawab (unix ms).
  - windowStartnumber
    Awal jendela yang diminta dari jaringan (unix ms).
  - windowEndnumber
    Akhir jendela yang diminta dari jaringan (unix ms).
  - completenessstring
    partial: jaringan hanya menjawab sebagian jendela, atau sebagian metrik gagal.
    Nilai yang diizinkan: completepartial
  - nextCollectionAtnumber
    Kapan pengumpulan berikutnya dijadwalkan (unix ms).
  - lastFailedAttemptobject
    Percobaan terakhir, bila berakhir setelah angka yang ditampilkan dan tidak berhasil.
    Tampilkan atribut turunan
    atnumberwajib
    Kapan percobaan berakhir (unix ms)
    outcomestringwajib
    deferred: jaringan meminta Sofia menunggu (rate limit, kuota). failed: selain itu.
    Nilai yang diizinkan: faileddeferred
    reasonstring
    Alasannya, seperti diklasifikasikan Sofia (reauthentication-required, platform-error…).
- reachDailySeriesnumber[]
  Nilai jangkauan harian. Tidak ada bila platform tidak mengembalikan deret, tidak pernah diisi nol.
- engagementDailySeriesnumber[]
  Tingkat keterlibatan harian dalam persen. Tidak ada di Instagram: total_interactions tidak punya mode deret waktu, jadi tidak ada tingkat harian yang jujur.
- followersDailySeriesnumber[]
  Perubahan bersih pengikut harian. Tidak ada bila platform tidak melaporkannya.
- fetchedAtnumber
  Kapan jaringan menjawab (unix ms). Tidak ada sampai pengumpulan pertama berhasil.

401

Token tidak ada, tidak dikenal, kedaluwarsa, atau dicabut.

403

Token tidak memiliki scope insights:read.

404

Usaha di luar Workspace token.

4XXapplication/json

Kesalahan lain apa pun, dalam amplop kesalahan.

Ambil insight usaha

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