Establishments

Get establishment insights

Returns the latest valid figures Sofia collected for each connected account. An account not yet collected reads awaiting, never zero.

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

curl -X GET 'https://api.sofia-post.com/api/v1/establishments/{id}/insights' \
  -H "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
      }
    }
  ]
}

Get establishment insights

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

period is last24Hours, last7Days or last28Days (the default). The response gives, for each connected account, the latest figures collected by Sofia.

curl "https://api.sofia-post.com/api/v1/establishments/$ESTABLISHMENT_ID/insights?period=last7Days" \
  -H "Authorization: Bearer $SOFIA_API_KEY"

An account not yet collected is awaiting, never zero.
Each measure is available with its value, or unavailable with its reason; mayBeDelayed warns that the network publishes it with a delay.

Authorizations

Authorizationstringheaderrequired
Your personal key or OAuth access token, sent as Bearer <token>.

Path parameters

idstringrequired
Identifier of the establishment.

Query parameters

periodstring
The period; the last 28 days when omitted.
Allowed values: last24Hourslast7Dayslast28Days

Response

The figures of each connected account.

establishmentIdstringrequired
Identifier of the establishment
periodstringrequired
Period covered by the figures
Allowed values: last24Hourslast7Dayslast28Days
dataobject[]required
The figures of each connected account
Show child attributes
- platformstringrequired
  Network platform identifier
- viewsobjectrequired
  Times the content was displayed or played. Instagram calls this views; it can count the same account more than once, so it is never interchangeable with reach.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- reachobjectrequired
  Unique accounts that saw the content at least once, over the period.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- reachDeltaPercentobjectrequired
  Reach change vs the previous period, in signed percent.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- accountsEngagedobjectrequired
  Unique accounts that interacted with the content.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- totalInteractionsobjectrequired
  Likes, comments, saves, shares and other supported interactions.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- likesobjectrequired
  Likes over the period.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- commentsobjectrequired
  Comments over the period.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- sharesobjectrequired
  Shares over the period.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- savesobjectrequired
  Saves over the period.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- engagementRatePercentobjectrequired
  Total interactions divided by accounts reached, in percent. Calculated by Sofia, not a figure the platform reports. Unavailable when reach is missing or zero.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- engagementDeltaPointsobjectrequired
  Engagement rate change vs the previous period, in points.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- followersDeltaobjectrequired
  Net follower change over the period. Meta withholds it for Instagram accounts under 100 followers, reported as below-follower-threshold, not as an error and not as 0.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- postsPublishedDuringPeriodobjectrequired
  Posts published during the period.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- followersTotalobjectrequired
  Absolute follower count reported by the connected profile. On Instagram this comes from instagram_business_basic, not from Insights. available with value 0 means the platform reported zero; an absence is unavailable with its reason, the two are never the same figure.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- postsTotalobjectrequired
  Absolute number of posts on the network, all time, reported by the connected profile. Same contract as followersTotal: a reported zero stays zero, an absence stays absent.
  Show child attributes
  - statusstringrequired
    Whether the platform actually reported this metric. available may carry a value of 0, a measured zero. unavailable never carries a value.
    Allowed values: availableunavailable
  - valuenumber
    The measured figure. Present only when status is available; 0 is a real value.
  - reasonstring
    Why the metric is missing. below-follower-threshold is Meta withholding audience metrics under 100 followers, not an error. permission-denied is a missing Insights scope on the connected account, permanent until the owner reconnects, never transient. not-collected is Sofia itself not measuring this figure on this endpoint yet, the platform was never asked, so it is not to blame.
    Allowed values: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    True while the platform may still be filling this window in, Instagram publishes some figures up to 48 hours late.
  - sourceMetricstring
    The platform field this figure comes from, full_video_watched_rate on TikTok, post_video_view_time on Facebook. Two networks call different things "completion"; without this, a report would put them side by side as if they were comparable.
  - granularitystring
    What the figure covers: a lifetime total, one hour, one day, the whole requested period as the network aggregated it, or one second of video. A daily series, a period aggregate and a lifetime total are not the same measurement and must not be charted on the same axis, nor summed into one another.
    Allowed values: lifetimehourdayperiodvideo-second
- hasInsightsDatabooleanrequired
  True when at least one Insights call succeeded. Followers and post counts also come from the basic profile scope, so their presence alone does not prove Insights are readable.
- mayBeDelayedbooleanrequired
  True while the platform may still be filling this window in (up to 48 hours).
- socialAccountIdstringrequired
  The connected account these figures belong to.
- collectionobjectrequired
  Collection facts behind these figures.
  Show child attributes
  - statestringrequired
    awaiting-first-collection: the account is connected and no valid answer exists yet, every metric reads not-collected.
    Allowed values: collectedawaiting-first-collection
  - isOutdatedbooleanrequired
    True when a later attempt did not succeed, or the next collection is more than an hour late. The figures stay valid for their own window and date; they are not current.
  - isCollectingbooleanrequired
    True while a collection of this account is running.
  - collectedAtnumber
    When the network answered (unix ms).
  - windowStartnumber
    Start of the window the network was asked for (unix ms).
  - windowEndnumber
    End of the window the network was asked for (unix ms).
  - completenessstring
    partial: the network answered only part of the window, or some metrics failed.
    Allowed values: completepartial
  - nextCollectionAtnumber
    When the next collection is due (unix ms).
  - lastFailedAttemptobject
    The last attempt, when it ended after the figures shown and did not succeed.
    Show child attributes
    atnumberrequired
    When the attempt ended (unix ms)
    outcomestringrequired
    deferred: the network asked Sofia to wait (rate limit, quota). failed: anything else.
    Allowed values: faileddeferred
    reasonstring
    Why, as Sofia classified it (reauthentication-required, platform-error…).
- reachDailySeriesnumber[]
  Daily reach values. Absent when the platform returned no series, never zero-filled.
- engagementDailySeriesnumber[]
  Daily engagement rate in percent. Absent on Instagram: total_interactions has no time-series mode, so no honest per-day rate exists.
- followersDailySeriesnumber[]
  Daily net follower change. Absent when the platform does not report it.
- fetchedAtnumber
  When the network answered (unix ms). Absent until the first collection succeeds.

Was this page helpful?