Kirjaudu sisäänAloita ilmainen kokeilu
easyCoexistence Viralliset API:t

Instagram Reels -insightit API:n kautta

Instagramin media insights -päätepiste, GET /<IG_MEDIA_ID>/insights, palauttaa Reelille nämä mittarit: views, reach, likes, comments, shares, saved, reposts, total_interactions, ig_reels_avg_watch_time, ig_reels_video_view_total_time ja reels_skip_rate sekä ristiinjulkaistulle Reelille crossposted_views ja facebook_views. plays, clips_replays_count ja ig_reels_aggregated_all_plays_count poistettiin huhtikuussa 2025, ja niiden tilalle tuli views.

easyCoexistence lukee Reelin insightit get_social_insights-työkalulla, joten Claude, ChatGPT tai oma koodisi voi kysyä, miten Reel menestyi, ja saa katselut, tavoittavuuden, katseluajan ja ohituslukuasteen suoraan Metalta yhdistetylle tilille.

3 seconds

reels_skip_rate mittaa niiden katselujen osuuden, joissa Reel ohitettiin sen ensimmäisten 3 sekunnin aikana.

21 Apr 2025

Milloin plays, clips_replays_count ja ig_reels_aggregated_all_plays_count poistettiin käytöstä kaikissa API-versioissa.

3 Dec 2025

Milloin reels_skip_rate, reposts, crossposted_views ja facebook_views lisättiin media insights -tietoihin.

48 hours

Kuinka paljon media-mittareiden taustalla oleva data voi viivästyä.

2 years

Kuinka kauan Meta tallentaa media-mittarit.

Mitä mittareita Reel palauttaa?

Ne, jotka Metan media insights -viite listaa media_product_type-arvolle REELS. Ne luetaan GET /<IG_MEDIA_ID>/insights -pyynnöllä, jossa metric-parametri on pilkulla erotettu lista. Meta merkitsee useat niistä arvioiduiksi tai kehitteillä oleviksi, kuten kunkin kohdalla mainitaan, ja laskee tykkäykset ja kommentit vain orgaaniseksi toiminnaksi:

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.

Mitä Reelsin insights-pyyntö palauttaa?

Yhden objektin jokaista mittaria kohden data-kentässä, jossa on name, period, values, title, description ja id. period on aina lifetime: Meta asettaa sen media-mittareille eikä sitä voi muuttaa, joten pyyntö ei tarvitse sitä. Metan viite kuvaa kahta katseluaikamittaria aikamääränä ilman yksikköä, joten tarkista ne tunnetulla Reelillä ennen kuin piirrät niistä kaavioita.

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"
    }
  ]
}

Mitkä Reels-mittarit poistettiin ja mikä korvasi ne?

Meta poisti kolme ensimmäistä Graph API:n versiosta 22.0 alkaen 21. tammikuuta 2025, sinä päivänä kun se otti käyttöön views-mittarin, ja kaikissa versioissa 21. huhtikuuta 2025 alkaen. video_views poistui versiosta v21.0 alkaen ja kaikissa versioissa 8. tammikuuta 2025. Pyyntö, joka nimeää poistuneen mittarin, epäonnistuu, joten ennen vuotta 2025 kirjoitettu mittarilista täytyy päivittää:

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

Mitä views ja reach laskevat Reelillä?

views on kertojen määrä, joina Reel toistettiin Instagramissa, ja Meta merkitsee tämän mittarin kehitteillä olevaksi. reach on niiden uniikkien tilien määrä, jotka näkivät Reelin vähintään kerran, ja Meta merkitsee sen arvioiduksi. likes, comments, views ja total_interactions laskevat vain orgaanista toimintaa, eikä niihin sisälly Reelistä tehtyjen mainosten vuorovaikutusta. total_likes, total_comments ja total_views, jotka sisältävät mainostettua mediaa, ovat saatavilla vain Facebook Login -kirjautumisen kanssa.

Mitkä rajoitukset ja viiveet koskevat?

