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

Statystyki Reels w API Instagrama

Endpoint insights mediów Instagrama, GET /<IG_MEDIA_ID>/insights, zwraca dla Reela te metryki: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time i reels_skip_rate, a dla Reela opublikowanego krzyżowo także crossposted_views i facebook_views. Metryki plays, clips_replays_count i ig_reels_aggregated_all_plays_count zostały wycofane w kwietniu 2025 roku, a ich miejsce zajęły views.

easyCoexistence odczytuje insights Reela przez get_social_insights, więc Claude, ChatGPT lub Twój własny kod mogą zapytać, jak Reel sobie poradził, i otrzymać wyświetlenia, zasięg, czas oglądania i wskaźnik pominięć bezpośrednio z Meta dla połączonego konta, wraz z błędem Meta, gdy nazwa metryki jest wycofana.

3 seconds

Okres mierzony przez reels_skip_rate: udział wyświetleń, w których Reel został pominięty w ciągu pierwszych 3 sekund.

21 Apr 2025

Kiedy wycofano plays, clips_replays_count i ig_reels_aggregated_all_plays_count we wszystkich wersjach API.

3 Dec 2025

Kiedy dodano reels_skip_rate, reposts, crossposted_views i facebook_views do insights mediów.

48 hours

Jak długo dane, na których opierają się metryki mediów, mogą być opóźnione.

2 years

Jak długo Meta przechowuje metryki mediów.

Jakie metryki zwraca Reel?

Te, które referencja Meta dla insights mediów wymienia dla media_product_type REELS, odczytywane przez GET /<IG_MEDIA_ID>/insights z parametrem metric oddzielonym przecinkami. Meta oznacza kilka z nich jako szacunkowe lub w fazie rozwoju, co zaznaczono przy każdej, i liczy polubienia oraz komentarze wyłącznie jako aktywność organiczną:

viewsTimes the Reel was played on Instagram. In development.
reachUnique accounts that saw the Reel at least once. Estimated.
likesLikes on the Reel, organic only.
commentsComments on the Reel, organic only.
sharesTimes the Reel was shared.
savedTimes the Reel was saved.
repostsReposts, minus reposts later deleted.
total_interactionsLikes, saves, comments and shares, minus unlikes, unsaves and deleted comments. In development.
ig_reels_avg_watch_timeAverage time spent playing the Reel.
ig_reels_video_view_total_timeTotal time the Reel was played, replays included. In development.
reels_skip_rateShare of initial views that skipped within the first 3 seconds. Estimated, in development.
crossposted_viewsPlays across Instagram and where the Reel was crossposted, combined. Throws if it was not crossposted.
facebook_viewsPlays of the crossposted Reel outside Instagram. Throws if it was not crossposted.

Co zwraca żądanie insights dla Reels?

Jeden obiekt na metrykę w data, każdy z polami name, period, values, title, description i id. period zawsze ma wartość lifetime: ustawia ją Meta dla metryk mediów i nie można jej zmienić, więc żądanie jej nie potrzebuje. Referencja Meta opisuje dwie metryki czasu oglądania jako ilości czasu, bez podania jednostki, dlatego przed ich zestawieniem sprawdź je na Reelu, który znasz.

A Reels insights request and the shape of its answer
GET https://graph.instagram.com/<IG_MEDIA_ID>/insights
  ?metric=views,reach,ig_reels_avg_watch_time,reels_skip_rate
  &access_token=<INSTAGRAM_USER_ACCESS_TOKEN>

{
  "data": [
    {
      "name": "views",
      "period": "lifetime",
      "values": [{ "value": <VALUE> }],
      "title": "<TITLE>",
      "description": "<DESCRIPTION>",
      "id": "<IG_MEDIA_ID>/insights/views/lifetime"
    }
  ]
}

Które metryki Reels zostały wycofane i czym je zastąpiono?

Meta wycofała pierwsze trzy od Graph API v22.0 z 21 stycznia 2025 roku, tego samego dnia, w którym wprowadziła views, a we wszystkich wersjach 21 kwietnia 2025 roku. video_views zostało wycofane od v21.0, a we wszystkich wersjach od 8 stycznia 2025 roku. Żądanie nazywające wycofaną metrykę kończy się błędem, więc lista metryk napisana przed 2025 rokiem wymaga aktualizacji:

