Análises

Uma ferramenta, get_insights, lê os números que cada rede informa sobre suas contas: visualizações, alcance, engajamento, seguidores, seus melhores posts e quando postar. Peça com suas palavras: seu app de IA escolhe o relatório e a conta.

6redes com números

8relatórios em uma ferramenta

365dias para trás no máximo, 89 para os números da conta

Só leituranunca publica nem altera nada

Relatórios

Seu app de IA passa report; overview é o padrão. Nem toda rede tem todos os relatórios: a tabela abaixo mostra quais.

Visão geraloverview padrãoVisualizações, alcance, engajamento e seguidores nos últimos days dias, nos termos da própria rede, mais um resumo igual em todas as redes. Sem account, todas as contas com métricas lado a lado.

Seguidoresfollowers O número de seguidores dia a dia (inscritos no YouTube), com os seguidores ganhos e perdidos.

Públicoaudience Seguidores por país e cidade, e por idade e gênero quando a rede informa.

Melhores poststop_posts Seus melhores posts do período, ordenados por engajamento ou por sort (visualizações, alcance, curtidas, comentários, compartilhamentos, data). Sem account, em todas as contas com métricas.

Melhor horário para postartiming Os horários de dia da semana × hora que funcionam melhor para os seus próprios posts (em UTC), quantas vezes você posta comparado ao engajamento, e com que rapidez os posts chegam ao pico. Instagram: quando seus seguidores estão online.

Atividade da caixa de entradainbox Mensagens recebidas e enviadas, o tempo mediano até a primeira resposta e os horários de mais movimento.

Palavras-chave de buscasearch_keywords As buscas no Google que mostraram seu Perfil da Empresa, mês a mês.

Um postpost Os números de um post, pelo post_id de list_posts, dos melhores posts ou de create_post. details: true adiciona a curva dia a dia e os extras da rede.

Por rede

Quais relatórios cada rede tem, direto do servidor em produção.

Relatório	Threads	TikTok	YouTube	Pinterest	Google Business Profile	Instagram Business
Visão geral overview
Seguidores followers	—				—
Público audience	—			—	—
Melhores posts top_posts
Melhor horário para postar timing
Atividade da caixa de entrada inbox	—	—	—	—	—
Palavras-chave de busca search_keywords	—	—	—	—		—
Um post post

Threads: os números vêm dos posts, não da conta.Até 365 dias para trás; os números da conta param em 89 dias.LinkedIn, WhatsApp, Telegram, Instagram, Facebook e WordPress não têm números aqui.

Como sua IA pede

Você não precisa citar relatórios. Peça como pediria a um colega; seu app de IA transforma isso em uma chamada.

“Como foram minhas redes este mês?”get_insights({ report: "overview", days: 30 })
Todas as contas com métricas lado a lado, nos últimos 30 dias.

“Qual TikTok foi melhor?”get_insights({ report: "top_posts", provider: "tiktok" })
Seus posts do TikTok, ordenados por engajamento. Peça por visualizações ou compartilhamentos e a ordem muda.

“Quando devo postar no Instagram?”get_insights({ report: "timing", provider: "instagrambusiness" })
Os melhores horários de dia × hora a partir dos seus próprios posts, e quando seus seguidores estão online.

Exemplo

O que volta em uma visão geral de todas as contas: os números da própria rede e um resumo no mesmo formato em todas.

metricsOs números com os nomes que a rede usa (reach, saves, page_media_view…), para que nada se perca na tradução.

headlineviews, reach, engagement e followers no mesmo formato em todas as redes; null quando a rede não informa o número.

sourceaccount quando a rede informa números da conta; posts quando são somados a partir dos posts da conta (Threads).

O conteúdo de texto começa com“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, todas as contas

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

A ferramenta

Exatamente o que seu app de IA recebe de tools/list.

Análises1

get_insightsGet insights · LeiturasLeituras · 3.000/diaLeitura

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.

Permissão View profilesLimite Leituras · 3.000/dia

Entrada9 parâmetros · 0 obrigatórios

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

padrão: "overview"overviewfollowersaudiencetop_poststiminginboxsearch_keywordspost

days

integer

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

padrão: 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)

padrão: false

sort

enum

report top_posts: what ranks the posts

padrão: "engagement"engagementviewsreachlikescommentssharesdate

limit

integer

report top_posts: how many posts

padrão: 101–25

cursor

string

report search_keywords: next_cursor from the previous page

SaídastructuredContent

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

O conteúdo de texto começa com “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.”

Pode recusar comgaplimitcooldownpermission