Conectați-văÎncepeți perioada de probă gratuită
easyCoexistence API-uri oficiale

Statistici Instagram prin API: metrici pentru cont și postări

API-ul Instagram returnează statistici pentru un cont profesional și pentru fiecare dintre postările, Reel-urile și Story-urile acestuia. Metricile contului includ acoperirea, vizualizările, conturile implicate, urmăririle și anulările urmăririi, aprecierile, comentariile, salvările și distribuirile. Metricile postărilor includ acoperirea, vizualizările, aprecierile, comentariile, salvările și distribuirile. Meta precizează că datele pot întârzia până la 48 de ore.

easyCoexistence citește statisticile Instagram cu get_social_insights, astfel încât puteți întreba Claude sau ChatGPT cum au mers postările din săptămâna trecută și primiți acoperirea, vizualizările, aprecierile, comentariile, salvările și distribuirile direct de la Meta, pentru cont sau pentru o singură postare.

48 hours

Cât de mult pot întârzia datele din spatele metricilor Instagram.

100 followers

Sub acest prag, follows și unfollows, precum și demografia urmăritorilor, nu sunt returnate pentru cont.

2 years

Cât timp stochează Meta metricile media.

24 hours

Cât timp rămân disponibile metricile Story prin API.

21 Apr 2025

Când impressions a încetat să funcționeze în toate versiunile API, cu excepția conținutului creat înainte de 2 iulie 2024; views l-a înlocuit.

Ce metrici ale contului sunt disponibile?

Se citesc cu GET /<IG_ID>/insights, de regulă cu period=day și metric_type=total_value:

  • reach: conturi unice care au văzut conținutul, inclusiv reclamele; estimat.
  • views: de câte ori conținutul a fost redat sau afișat.
  • accounts_engaged: conturi care au interacționat cu conținutul, inclusiv reclamele; estimat.
  • follows_and_unfollows: urmăriri și anulări ale urmăririi în perioadă; necesită cel puțin 100 de urmăritori.
  • likes, comments, saves, shares, replies și reposts, la care se adaugă total_interactions.
  • profile_links_taps: atingerile butoanelor pentru adresa firmei, apel, e-mail și mesaj.
  • follower_demographics și engaged_audience_demographics: vârsta, orașul, țara și genul.

Ce metrici ale postărilor sunt disponibile?

Se citesc cu GET /<IG_MEDIA_ID>/insights; metricile care se aplică depind de format. Pentru o postare sau un Reel, aprecierile, comentariile, vizualizările și total_interactions numără doar activitatea organică, nu interacțiunile cu reclamele făcute din ea.

  • Postări și Reel-uri: acoperire, vizualizări, aprecieri, comentarii, saved, shares, total_interactions și reposts.
  • Doar Reel-uri: ig_reels_avg_watch_time, ig_reels_video_view_total_time și reels_skip_rate.
  • Postări și Story-uri: follows, profile_visits și profile_activity.
  • Story-uri: acoperire, vizualizări, shares, replies, navigare, reposts și total_interactions.

Cum funcționează period, metric_type și defalcările?

Metricile contului primesc period=day. metric_type=total_value returnează o singură cifră pentru interval și este cea de care au nevoie defalcările; time_series returnează o valoare pe zi și este disponibil pentru reach. Defalcările împart un total după media_product_type (postări, carusele, Reel-uri, Story-uri și reclame), după follow_type (urmăritori sau nu) sau după contact_button_type.

Metricile demografice primesc un timeframe precum this_week sau this_month, în locul lui since și until, iar fără since și until celelalte metrici se referă la ultimele 24 de ore. O cerere cu o defalcare pe care una dintre metricile solicitate nu o acceptă eșuează în întregime, cu o eroare necunoscută.

Ce praguri și întârzieri se aplică?

Regulile Meta pentru momentul în care apare o cifră și cât timp rămâne disponibilă:

  • Datele pot întârzia până la 48 de ore.
  • Conturile cu sub 100 de urmăritori nu primesc follows_and_unfollows sau follower_demographics; engaged_audience_demographics necesită 100 de interacțiuni în interval.
  • Datele lipsă sau indisponibile revin ca set gol, nu ca 0.
  • Metricile demografice returnează doar primele 45 de valori.
  • Metricile contului sunt stocate până la 90 de zile, iar metricile media până la 2 ani.

Ce este diferit pentru Story-uri și carusele?

Metricile Story sunt disponibile doar 24 de ore, iar o valoare sub 5 returnează codul de eroare 10 (prea puțini spectatori), în locul unui număr. Răspunsurile de la persoane din Europa și Japonia sunt excluse, iar un Story creat de un cont de acolo raportează 0 răspunsuri. Cu Instagram Login nu există webhook-ul story_insights, deci cifrele Story trebuie citite cât timp Story-ul este activ.

Un carusel se raportează ca o singură postare: Meta nu returnează statistici pentru fotografiile și videoclipurile din el.

De ce se schimbă numele metricilor?

Pentru că Meta retrage și redenumește metrici între versiunile API. impressions a fost depreciat pentru v22.0 și a încetat să funcționeze în toate versiunile pe 21 aprilie 2025, cu excepția conținutului creat înainte de 2 iulie 2024, iar în locul lui a fost introdus views; plays, clips_replays_count și ig_reels_aggregated_all_plays_count au dispărut în același timp. video_views și mai multe serii de timp de profil, printre care profile_views, fuseseră eliminate mai devreme. O cerere cu un nume retras eșuează, așa că o listă de metrici scrisă pentru o versiune anterioară a API-ului poate necesita actualizare.

Greșeli frecvente

  • Solicitarea impressions. Nu mai funcționează în nicio versiune API; cereți în schimb views.
  • Tratarea unui rezultat gol ca zero. Meta returnează un set de date gol când o metrică este indisponibilă, ceea ce nu înseamnă lipsă de activitate.
  • Citirea metricilor Story după ce Story-ul s-a încheiat. Sunt disponibile doar 24 de ore.
  • Adăugarea unei defalcări la o cerere pentru mai multe metrici. Dacă una dintre ele nu o acceptă, apelul întreg eșuează.
Faceți acest lucru cu EasyCoexistence

De la US$ 9 la US$ 0.75 pe conexiune pe lună, scăzând pe măsură ce adăugați conexiuni, cu perioadă de probă gratuită de 3 zile.

Întrebări frecvente

Ce a înlocuit impressions în API-ul Instagram?

views, care numără de câte ori conținutul a fost redat sau afișat. Meta a retras impressions din toate versiunile API pe 21 aprilie 2025, cu excepția conținutului creat înainte de 2 iulie 2024.

De ce contul meu nu returnează date despre urmăritori?

Meta nu returnează follows_and_unfollows sau demografia urmăritorilor pentru conturile cu mai puțin de 100 de urmăritori.

Cât de în urmă pot citi statisticile Instagram?

Până la 90 de zile pentru metricile contului și până la 2 ani pentru metricile media, iar online_followers acoperă doar ultimele 30 de zile.

Cifrele includ reclamele?

Parțial. Acoperirea și conturile implicate ale unui cont includ reclamele, în timp ce aprecierile, comentariile și vizualizările unei postări numără doar activitatea organică.

Continuați să citiți

Conectați primul canal în două minute.

Fără recenzii de platformă de așteptat. Conectați WhatsApp, Instagram, TikTok sau alt canal, apoi cereți AI-ului să publice, să răspundă sau să raporteze și urmăriți-l cum lucrează.

  • 3 zile gratuit
  • Anulați oricând
  • Doar API-uri oficiale
  • Monitorizat 24/7

Verificat la