RetiredRequest instead
playsDeprecated in every version on 21 Apr 2025views
clips_replays_countDeprecated in every version on 21 Apr 2025views
ig_reels_aggregated_all_plays_countDeprecated in every version on 21 Apr 2025views
video_viewsDeprecated in every version on 8 Jan 2025views
impressionsNot in Meta's Reels list; returns an error for media created on or after 2 Jul 2024views

Co na Reelu liczą wyświetlenia i zasięg?

views to liczba odtworzeń Reela na Instagramie, metryka oznaczona przez Meta jako w fazie rozwoju. reach to liczba unikalnych kont, które zobaczyły go co najmniej raz, oznaczona jako szacunkowa. likes, comments, views i total_interactions liczą wyłącznie aktywność organiczną, bez zaangażowania w reklamy utworzone z Reela. total_likes, total_comments i total_views, które obejmują media promowane, są dostępne tylko przy Facebook Login.

Jakie limity i opóźnienia obowiązują?

Referencja Meta dotycząca insights mediów ustala dla liczb Reela następujące zasady:

  • Dane, na których opierają się metryki, mogą być opóźnione nawet o 48 godzin.
  • Metryki mediów są przechowywane do 2 lat.
  • Brakujące lub niedostępne dane zwracają pusty zbiór danych, a nie 0.
  • crossposted_views i facebook_views zgłaszają błąd dla Reela, który nie został opublikowany krzyżowo, dlatego wysyłaj je w osobnym wywołaniu.
  • Podział, którego nie obsługuje żądana metryka, kończy całe żądanie błędem An unknown error has occurred.
  • Przy Instagram Login token musi mieć uprawnienia instagram_business_basic i instagram_business_manage_insights, na graph.instagram.com.

Jak get_social_insights odczytuje Reel?

Z account_id połączenia, ID mediów Reela jako object_id i listą metryk. easyCoexistence wywołuje GET /<IG_MEDIA_ID>/insights na graph.instagram.com tokenem konta i przekazuje nazwy metryk do Meta bez zmian, zwracając dane Meta albo jej własny błąd, gdy nazwa jest wycofana. list_social_posts zwraca identyfikatory mediów ostatnich postów i Reels konta.

get_social_insights arguments for one Reel
{
  "account_id": "<ACCOUNT_ID>",
  "object_id": "<REEL_MEDIA_ID>",
  "metrics": [
    "views", "reach", "likes", "comments", "shares", "saved",
    "total_interactions", "ig_reels_avg_watch_time",
    "ig_reels_video_view_total_time", "reels_skip_rate"
  ]
}

Typowe błędy

  • Żądanie plays lub clips_replays_count. Obie wycofano we wszystkich wersjach API 21 kwietnia 2025 roku; zamiast nich pytaj o views.
  • Dodawanie crossposted_views lub facebook_views do ogólnego żądania. Zgłaszają błąd dla Reela, który nie został opublikowany krzyżowo, a błąd kończy całe wywołanie.
  • Zakładanie jednostki dla czasu oglądania. Meta nie podaje żadnej dla ig_reels_avg_watch_time ani ig_reels_video_view_total_time, więc sprawdź je na znanym Reelu.
  • Traktowanie pustego wyniku jako zera. Meta zwraca pusty zbiór danych, gdy dane nie istnieją lub są chwilowo niedostępne.
Z EasyCoexistence zrobisz to

Od US$ 9 do US$ 0.75 za połączenie miesięcznie, z obniżką w miarę dodawania połączeń, z pierwszymi 3 dniami bezpłatnie.

Najczęściej zadawane pytania

Dlaczego żądanie insights Reels zwraca pusty wynik?

Meta zwraca pusty zbiór danych, a nie 0, gdy dane nie istnieją lub są chwilowo niedostępne, a dane, na których opierają się metryki, mogą mieć opóźnienie do 48 godzin.

Jak pobrać czas oglądania Reels z API?

Zażądaj ig_reels_avg_watch_time dla średniej i ig_reels_video_view_total_time dla całości, łącznie z powtórkami, z GET /<IG_MEDIA_ID>/insights.

Czym jest reels_skip_rate?

Procentem początkowych wyświetleń, w których Reel został pominięty w ciągu pierwszych 3 sekund. Meta dodała ją 3 grudnia 2025 roku i oznacza jako szacunkową i w fazie rozwoju.

Czy insights Reels obejmują wyświetlenia reklam?

Nie. likes, comments, views i total_interactions liczą wyłącznie aktywność organiczną; total_views, które obejmuje media promowane, jest dostępne tylko przy Facebook Login.

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