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

Statystyki Instagrama przez API: metryki konta i postów

API Instagrama zwraca statystyki dla konta profesjonalnego oraz dla każdego jego posta, Reela i Stories. Metryki konta obejmują zasięg, wyświetlenia, konta z interakcją, obserwacje i odobserwowania, polubienia, komentarze, zapisania i udostępnienia. Metryki postów obejmują zasięg, wyświetlenia, polubienia, komentarze, zapisania i udostępnienia. Meta zaznacza, że dane mogą być opóźnione nawet o 48 godzin.

easyCoexistence odczytuje statystyki Instagrama przez get_social_insights, więc możesz zapytać Claude'a lub ChatGPT, jak poszły posty z zeszłego tygodnia, i otrzymać zasięg, wyświetlenia, polubienia, komentarze, zapisania i udostępnienia prosto z Meta, dla konta lub pojedynczego posta.

48 hours

Jak długo dane za metrykami Instagrama mogą być opóźnione.

100 followers

Poniżej tego progu konto nie otrzymuje danych o obserwacjach, odobserwowaniach ani demografii obserwujących.

2 years

Jak długo Meta przechowuje metryki mediów.

24 hours

Jak długo metryki Stories pozostają dostępne przez API.

21 Apr 2025

Kiedy impressions przestało działać we wszystkich wersjach API, z wyjątkiem mediów utworzonych przed 2 lipca 2024 r.; zastąpiły je views.

Które metryki konta są dostępne?

Odczytujesz je przez GET /<IG_ID>/insights, najczęściej z period=day i metric_type=total_value:

  • reach: unikalne konta, które zobaczyły treść, także z reklam; wartość szacunkowa.
  • views: liczba odtworzeń lub wyświetleń treści.
  • accounts_engaged: konta, które weszły w interakcję z treścią, także z reklam; wartość szacunkowa.
  • follows_and_unfollows: obserwacje i odobserwowania w okresie; wymaga co najmniej 100 obserwujących.
  • likes, comments, saves, shares, replies i reposts oraz total_interactions.
  • profile_links_taps: kliknięcia przycisków adresu firmy, połączenia, e-maila i wiadomości.
  • follower_demographics i engaged_audience_demographics: wiek, miasto, kraj i płeć.

Które metryki postów są dostępne?

Odczytujesz je przez GET /<IG_MEDIA_ID>/insights; które metryki obowiązują, zależy od formatu. Przy poście lub Reelu polubienia, komentarze, wyświetlenia i total_interactions liczą wyłącznie aktywność organiczną, bez zaangażowania w reklamy utworzone z tej treści.

  • Posty i Reels: reach, views, likes, comments, saved, shares, total_interactions i reposts.
  • Tylko Reels: ig_reels_avg_watch_time, ig_reels_video_view_total_time i reels_skip_rate.
  • Posty i Stories: follows, profile_visits i profile_activity.
  • Stories: reach, views, shares, replies, navigation, reposts i total_interactions.

Jak działają period, metric_type i podziały?

Metryki konta przyjmują period=day. metric_type=total_value zwraca jedną wartość za cały zakres i to ją wymagają podziały; time_series zwraca wartość za każdy dzień i jest dostępne dla reach. Podziały rozbijają sumę według media_product_type (posty, karuzele, Reels, Stories i reklamy), według follow_type (obserwujący lub nie) albo według contact_button_type.

Metryki demograficzne przyjmują przedział, np. this_week lub this_month, zamiast since i until. Bez since i until pozostałe metryki obejmują ostatnie 24 godziny. Prośba o podział, którego nie obsługuje jedna z żądanych metryk, kończy się dla całego żądania błędem unknown error.

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

Zasady Meta dotyczące tego, kiedy liczba się pojawia i jak długo pozostaje dostępna:

  • Dane mogą być opóźnione nawet o 48 godzin.
  • Konta z mniej niż 100 obserwującymi nie otrzymują follows_and_unfollows ani follower_demographics; engaged_audience_demographics wymaga 100 interakcji w przedziale czasowym.
  • Brakujące lub niedostępne dane wracają jako pusty zbiór, a nie jako 0.
  • Metryki demograficzne zwracają wyłącznie 45 najwyższych wartości.
  • Metryki konta są przechowywane do 90 dni, metryki mediów do 2 lat.

Czym różnią się Stories i karuzele?

Metryki Stories są dostępne tylko przez 24 godziny, a wartość poniżej 5 zwraca kod błędu 10, „not enough viewers”, zamiast liczby. Odpowiedzi od osób z Europy i Japonii są pomijane, a Story utworzone przez konto stamtąd pokazuje 0 odpowiedzi. Przy Instagram Login nie ma webhooka story_insights, więc liczby Stories trzeba odczytać, gdy Story jest aktywne.

Karuzela jest raportowana jako jeden post: Meta nie zwraca statystyk zdjęć ani filmów znajdujących się w jej środku.

Dlaczego nazwy metryk się zmieniają?

Ponieważ Meta wycofuje i zmienia nazwy metryk między wersjami API. impressions zostało oznaczone jako przestarzałe w v22.0 i przestało działać we wszystkich wersjach 21 kwietnia 2025 r., z wyjątkiem mediów utworzonych przed 2 lipca 2024 r.; w jego miejsce wprowadzono views. W tym samym czasie przestały działać plays, clips_replays_count i ig_reels_aggregated_all_plays_count. Wcześniej usunięto video_views oraz kilka szeregów czasowych profilu, w tym profile_views. Żądanie z wycofaną nazwą kończy się błędem, więc lista metryk napisana dla wcześniejszej wersji API może wymagać aktualizacji.

Typowe błędy

  • Wysyłanie żądania z impressions. Nie działa ono już w żadnej wersji API; zamiast tego poproś o views.
  • Traktowanie pustego wyniku jako zera. Meta zwraca pusty zbiór danych, gdy metryka jest niedostępna, a to nie to samo co brak aktywności.
  • Odczytywanie metryk Stories po zakończeniu Story. Są dostępne tylko przez 24 godziny.
  • Dodawanie podziału do żądania z kilkoma metrykami. Jeśli jedna z nich go nie obsługuje, całe wywołanie się nie udaje.
Z EasyCoexistence zrobisz to

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

Najczęściej zadawane pytania

Co zastąpiło impressions w API Instagrama?

views, które liczy, ile razy treść została odtworzona lub wyświetlona. Meta wycofała impressions we wszystkich wersjach API 21 kwietnia 2025 r., z wyjątkiem mediów utworzonych przed 2 lipca 2024 r.

Dlaczego moje konto nie zwraca danych o obserwujących?

Meta nie zwraca follows_and_unfollows ani demografii obserwujących dla kont z mniej niż 100 obserwującymi.

Jak daleko wstecz mogę odczytać statystyki Instagrama?

Do 90 dni metryk konta i do 2 lat metryk mediów, przy czym online_followers obejmuje tylko ostatnie 30 dni.

Czy liczby uwzględniają reklamy?

Częściowo. Zasięg konta i konta z interakcją obejmują reklamy, a polubienia, komentarze i wyświetlenia posta liczą wyłącznie aktywność organiczną.

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