Статистика Instagram через API: аккаунт и публикации

Коротко: как получить статистику Instagram через API

Способ входа: хост и разрешения

При входе через Facebook, если роль пользователя на странице выдана через Business Manager, документация Meta дополнительно указывает разрешения ads_management и ads_read.

Метрики уровня аккаунта

Список из актуального справочника Meta. Обычные метрики запрашиваются с period=day.

естьнет

Все метрики работают с metric_type=total_value, reach поддерживает ещё и time_series. Демография запрашивается с period=lifetime и timeframe.

Метрики публикаций по типам контента

Набор зависит от media_product_type. Если запросить неподходящую метрику, Graph API отклонит весь запрос.

естьнетТаблицу можно прокрутить вбок

likes и comments считают только органику. При входе через Facebook есть total_likes, total_comments и total_views, которые включают взаимодействия с рекламой.

Изменения 2024–2025: что отключили и что добавили

Именно поэтому код из старых туториалов перестал работать.

Для публикаций, созданных после 2 июля 2024 года, impressions перестала работать ещё раньше.

Демография: кто подписан и кто вовлечён

Период, задержка и срок хранения данных

Как настроить сбор статистики: 5 шагов

1. 1

   Проверьте тип аккаунта

   Аккаунт Instagram должен быть Business или Creator. Для входа через Facebook он привязывается к странице Facebook.

2. 2

   Запросите разрешения на статистику

   Вход через Instagram: instagram_business_basic и instagram_business_manage_insights. Через Facebook: instagram_basic, instagram_manage_insights, pages_read_engagement. Для чужих аккаунтов они требуют App Review.

3. 3

   Собирайте метрики аккаунта ежедневно

   Запрашивайте views, reach, accounts_engaged, total_interactions и другие с period=day и сохраняйте каждый день.

4. 4

   Метрики публикаций — по типу контента

   Сначала узнайте media_product_type (FEED, REELS, STORY), затем запросите подходящий набор. Stories собирайте в течение 24 часов.

5. 5

   Демографию — раз в неделю или месяц

   Запрашивайте follower_demographics с timeframe=this_month отдельно для каждого breakdown и сохраняйте результат с датой.

Python: аккаунт, публикации и демография

Вход через Facebook: токен страницы и ID Instagram-аккаунта.

import asyncio, os
from datetime import date, timedelta
from socialift import Instagram

async def main() -> None:
    token = os.environ["PAGE_TOKEN"]
    ig_user_id = os.environ["IG_USER_ID"]
    async with Instagram.via_facebook(app_secret=os.environ["FACEBOOK_APP_SECRET"]) as ig:
        week = await ig.insights(
            token, ig_user_id=ig_user_id, since=date.today() - timedelta(days=7), until=date.today()
        )
        print(week["since"], week["until"], week["metrics"])

        for post in await ig.media(token, ig_user_id=ig_user_id, limit=5):
            print(post["id"], post["media_type"], await ig.media_insights(post["id"], token))

        demo = await ig.demographics(token, ig_user_id=ig_user_id)
        for cut, data in demo.items():
            print(cut, data["values"] if data["available"] else data["reason"])

asyncio.run(main())

Что именно запрашивает SDK Socialift

Важно знать, какие метрики запрашивают методы, чтобы правильно строить отчёт.

Советы для системы отчётности

• ▸Используйте views вместо impressions и plays — обновите старые дашборды.
• ▸Не записывайте пустой ответ как 0: это «нет данных».
• ▸Ежедневно перезагружайте последние 48 часов — цифры могут быть не финальными.
• ▸Собирайте статистику stories в течение 24 часов.
• ▸Храните ежедневные снапшоты у себя, длинные периоды запрашивайте частями.
• ▸Отдельно обрабатывайте нехватку разрешений (PermissionError) и проблемы с токеном (AuthError).