Zaloguj sięRozpocznij bezpłatny okres próbny
easyCoexistence Oficjalne API

Statystyki relacji na Instagramie przez API

Endpoint statystyk mediów Instagrama zwraca dla relacji, dopóki jest aktywna, te metryki: reach, views, replies, shares, navigation, follows, profile_visits, profile_activity, reposts i total_interactions. navigation rozbija się według story_navigation_action_type na TAP_FORWARD, TAP_BACK, TAP_EXIT i SWIPE_FORWARD. Metryki relacji są dostępne przez 24 godziny, wartości poniżej 5 zwracają błąd 10, a Instagram Login nie ma webhooka story_insights.

easyCoexistence odczytuje statystyki relacji przez get_social_insights, dopóki jest aktywna, więc Claude, ChatGPT lub Twój własny kod mogą zapytać, jak poszły dzisiejsze relacje, i dostać zasięg, wyświetlenia, odpowiedzi, udostępnienia i nawigację prosto od Meta dla połączonego konta.

24 hours

Jak długo metryki mediów relacji są dostępne przez API.

Error 10

Zwracane zamiast wartości, gdy metryka relacji jest poniżej 5: za mało widzów, by media pokazały statystyki.

Facebook Login

Jedyna konfiguracja webhooka story_insights, jaką podaje przewodnik Meta po statystykach; nie jest obsługiwana w Instagram Login.

0

Wartość odpowiedzi dla relacji utworzonej na koncie w Europie lub Japonii.

22 Jun 2026

Kiedy Meta dodała link_clicks dla relacji, liczący dotknięcia linków, np. naklejek z linkiem, tylko dla Facebook Login.

Jakie metryki zwraca relacja?

Te, które dokumentacja Meta wymienia dla media_product_type STORY, odczytywane przez GET /<STORY_MEDIA_ID>/insights, dopóki relacja jest aktywna. W Instagram Login wywołanie idzie pod adres graph.instagram.com z tokenem z uprawnieniami instagram_business_basic i instagram_business_manage_insights, a period zawsze ma wartość lifetime:

reachUnique accounts that saw the Story. Estimated.
viewsTimes the Story was played on Instagram. In development.
repliesReplies to the Story, with regional exceptions.
sharesTimes the Story was shared.
navigationActions taken from the Story: forward, back, exit and next Story.
followsFollows of the account, counted for the Story.
profile_visitsTimes the profile was visited.
profile_activityActions on the profile after engaging, by action_type.
repostsReposts, minus reposts later deleted.
total_interactionsInteractions on the Story, net of removals. In development.
facebook_viewsPlays where the Story was crossposted. Throws if it was not.

Jak odczytać nawigację według akcji?

Zapytaj o nawigację osobno z breakdown=story_navigation_action_type. Suma wraca w total_value.value, a każda akcja w total_value.breakdowns[].results, które sumują się do niej: TAP_FORWARD (Do przodu), TAP_BACK (Wstecz), TAP_EXIT (Wyjście) i SWIPE_FORWARD (Następna relacja). Przykładowa odpowiedź Meta zapisuje wartości małymi literami:

Navigation broken down by action, after Meta's sample
GET https://graph.instagram.com/<STORY_MEDIA_ID>/insights
  ?metric=navigation
  &breakdown=story_navigation_action_type
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "navigation",
      "period": "lifetime",
      "values": [{ "value": 25 }],
      "total_value": {
        "value": 25,
        "breakdowns": [
          {
            "dimension_keys": ["story_navigation_action_type"],
            "results": [
              { "dimension_values": ["tap_forward"], "value": 19 },
              { "dimension_values": ["tap_back"], "value": 4 },
              { "dimension_values": ["tap_exit"], "value": 1 },
              { "dimension_values": ["swipe_forward"], "value": 1 }
            ]
          }
        ]
      },
      "id": "<STORY_MEDIA_ID>/insights/navigation/lifetime"
    }
  ]
}

Jak długo metryki relacji są dostępne?

24 godziny. Meta udostępnia metryki mediów relacji tylko przez 24 godziny, czyli przez czas życia samej relacji, choć dane za nimi mogą opóźniać się nawet o 48 godzin. Odczytuj je według harmonogramu, gdy relacja jest aktywna, i zachowuj ostatnie otrzymane wartości. Meta zaznacza, że dane mogą nadal napływać po wygaśnięciu relacji, jeśli została dodana do wyróżnienia, a wtedy wywołania API, webhooki i aplikacja mogą pokazywać różne wyniki.

Dlaczego metryka relacji zwraca błąd 10?

