PluggzyDocs

Analíticas

Una sola herramienta, get_insights, lee las cifras que cada red reporta de tus cuentas: vistas, alcance, interacción, seguidores, tus mejores publicaciones y cuándo publicar. Pregunta con tus propias palabras: tu app de IA elige el informe y la cuenta.

7redes con cifras
8informes en una herramienta
365días atrás como máximo, 89 para las cifras de la cuenta
Solo lecturanunca publica ni cambia nada

Informes

Tu app de IA pasa report; overview es el predeterminado. No todas las redes tienen todos los informes: la tabla de abajo indica cuáles.

Resumenoverview predeterminadoVistas, alcance, interacción y seguidores en los últimos days, con los términos de cada red más un resumen común a todas. Sin account, todas las cuentas con analíticas lado a lado.
Seguidoresfollowers El número de seguidores día a día (suscriptores en YouTube), con los seguidores ganados y perdidos.
Audienciaaudience Seguidores por país y ciudad, y por edad y género cuando la red lo reporta.
Mejores publicacionestop_posts Tus mejores publicaciones del periodo, ordenadas por interacción o por sort (vistas, alcance, me gusta, comentarios, compartidos, fecha). Sin account, en todas las cuentas con analíticas.
Mejor hora para publicartiming Los días de la semana y franjas horarias que mejor funcionan para tus publicaciones (en UTC), con qué frecuencia publicas frente a la interacción que recibes y lo rápido que llegan a su pico. Instagram: cuándo están conectados tus seguidores.
Actividad de la bandejainbox Mensajes recibidos y enviados, la mediana del tiempo hasta la primera respuesta y las horas de más actividad.
Palabras clave de búsquedasearch_keywords Las búsquedas de Google que mostraron tu Perfil de Empresa, mes a mes.
Una publicaciónpost Las cifras de una publicación, por el post_id de list_posts, de las mejores publicaciones o de create_post. details: true añade su curva día a día y los datos extra de la red.

Por red

Qué informe tiene cada red, según el servidor en vivo.

CanalResumenSeguidoresAudienciaMejores publicacionesMejor hora para publicarActividad de la bandejaPalabras clave de búsquedaUna publicación
Threads4 informes————
TikTok6 informes——
YouTube6 informes——
Pinterest5 informes———
Google Business Profile5 informes———
Instagram Business7 informes—
LinkedIn Pages5 informes———
8 columnas · desliza la tabla
  • Threads: las cifras vienen de sus publicaciones, no de la cuenta.
  • Hasta 365 días atrás; las cifras de la cuenta llegan hasta 89 días.
  • LinkedIn, WhatsApp, Telegram, Instagram, Facebook y WordPress no tienen cifras aquí.

Cómo pregunta tu IA

No tienes que nombrar informes. Pregunta como le preguntarías a un colega; tu app de IA lo convierte en una llamada.

“¿Cómo les fue a mis redes este mes?”get_insights({ report: "overview", days: 30 })
Todas las cuentas con analíticas lado a lado, en los últimos 30 días.
“¿Qué TikTok funcionó mejor?”get_insights({ report: "top_posts", provider: "tiktok" })
Tus publicaciones de TikTok, ordenadas por interacción. Pide vistas o compartidos y las ordena por eso.
“¿Cuándo debería publicar en Instagram?”get_insights({ report: "timing", provider: "instagrambusiness" })
Los mejores días y horas según tus propias publicaciones, y cuándo están conectados tus seguidores.
Solo lecturaget_insights lee lo que reporta cada red y nunca publica, da me gusta ni cambia nada. Necesita el permiso View profiles.

Ejemplo

Lo que devuelve un resumen de todas las cuentas: las cifras propias de cada red y un resumen con la misma forma en todas.

metricsLas cifras con el nombre que les da la red (reach, saves, page_media_view…), para que nada se pierda en la traducción.
headlinevistas, alcance, interacción y seguidores con la misma forma en todas las redes; null cuando una red no lo reporta.
sourceaccount cuando la red reporta cifras de la cuenta; posts cuando se suman a partir de las publicaciones de la cuenta (Threads).
El contenido de texto empieza con“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 las cuentas
{
  "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
      }
    }
  ]
}

La herramienta

Exactamente lo que tu app de IA recibe de tools/list.

1 herramienta · 1 de lectura · 0 de escritura
Analíticas1

How an account is doing, as its network reports it (Instagram Business, LinkedIn Pages, 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, LinkedIn Pages, TikTok, YouTube, Pinterest; audience: Instagram Business, TikTok, YouTube; inbox: Instagram Business; search_keywords: Google Business Profile). The personal LinkedIn, WhatsApp, Telegram and the personal Instagram and Facebook logins have no insights here. Read-only.

Permiso View profilesLímite Lecturas · 3000/día
Entrada9 parámetros · 0 obligatorios
accountstring
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.
providerenum
only this network's accounts (instead of account)
instagrambusinesslinkedinpagestiktokyoutubepinterestgooglebusinessthreads
reportenum
por defecto "overview"overviewfollowersaudiencetop_poststiminginboxsearch_keywordspost
daysinteger
how many days back, ending today (account figures: at most 89)
por defecto 301–365
post_idstring
report post: the post's post_id (or the scheduled_post_id create_post gave)
detailsboolean
report post: also the day-by-day curve and the network's extras (more reads)
por defecto false
sortenum
report top_posts: what ranks the posts
por defecto "engagement"engagementviewsreachlikescommentssharesdate
limitinteger
report top_posts: how many posts
por defecto 101–25
cursorstring
report search_keywords: next_cursor from the previous page
SalidastructuredContent
{
  "structuredContent": {
    "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
        }
      }
    ]
  },
  "content": [
    {
      "type": "text",
      "text": "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."
    }
  ]
}
Qué hizo el filtroEjemplo09:41:02 → 09:41:03
  1. Recibida09:41:02
  2. Dentro de los límites840 de 3000 hoy
  3. Enviada09:41:03
Lecturas hoy: 840 de 3000 usados · se reinicia a las 00:00 UTC
El contenido de texto empieza con “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.” · Puede rechazar congaplimitcooldownpermission
Generado desde pluggzy.com/api/docs · 42 herramientas¿Algo no está claro? Escribe a soporte · Estado del servicio