Analyses

Un seul outil, get_insights, lit les chiffres que chaque réseau donne pour vos comptes : vues, portée, engagement, abonnés, vos meilleurs posts et le bon moment pour publier. Demandez avec vos mots : votre app d’IA choisit le rapport et le compte.

6réseaux avec des chiffres

8rapports dans un seul outil

365jours en arrière au plus, 89 pour les chiffres du compte

Lecture seulene publie et ne modifie jamais rien

Rapports

Votre app d’IA passe report ; overview est la valeur par défaut. Tous les réseaux n’ont pas tous les rapports : le tableau ci-dessous indique lesquels.

Vue d’ensembleoverview par défautVues, portée, engagement et abonnés sur les days derniers jours, dans les termes du réseau, plus un résumé commun à tous les réseaux. Sans account, tous les comptes avec des statistiques côte à côte.

Abonnésfollowers Le nombre d’abonnés jour par jour (d’abonnés à la chaîne sur YouTube), avec les abonnés gagnés et perdus.

Audienceaudience Les abonnés par pays et par ville, et par âge et genre quand le réseau les donne.

Meilleurs poststop_posts Vos meilleurs posts de la période, classés par engagement ou selon sort (vues, portée, j’aime, commentaires, partages, date). Sans account, sur tous les comptes avec des statistiques.

Meilleur moment pour publiertiming Les créneaux jour × heure qui marchent le mieux pour vos propres posts (en UTC), votre rythme de publication face à l’engagement obtenu, et la vitesse à laquelle vos posts atteignent leur pic. Instagram : quand vos abonnés sont en ligne.

Activité de la messagerieinbox Les messages reçus et envoyés, le délai médian avant une première réponse et les heures les plus chargées.

Mots-clés de recherchesearch_keywords Les recherches Google qui ont affiché votre fiche d’établissement, mois par mois.

Un postpost Les chiffres d’un post, par le post_id donné par list_posts, les meilleurs posts ou create_post. details: true ajoute sa courbe jour par jour et les extras du réseau.

Par réseau

Les rapports de chaque réseau, tirés du serveur en direct.

Rapport	Threads	TikTok	YouTube	Pinterest	Google Business Profile	Instagram Business
Vue d’ensemble overview
Abonnés followers	—				—
Audience audience	—			—	—
Meilleurs posts top_posts
Meilleur moment pour publier timing
Activité de la messagerie inbox	—	—	—	—	—
Mots-clés de recherche search_keywords	—	—	—	—		—
Un post post

Threads : les chiffres viennent de ses posts, pas du compte.Jusqu’à 365 jours en arrière ; les chiffres au niveau du compte s’arrêtent à 89 jours.LinkedIn, WhatsApp, Telegram, Instagram, Facebook et WordPress n’ont pas de chiffres ici.

Comment votre IA demande

Inutile de nommer les rapports. Demandez comme à un collègue ; votre app d’IA en fait un appel.

“Comment se sont passés mes réseaux ce mois-ci ?”get_insights({ report: "overview", days: 30 })
Tous les comptes avec des statistiques côte à côte, sur les 30 derniers jours.

“Quel TikTok a le mieux marché ?”get_insights({ report: "top_posts", provider: "tiktok" })
Vos posts TikTok, classés par engagement. Demandez les vues ou les partages et le classement suit.

“Quand publier sur Instagram ?”get_insights({ report: "timing", provider: "instagrambusiness" })
Les meilleurs créneaux jour × heure d’après vos propres posts, et quand vos abonnés sont en ligne.

Exemple

Ce que renvoie une vue d’ensemble de tous les comptes : les chiffres propres au réseau, et un résumé de même forme partout.

metricsLes chiffres tels que le réseau les nomme (reach, saves, page_media_view…), pour que rien ne se perde en route.

headlineviews, reach, engagement et followers sous la même forme sur chaque réseau ; null quand un réseau ne donne pas le chiffre.

