Заведения

Получить статистику заведения

Возвращает последние действительные данные, собранные Sofia по каждому подключённому аккаунту. Ещё не собранный аккаунт показывает awaiting, но не ноль.

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

Получить статистику заведения

Авторизации

Authorizationstringобязательно

Ваш личный ключ или токен доступа OAuth, отправляется как Bearer <token>.

Хранится только в этой вкладке и отправляется только на api.sofia-post.com. Получить ключ API

Параметры пути

idstringобязательно

Идентификатор заведения.

Параметры запроса

periodstring

Период; последние 28 дней, если не указан.

Получить статистику заведения

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

Получить статистику заведения

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 принимает last24Hours, last7Days или last28Days (по умолчанию). Ответ содержит для каждого подключённого аккаунта последние цифры, собранные Sofia.

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

Аккаунт, по которому данные ещё не собраны, имеет статус awaiting, но никогда не ноль.
Каждый показатель — available со своим value или unavailable со своим reason; mayBeDelayed предупреждает, что сеть публикует его с задержкой.

Авторизации

Authorizationstringheaderобязательно
Ваш личный ключ или токен доступа OAuth, отправляется как Bearer <token>.

Параметры пути

idstringобязательно
Идентификатор заведения.

Параметры запроса

periodstring
Период; последние 28 дней, если не указан.
Допустимые значения: last24Hourslast7Dayslast28Days

Ответ

Данные по каждому подключённому аккаунту.

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, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- reachobjectобязательно
  Уникальные аккаунты, увидевшие контент хотя бы раз за период.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- reachDeltaPercentobjectобязательно
  Изменение охвата по сравнению с прошлым периодом, в процентах со знаком.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- accountsEngagedobjectобязательно
  Уникальные аккаунты, взаимодействовавшие с контентом.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- totalInteractionsobjectобязательно
  Лайки, комментарии, сохранения, репосты и другие поддерживаемые взаимодействия.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- likesobjectобязательно
  Лайки за период.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- commentsobjectобязательно
  Комментарии за период.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- sharesobjectобязательно
  Репосты за период.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- savesobjectобязательно
  Сохранения за период.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- engagementRatePercentobjectобязательно
  Все взаимодействия, делённые на число охваченных аккаунтов, в процентах. Считает Sofia, платформа это значение не сообщает. Недоступно, если охват отсутствует или равен нулю.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- engagementDeltaPointsobjectобязательно
  Изменение уровня вовлечённости по сравнению с прошлым периодом, в пунктах.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- followersDeltaobjectобязательно
  Чистое изменение числа подписчиков за период. Для аккаунтов Instagram до 100 подписчиков Meta его скрывает, это below-follower-threshold, а не ошибка и не 0.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- postsPublishedDuringPeriodobjectобязательно
  Публикации, вышедшие за период.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- followersTotalobjectобязательно
  Абсолютное число подписчиков, сообщённое подключённым профилем. В Instagram берётся из instagram_business_basic, а не из Insights. available со значением 0 значит, что платформа сообщила ноль; отсутствие это unavailable с причиной, это никогда не одно и то же.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- postsTotalobjectобязательно
  Абсолютное число публикаций в сети за всё время, сообщённое подключённым профилем. Тот же контракт, что у followersTotal: сообщённый ноль остаётся нулём, отсутствие остаётся отсутствием.
  Показать дочерние атрибуты
  - statusstringобязательно
    Сообщила ли платформа эту метрику на самом деле. available может нести значение 0, измеренный ноль. unavailable никогда не несёт значения.
    Допустимые значения: availableunavailable
  - valuenumber
    Измеренное значение. Есть только при статусе available; 0 является настоящим значением.
  - reasonstring
    Почему метрики нет. below-follower-threshold: Meta скрывает метрики аудитории до 100 подписчиков, это не ошибка. permission-denied: у подключённого аккаунта нет разрешения Insights, это постоянно до повторного подключения владельцем, никогда не временно. not-collected: Sofia ещё не измеряет это значение на этом endpoint, платформу не спрашивали, так что она ни при чём.
    Допустимые значения: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Истина, пока платформа может дополнять это окно; Instagram публикует некоторые данные с опозданием до 48 часов.
  - sourceMetricstring
    Поле платформы, из которого взято значение: full_video_watched_rate в TikTok, post_video_view_time в Facebook. Две сети называют «досмотром» разное; без этого поля отчёт поставил бы их рядом, как сопоставимые.
  - granularitystring
    Что охватывает значение: итог за всё время, час, день, весь запрошенный период в агрегации сети или одна секунда видео. Дневной ряд, агрегат за период и итог за всё время измеряют разное: не стройте их на одной оси и не суммируйте.
    Допустимые значения: lifetimehourdayperiodvideo-second
- hasInsightsDatabooleanобязательно
  Истина, если хотя бы один вызов Insights удался. Подписчики и число публикаций приходят и из базового профиля, поэтому их наличие не доказывает, что Insights читаются.
- mayBeDelayedbooleanобязательно
  Истина, пока платформа может дополнять это окно (до 48 часов).
- socialAccountIdstringобязательно
  Подключённый аккаунт, которому принадлежат эти данные.
- collectionobjectобязательно
  Сведения о сборе за этими данными.
  Показать дочерние атрибуты
  - statestringобязательно
    awaiting-first-collection: аккаунт подключён, действительного ответа ещё нет, каждая метрика равна not-collected.
    Допустимые значения: collectedawaiting-first-collection
  - isOutdatedbooleanобязательно
    Истина, если более поздняя попытка не удалась или следующий сбор опаздывает больше чем на час. Данные остаются верными для своего окна и даты, но не актуальны.
  - isCollectingbooleanобязательно
    Истина, пока идёт сбор по этому аккаунту.
  - 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). Нет, пока первый сбор не удался.

Эта страница была полезной?