Metan media insights -viite asettaa Reelin lukuihin nämä säännöt:

  • Mittareiden taustalla oleva data voi viivästyä jopa 48 tuntia.
  • Media-mittareita säilytetään jopa 2 vuotta.
  • Puuttuva tai tällä hetkellä saamaton data palauttaa tyhjän data-joukon, ei nollaa.
  • crossposted_views ja facebook_views heittävät virheen Reelille, jota ei ristiinjulkaistu, joten pyydä ne omassa kutsussaan.
  • Erittely, jota pyydetty mittari ei tue, epäonnistuttaa koko pyynnön virheellä: An unknown error has occurred.
  • Instagram Loginilla tokenin täytyy sisältää instagram_business_basic ja instagram_business_manage_insights, ja pyynnöt menevät osoitteeseen graph.instagram.com.

Miten get_social_insights lukee Reelin?

Yhteyden account_id-kentällä, Reelin media-ID:llä object_id-kentässä ja mittarilistalla. easyCoexistence kutsuu graph.instagram.comissa GET /<IG_MEDIA_ID>/insights -päätepistettä tilin tokenilla, välittää mittarien nimet Metalle sellaisinaan ja palauttaa Metan datan tai Metan oman virheen, kun nimi on poistunut. list_social_posts palauttaa tilin viimeaikaisten julkaisujen ja Reelien media-ID:t.

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"
  ]
}

Yleiset virheet

  • Plays- tai clips_replays_count-mittarin pyytäminen. Molemmat poistettiin käytöstä kaikissa API-versioissa 21. huhtikuuta 2025; pyydä views.
  • crossposted_views tai facebook_views lisääminen yleiseen pyyntöön. Ne heittävät virheen Reelille, jota ei ristiinjulkaistu, ja virhe epäonnistuttaa kutsun.
  • Katseluajan yksikön olettaminen. Meta ei nimeä yksikköä ig_reels_avg_watch_time- eikä ig_reels_video_view_total_time-mittarille, joten tarkista tunnetulla Reelillä.
  • Tyhjän tuloksen lukeminen nollana. Meta palauttaa tyhjän data-joukon, kun dataa ei ole tai se ei ole tällä hetkellä saatavilla.
Näin teet tämän EasyCoexistencen avulla

Kun metric-nimi on poistunut, saat Metan oman virheen. US$ 9:stä US$ 0.75:een per yhteys kuukaudessa, hinnan laskiessa yhteyksien lisääntyessä. Ensimmäiset 3 päivää ovat ilmainen kokeilu.

Usein kysytyt kysymykset

Miksi Reels-insights-pyyntö palauttaa tyhjän tuloksen?

Meta palauttaa tyhjän data-joukon, ei nollaa, kun dataa ei ole tai se ei ole tällä hetkellä saatavilla. Mittareiden taustalla oleva data voi lisäksi viivästyä jopa 48 tuntia.

Miten saan Reelsin katseluajan API:sta?

Pyydä ig_reels_avg_watch_time keskiarvolle ja ig_reels_video_view_total_time kokonaisajalle, toistot mukaan lukien, GET /<IG_MEDIA_ID>/insights -päätepisteestä.

Mikä on reels_skip_rate?

Prosenttiosuus alkuperäisistä katselukerroista, joissa Reel ohitettiin sen ensimmäisten 3 sekunnin aikana. Meta lisäsi sen 3. joulukuuta 2025 ja merkitsee sen arvioiduksi ja kehitteillä olevaksi.

Sisältävätkö Reels-insightit mainosnäyttökerrat?

Eivät. likes, comments, views ja total_interactions laskevat vain orgaanista toimintaa. total_views, johon sisältyy mainostettua mediaa, on saatavilla vain Facebook Login -kirjautumisen kanssa.

Lue lisää

Yhdistä ensimmäinen kanavasi kahdessa minuutissa.

Ei alustojen tarkastuksia odotettavana. Yhdistä WhatsApp, Instagram, TikTok tai jokin muu kanava, pyydä sitten tekoälyäsi julkaisemaan, vastaamaan tai raportoimaan ja seuraa, kun se hoitaa homman.

  • 3 päivää ilmaiseksi
  • Peruuta milloin tahansa
  • Vain viralliset API:t
  • Valvottu 24/7

Vahvistettu