sourceaccount quand le réseau donne des chiffres de compte ; posts quand ils sont additionnés à partir des posts du compte (Threads).

Le contenu texte commence par“Instagram Business (Northwind Studio): views 48,210, reach 12,480, engagement 2,876; Facebook Pages (Northwind Studio): views 21,340, reach 8,120, engagement 1,120, followers 3,420, followers gained 58, followers lost 9; Pinterest (Northwind Studio): views 30,900, engagement 1,460, followers 1,288, followers gained 41, followers lost 6.”

overview, tous les comptes

{
  "report": "overview",
  "from": "2026-10-11",
  "to": "2026-11-09",
  "accounts": [
    {
      "account_id": "e2c4a6b8-1d3f-4a5c-9e7b-2f4d6a8c0e13",
      "provider": "instagrambusiness",
      "name": "Northwind Studio",
      "source": "account",
      "metrics": {
        "reach": 12480,
        "views": 48210,
        "accounts_engaged": 1034,
        "total_interactions": 2876,
        "likes": 2310,
        "comments": 184,
        "saves": 212,
        "shares": 97,
        "profile_views": 1920,
        "website_clicks": 61
      },
      "headline": {
        "views": 48210,
        "reach": 12480,
        "engagement": 2876,
        "followers": null,
        "followers_gained": null,
        "followers_lost": null
      }
    },
    {
      "account_id": "f1a3c5e7-9b2d-4f6a-8c0e-5d7b9f1a3c48",
      "provider": "facebookpages",
      "name": "Northwind Studio",
      "source": "account",
      "metrics": {
        "page_media_view": 21340,
        "page_total_media_view_unique": 8120,
        "page_views_total": 640,
        "page_post_engagements": 1120,
        "page_video_views": 3010,
        "page_follows": 3420,
        "followers_gained": 58,
        "followers_lost": 9
      },
      "headline": {
        "views": 21340,
        "reach": 8120,
        "engagement": 1120,
        "followers": 3420,
        "followers_gained": 58,
        "followers_lost": 9
      }
    },
    {
      "account_id": "a4c6e8f0-2b4d-4f6a-9c1e-3d5f7b9a1c72",
      "provider": "pinterest",
      "name": "Northwind Studio",
      "source": "account",
      "metrics": {
        "impressions": 30900,
        "engagements": 1460,
        "saves": 380,
        "pin_clicks": 610,
        "outbound_clicks": 205,
        "follower_count": 1288,
        "followers_gained": 41,
        "followers_lost": 6
      },
      "headline": {
        "views": 30900,
        "reach": null,
        "engagement": 1460,
        "followers": 1288,
        "followers_gained": 41,
        "followers_lost": 6
      }
    }
  ]
}

L’outil

Exactement ce que votre app d’IA reçoit de tools/list.

Analyses1

get_insightsGet insights · LecturesLectures · 3 000/jourLecture

How an account is doing, as its network reports it (Instagram Business, TikTok, YouTube, Pinterest, Google Business Profile, Threads). report: overview (default): the account's figures over the last `days` (views, reach, engagement, followers… as the network reports them, plus a comparable headline); without account, every analytics account side by side; followers: the follower (YouTube: subscriber) count day by day, with gained and lost; audience: followers by country, city, age and gender, as far as the network reports them; top_posts: the best posts of the last `days` by `sort` (engagement by default), with their figures; without account, across every analytics account; timing: when to post, from the account's own posts (best weekday × hour slots in UTC, posts per week vs engagement, how fast posts reach their final engagement; Instagram: when followers are online); inbox: messages received and sent, median time to first reply and the busiest hours; search_keywords: the Google searches that showed the Business Profile, by month; post: one post's figures (post_id from list_posts, top_posts or create_post); details=true adds its day-by-day curve and the network's extras (Facebook earnings, YouTube retention and daily views). Not every network has every report (followers: Instagram Business, TikTok, YouTube, Pinterest; audience: Instagram Business, TikTok, YouTube; inbox: Instagram Business; search_keywords: Google Business Profile). LinkedIn, WhatsApp, Telegram and the personal Instagram and Facebook logins have no insights here. Read-only.

