门店获取门店数据洞察

门店

获取门店数据洞察

返回 Sofia 为每个已连接账号收集的最新有效数据。尚未收集到数据的账号显示 awaiting,绝不会显示为零。

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

授权

  • Authorizationstring必填

    你的个人密钥或 OAuth 访问令牌,以 Bearer <token> 发送。

路径参数

  • idstring必填

    门店的标识符。

查询参数

  • periodstring

    统计周期;省略时为最近 28 天。

    允许的值: last24Hourslast7Dayslast28Days

响应

200application/json

每个已连接账号的数据。

  • establishmentIdstring必填

    门店的标识符

  • periodstring必填

    数据涵盖的周期

    允许的值: last24Hourslast7Dayslast28Days

  • dataobject[]必填

    每个已连接账号的数据

    显示子属性
    • platformstring必填

      网络的平台标识符

    • viewsobject必填

      内容被展示或播放的次数。Instagram 称之为 views;同一账号可能被多次计入,因此绝不能与触达互换。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • reachobject必填

      周期内至少看过一次内容的独立账号数。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • reachDeltaPercentobject必填

      触达相对上一周期的变化,带正负号的百分比。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • accountsEngagedobject必填

      与内容互动过的独立账号数。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • totalInteractionsobject必填

      点赞、评论、收藏、分享及其他受支持的互动总数。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • likesobject必填

      周期内的点赞数。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • commentsobject必填

      周期内的评论数。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • sharesobject必填

      周期内的分享数。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • savesobject必填

      周期内的收藏数。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • engagementRatePercentobject必填

      总互动数除以触达账号数,以百分比表示。由 Sofia 计算,并非平台报告的数据。触达缺失或为零时不可用。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • engagementDeltaPointsobject必填

      互动率相对上一周期的变化,以百分点计。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • followersDeltaobject必填

      周期内粉丝的净变化。Meta 对粉丝不足 100 的 Instagram 账号不提供,以 below-follower-threshold 报告,既不是错误,也不是 0。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • postsPublishedDuringPeriodobject必填

      周期内发布的帖子数。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • followersTotalobject必填

      已连接主页报告的粉丝绝对数量。在 Instagram 上来自 instagram_business_basic,而非 Insights。值为 0 的 available 表示平台报告了零;缺失则是带原因的 unavailable,二者绝不是同一个数据。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • postsTotalobject必填

      已连接主页报告的网络上帖子绝对总数(历史累计)。约定与 followersTotal 相同:报告的零仍是零,缺失仍是缺失。

      显示子属性
      • statusstring必填

        平台是否确实报告了该指标。available 可能带有值 0,这是实际测得的零。unavailable 从不带值。

        允许的值: availableunavailable

      • valuenumber

        测得的数值。仅在状态为 available 时出现;0 是真实的值。

      • reasonstring

        指标缺失的原因。below-follower-threshold 是 Meta 对粉丝不足 100 的账号不提供受众指标,不是错误。permission-denied 是已连接账号缺少 Insights scope,在所有者重新连接前一直如此,绝非暂时性的。not-collected 是 Sofia 自己尚未在此端点测量该数据,从未向平台请求,所以不怪平台。

        允许的值: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window

      • mayBeDelayedboolean

        平台可能仍在补全此时间窗口时为 true;Instagram 的部分数据最多延迟 48 小时发布。

      • sourceMetricstring

        该数据来自的平台字段,TikTok 为 full_video_watched_rate,Facebook 为 post_video_view_time。两个网络把不同的东西称作“完播”;没有这个字段,报告会把它们当作可比项并排放置。

      • granularitystring

        数据涵盖的范围:累计总数、一小时、一天、网络汇总的整个请求周期,或视频的一秒。每日序列、周期汇总和累计总数不是同一种测量,不能画在同一坐标轴上,也不能相互求和。

        允许的值: lifetimehourdayperiodvideo-second

    • hasInsightsDataboolean必填

      至少有一次 Insights 调用成功时为 true。粉丝数和帖子数也来自基础主页 scope,因此仅凭它们的存在不能证明 Insights 可读。

    • mayBeDelayedboolean必填

      平台可能仍在补全此时间窗口时(最长 48 小时)为 true。

    • socialAccountIdstring必填

      这些数据所属的已连接账号。

    • collectionobject必填

      这些数据背后的收集信息。

      显示子属性
      • statestring必填

        awaiting-first-collection:账号已连接但还没有有效回应,所有指标均显示 not-collected。

        允许的值: collectedawaiting-first-collection

      • isOutdatedboolean必填

        后续尝试未成功,或下一次收集已延迟超过一小时时为 true。数据对其自身的窗口和日期仍然有效,只是不是最新的。

      • isCollectingboolean必填

        该账号的收集正在运行时为 true。

      • collectedAtnumber

        网络作出回应的时间(unix ms)。

      • windowStartnumber

        向网络请求的时间窗口的起点(unix ms)。

      • windowEndnumber

        向网络请求的时间窗口的终点(unix ms)。

      • completenessstring

        partial:网络只回应了窗口的一部分,或部分指标失败。

        允许的值: completepartial

      • nextCollectionAtnumber

        下一次收集的计划时间(unix ms)。

      • lastFailedAttemptobject

        最近一次尝试,在所示数据之后结束且未成功时给出。

        显示子属性
        • atnumber必填

          该次尝试结束的时间(unix ms)

        • outcomestring必填

          deferred:网络要求 Sofia 等待(速率限制、配额)。failed:其他情况。

          允许的值: faileddeferred

        • reasonstring

          Sofia 归类的原因(reauthentication-required、platform-error 等)。

    • reachDailySeriesnumber[]

      每日触达值。平台未返回序列时不出现,绝不用零填充。

    • engagementDailySeriesnumber[]

      每日互动率,以百分比表示。Instagram 上不出现:total_interactions 没有时间序列模式,因此不存在可信的每日比率。

    • followersDailySeriesnumber[]

      每日粉丝净变化。平台不报告时不出现。

    • fetchedAtnumber

      网络作出回应的时间(unix ms)。首次收集成功前不出现。

401

令牌缺失、未知、已过期或已被撤销。

403

令牌没有 insights:read scope。

404

不在令牌所属 Workspace 内的门店。

4XXapplication/json

其他任何错误,以错误结构返回。