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.
Jak długo dane za metrykami Instagrama mogą być opóźnione.
Poniżej tego progu konto nie otrzymuje danych o obserwacjach, odobserwowaniach ani demografii obserwujących.
Jak długo Meta przechowuje metryki mediów.
Jak długo metryki Stories pozostają dostępne przez API.
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_demographicsiengaged_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_interactionsi reposts. - Tylko Reels:
ig_reels_avg_watch_time,ig_reels_video_view_total_timeireels_skip_rate. - Posty i Stories: follows,
profile_visitsiprofile_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_unfollowsanifollower_demographics;engaged_audience_demographicswymaga 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.
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