Autorisation View profilesLimite Lectures · 3 000/jour

Entrée9 paramètres · 0 obligatoire

account

string

account_id from list_accounts. Leave it out for overview or top_posts to cover every analytics account; the other reports need it when several are connected.

provider

enum

only this network's accounts (instead of account)

instagrambusinesstiktokyoutubepinterestgooglebusinessthreads

report

enum

par défaut : "overview"overviewfollowersaudiencetop_poststiminginboxsearch_keywordspost

days

integer

how many days back, ending today (account figures: at most 89)

par défaut : 301–365

post_id

string

report post: the post's post_id (or the scheduled_post_id create_post gave)

details

boolean

report post: also the day-by-day curve and the network's extras (more reads)

par défaut : false

sort

enum

report top_posts: what ranks the posts

par défaut : "engagement"engagementviewsreachlikescommentssharesdate

limit

integer

report top_posts: how many posts

par défaut : 101–25

cursor

string

report search_keywords: next_cursor from the previous page

SortiestructuredContent

{
  "report": "overview",
  "from": "2026-10-11",
  "to": "2026-11-09",
  "accounts": [
    {
      "account_id": "e2c4a6b8-1d3f-4a5c-9e7b-2f4d6a8c0e13",
      "provider": "instagrambusiness",
      "name": "Northwind Studio",
      "source": "account",
      "metrics": {
        "reach": 12480,
        "views": 48210,
        "accounts_engaged": 1034,
        "total_interactions": 2876,
        "likes": 2310,
        "comments": 184,
        "saves": 212,
        "shares": 97,
        "profile_views": 1920,
        "website_clicks": 61
      },
      "headline": {
        "views": 48210,
        "reach": 12480,
        "engagement": 2876,
        "followers": null,
        "followers_gained": null,
        "followers_lost": null
      }
    },
    {
      "account_id": "f1a3c5e7-9b2d-4f6a-8c0e-5d7b9f1a3c48",
      "provider": "facebookpages",
      "name": "Northwind Studio",
      "source": "account",
      "metrics": {
        "page_media_view": 21340,
        "page_total_media_view_unique": 8120,
        "page_views_total": 640,
        "page_post_engagements": 1120,
        "page_video_views": 3010,
        "page_follows": 3420,
        "followers_gained": 58,
        "followers_lost": 9
      },
      "headline": {
        "views": 21340,
        "reach": 8120,
        "engagement": 1120,
        "followers": 3420,
        "followers_gained": 58,
        "followers_lost": 9
      }
    },
    {
      "account_id": "a4c6e8f0-2b4d-4f6a-9c1e-3d5f7b9a1c72",
      "provider": "pinterest",
      "name": "Northwind Studio",
      "source": "account",
      "metrics": {
        "impressions": 30900,
        "engagements": 1460,
        "saves": 380,
        "pin_clicks": 610,
        "outbound_clicks": 205,
        "follower_count": 1288,
        "followers_gained": 41,
        "followers_lost": 6
      },
      "headline": {
        "views": 30900,
        "reach": null,
        "engagement": 1460,
        "followers": 1288,
        "followers_gained": 41,
        "followers_lost": 6
      }
    }
  ]
}

Le contenu texte commence par “Instagram Business (Northwind Studio): views 48,210, reach 12,480, engagement 2,876; Facebook Pages (Northwind Studio): views 21,340, reach 8,120, engagement 1,120, followers 3,420, followers gained 58, followers lost 9; Pinterest (Northwind Studio): views 30,900, engagement 1,460, followers 1,288, followers gained 41, followers lost 6.”

Peut refuser avecgaplimitcooldownpermission