Ponieważ jej wartość jest poniżej 5. Meta zwraca kod błędu 10 z komunikatem „(#10) Not enough viewers for the media to show insights” zamiast małej liczby, więc relacja oglądana przez niewielu może się nie udać, podczas gdy bardziej popularna się uda. Traktuj to jako niską liczbę, a nie awarię, i nie ponawiaj wywołania w pętli.

Dlaczego liczba odpowiedzi na relację wynosi 0?

Przez przepisy regionalne. Odpowiedzi od osób w Europie, od 1 grudnia 2020 roku, i w Japonii, od 14 kwietnia 2021 roku, są pomijane w metryce replies, więc relacja utworzona na koncie z jednego z tych regionów zwraca 0. Dokumentacja Meta definiuje replies jako IG Comments na obiekcie mediów relacji.

Czy istnieje webhook story_insights?

Nie w Instagram Login. Tabela pól Meta oznacza story_insights jako niedostępne tam, a dokumentacja statystyk mediów mówi, że webhook statystyk nie jest obsługiwany w Instagram Login. Przewodnik po statystykach wymienia story_insights tylko dla Facebook Login. W Facebook Login pole uruchamia się po wygaśnięciu relacji, zawiera tylko jej pierwsze 24 godziny metryk i zwraca liczby poniżej 5 jako -1.

Które metryki relacji są wycofane lub ograniczone?

Kilka nazw nadal pojawia się w starym kodzie albo w dzienniku zmian Meta:

  • impressions: wycofana dla mediów utworzonych po 2 lipca 2024 roku, więc aktualna relacja zgłasza zamiast tego views.
  • taps_forward, taps_back i exits: wycofane 11 grudnia 2023 roku; navigation, rozbita według story_navigation_action_type, zwraca te same akcje.
  • link_clicks: dotknięcia linków, takich jak naklejki z linkiem, dodane 22 czerwca 2026 roku tylko dla Facebook Login.
  • total_views: wyświetlenia na wszystkich powierzchniach, także przy promowanych mediach, dostępne tylko z Facebook Login.

Jak get_social_insights odczytuje relację?

Z identyfikatorem mediów relacji jako object_id, który publish_instagram_post zwraca jako media_id przy publikowaniu relacji, oraz metrykami jako listą. Nawigację pytaj w osobnym wywołaniu z params ustawionym na breakdown story_navigation_action_type, ponieważ nieobsługiwany przez jedną z metryk breakdown powoduje niepowodzenie całego wywołania. Błędy Meta, w tym błąd 10, są zwracane w brzmieniu, w jakim je podała Meta.

get_social_insights arguments for one Story
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<STORY_MEDIA_ID>",
  "metrics": ["reach", "views", "replies", "shares", "follows", "profile_visits"]
}

Typowe błędy

  • Odczytywanie metryk relacji dnia następnego. Meta udostępnia je tylko przez 24 godziny, więc zbieraj je, gdy relacja jest aktywna.
  • Ponawianie błędu 10 w pętli. Oznacza wartość poniżej 5, czyli za mało widzów, i nie zmieni się, dopóki relacji nie zobaczy więcej osób.
  • Pytanie o nawigację z breakdown obok innych metryk. story_navigation_action_type działa tylko z nawigacją, a nieobsługiwany breakdown psuje całe wywołanie.
  • Czekanie na story_insights przy Instagram Login. Meta nie oferuje tam tego webhooka, więc odpytuj endpoint statystyk, zanim relacja wygaśnie.
Z EasyCoexistence zrobisz to

Relacje publikuje publish_instagram_post. Od US$ 9 do US$ 0,75 za połączenie miesięcznie, z obniżką wraz z dodawaniem połączeń, z bezpłatnym okresem próbnym przez pierwsze 3 dni.

Najczęściej zadawane pytania

Czy statystyki relacji zmieniają się po dodaniu relacji do wyróżnienia?

Mogą. Meta mówi, że relacja dodana do wyróżnienia może nadal otrzymywać dane po wygaśnięciu, więc API, webhooki i aplikacja mogą przez jakiś czas się różnić.

Czy total_views działa dla relacji przy Instagram Login?

Nie. total_views, który liczy wyświetlenia na wszystkich powierzchniach, także przy promowanych mediach, jest dostępne tylko z Facebook Login; przy Instagram Login pytaj o views.

Czy API odczyta kliknięcia naklejki z linkiem w relacji na Instagramie?

Tylko z Facebook Login. Meta dodała link_clicks dla relacji 22 czerwca 2026 roku, liczący dotknięcia linków, takich jak naklejki z linkiem, i nie oferuje go w Instagram Login.

Co zastąpiło taps_forward, taps_back i exits?

navigation, rozbita według story_navigation_action_type na TAP_FORWARD, TAP_BACK, TAP_EXIT i SWIPE_FORWARD. Stare metryki wycofano 11 grudnia 2023 roku.

Czytaj dalej

Połącz pierwszy kanał w dwie minuty.

Bez czekania na weryfikację przez platformy. Połącz WhatsApp, Instagram, TikTok lub inny kanał, a potem poproś swoją AI o opublikowanie posta, odpowiedź lub raport i zobacz, jak działa.

  • 3 dni za darmo
  • Rezygnacja w każdej chwili
  • Tylko oficjalne API
  • Monitorowanie 24/7

Zweryfikowano w