Saltar al contenido
Automatización y agentes

Estadísticas de tus Reels de Instagram en un archivo, cada día y con la API oficial

Actualizado el 9 min de lectura

Lo esencial

  • Un programa de unas 75 líneas pide a la API oficial de Instagram las cifras de cada Reel y las guarda en un archivo que se abre con Excel o Google Sheets.
  • Recoge vistas, alcance, guardados, compartidos, segundos vistos y el porcentaje de gente que salta el Reel en los tres primeros segundos.
  • Necesita el permiso instagram_manage_insights. Instagram puede tardar hasta 48 horas en actualizar una cifra.
  • Cuesta cero. Nivel: intermedio. Una hora la primera vez, casi toda en el panel de Meta.

La app de Instagram te enseña las estadísticas de cada Reel, pero de una en una y sin historial. Para saber qué gancho o qué formato te funciona mejor necesitas verlas todas juntas, y cómo cambian con los días. Hacerlo a mano cada mañana no dura ni una semana.

Esta guía monta un programa que lo hace solo: pregunta a la API oficial de Instagram por cada Reel de tu cuenta, guarda las cifras en un archivo y escribe un resumen ordenado por vistas. Es una versión reducida del que usa Ctrl+IA para decidir qué publicar.

Qué necesitas

  • Una cuenta de Instagram profesional (de creador o de empresa), conectada a una página de Facebook. La variante de la API que usa esta guía entra por Facebook.
  • Una app de Meta propia, gratuita, en developers.facebook.com/apps. Si ya montaste los mensajes automáticos a quien comenta, te sirve la misma.
  • Una clave con estos permisos: instagram_basic, pages_read_engagement e instagram_manage_insights. El último es el de las estadísticas; sin él solo hay “me gusta” y comentarios. Si tu usuario tiene además un rol en el Business Manager de la página, la referencia oficial de las estadísticas (consultada el 21 de octubre de 2026) pide también ads_management y ads_read.
  • Python 3. El programa no usa ninguna biblioteca externa.
  • Tiempo: una hora la primera vez, casi toda en el panel de Meta. Después, nada.
  • Dinero: nada. La API no cobra por este uso.

Qué cifras da Instagram

La referencia oficial de las estadísticas de una publicación, consultada el 13 de octubre de 2026, lista estas para los Reels. Son las que recoge el programa:

Cifra Nombre en la API Qué es, según Meta
Vistas views Las veces que se reprodujo. Meta la marca como “en desarrollo”.
Alcance reach Las cuentas distintas que lo vieron al menos una vez. Es una estimación.
Guardados saved Las veces que alguien lo guardó.
Compartidos shares Las veces que se compartió.
“Me gusta” y comentarios likes, comments Lo que parece.
Tiempo medio visto ig_reels_avg_watch_time Cuánto tiempo, de media, se reprodujo.
Lo saltan en 3 segundos reels_skip_rate La parte de las vistas en que la gente pasó al siguiente en los tres primeros segundos. Estimación y “en desarrollo”.

Tres avisos de la misma página:

  • Los datos pueden llegar con hasta 48 horas de retraso. Un Reel de ayer no tiene todavía sus cifras de verdad.
  • Si no hay dato, la API no responde cero: responde vacío. El programa lo deja en blanco.
  • Las cifras se guardan hasta dos años.

Cómo funciona

El programa hace tres cosas cada vez que se ejecuta:

  1. Pide la lista de publicaciones de tu cuenta y se queda con los Reels. Cada publicación dice dónde se publicó en el campo media_product_type, que vale REELS para un Reel, según la referencia de las publicaciones (consultada el 13 de octubre de 2026). Ese campo solo existe en la variante con inicio de sesión de Facebook.
  2. Pide las estadísticas de cada Reel. Si una cifra falla, las vuelve a pedir una a una y guarda las que lleguen: así una cifra “en desarrollo” no tumba las demás.
  3. Añade una fila por Reel a metricas.csv, con la fecha de la consulta, y reescribe resumen.md.

El archivo .csv es el historial: cada día suma filas nuevas, y así ves cómo crece cada Reel. Se abre con Excel o se importa en Google Sheets.

Paso 1 · La clave

  1. En el Explorador de la API Graph de Meta (menú “Herramientas”), genera una clave de usuario con los tres permisos de arriba.
  2. Al autorizar, marca solo la página y la cuenta de Instagram que quieres medir.
  3. Pide tus páginas (me/accounts). De la respuesta salen la clave de la página (access_token) y, añadiendo el campo instagram_business_account, el identificador de tu cuenta de Instagram.

Las dos van en variables de entorno, INSTAGRAM_ACCESS_TOKEN e INSTAGRAM_USER_ID, nunca escritas en el código. El programa solo lee: no publica, no responde y no borra nada.

Paso 2 · El programa

Guárdalo como metricas_reels.py:

"""Recoge las cifras de tus Reels de Instagram y escribe un resumen en Markdown."""
import csv, json, os, statistics, urllib.error, urllib.parse, urllib.request
from datetime import date, datetime

API = "https://graph.facebook.com/v25.0"
CLAVE = os.environ["INSTAGRAM_ACCESS_TOKEN"]  # la clave de tu página de Facebook
CUENTA = os.environ["INSTAGRAM_USER_ID"]      # el identificador de tu cuenta de Instagram
CIFRAS = ["views", "reach", "saved", "shares", "likes", "comments", "ig_reels_avg_watch_time", "reels_skip_rate"]
DIAS_ASENTADO = 3  # un Reel más nuevo todavía está sumando vistas


def llamar(ruta, **consulta):
    url = f"{API}/{ruta}?{urllib.parse.urlencode(consulta)}"
    peticion = urllib.request.Request(url, headers={"Authorization": f"Bearer {CLAVE}"})
    with urllib.request.urlopen(peticion) as respuesta:
        return json.load(respuesta)


def cifras_de(reel):
    def pedir(nombres):
        datos = llamar(f"{reel}/insights", metric=",".join(nombres))["data"]
        return {d["name"]: d["values"][0]["value"] for d in datos if d.get("values")}
    try:
        return pedir(CIFRAS)
    except urllib.error.HTTPError:
        # Si una cifra falla, se piden una a una y se guarda lo que haya.
        cifras = {}
        for nombre in CIFRAS:
            try:
                cifras.update(pedir([nombre]))
            except urllib.error.HTTPError:
                print("Sin dato de", nombre, "en", reel)
        return cifras


hoy = date.today()
publicaciones = llamar(f"{CUENTA}/media", fields="id,caption,media_product_type,timestamp,permalink", limit=50)["data"]
filas = []
for p in publicaciones:
    if p.get("media_product_type") != "REELS":
        continue
    c = cifras_de(p["id"])
    if "ig_reels_avg_watch_time" in c:  # llega en milésimas de segundo
        c["segundos_vistos"] = round(c.pop("ig_reels_avg_watch_time") / 1000, 1)
    publicado = datetime.strptime(p["timestamp"], "%Y-%m-%dT%H:%M:%S%z").date()
    titulo = (p.get("caption") or "").split("\n")[0][:60]
    filas.append({"consultado": hoy.isoformat(), "publicado": publicado.isoformat(),
                  "dias": (hoy - publicado).days, "titulo": titulo, "enlace": p.get("permalink", ""), **c})

# 1. El historial: una fila por Reel y día, para ver cómo crece cada uno.
columnas = ["consultado", "publicado", "dias", "titulo", "enlace", "views", "reach", "saved",
            "shares", "likes", "comments", "segundos_vistos", "reels_skip_rate"]
nuevo = not os.path.exists("metricas.csv")
with open("metricas.csv", "a", newline="", encoding="utf-8") as archivo:
    escritor = csv.DictWriter(archivo, columnas, extrasaction="ignore")
    if nuevo:
        escritor.writeheader()
    escritor.writerows(filas)

# 2. El resumen: solo compara los Reels que ya tienen unos días.
asentados = [f for f in filas if f["dias"] >= DIAS_ASENTADO]
def mediana(campo):
    valores = [f[campo] for f in asentados if isinstance(f.get(campo), (int, float))]
    return statistics.median(valores) if valores else "sin dato"

lineas = [f"# Cómo van los Reels ({hoy})", "",
          f"Reels con {DIAS_ASENTADO} días o más: {len(asentados)}. Mediana de vistas: {mediana('views')}. "
          f"Mediana de quienes lo saltan en 3 s: {mediana('reels_skip_rate')} %.", "",
          "| Reel | Días | Vistas | Guardados | Compartidos | Saltan en 3 s | Segundos vistos |",
          "| --- | --- | --- | --- | --- | --- | --- |"]
for f in sorted(filas, key=lambda f: f.get("views", 0), reverse=True):
    lineas.append(f"| [{f['titulo'] or 'sin texto'}]({f['enlace']}) | {f['dias']} | {f.get('views', '-')} | "
                  f"{f.get('saved', '-')} | {f.get('shares', '-')} | {f.get('reels_skip_rate', '-')} | {f.get('segundos_vistos', '-')} |")
with open("resumen.md", "w", encoding="utf-8") as archivo:
    archivo.write("\n".join(lineas) + "\n")
print(f"Guardadas las cifras de {len(filas)} Reels. Resumen en resumen.md.")

Ejecútalo con las dos variables puestas:

INSTAGRAM_ACCESS_TOKEN=... INSTAGRAM_USER_ID=... python3 metricas_reels.py

En Windows, pon las variables con set antes de ejecutarlo. Al terminar tendrás metricas.csv y resumen.md en la misma carpeta.

Dos detalles del código:

  • El tiempo visto se divide entre mil. La documentación no dice en qué unidad llega; en nuestras consultas llegó en milésimas de segundo, y la cifra solo cuadra con la duración del Reel así.
  • El resumen compara solo los Reels con tres días o más. Uno más nuevo todavía está sumando vistas, y compararlo con uno de hace una semana engaña.

Límite de esta versión corta: lee las 50 publicaciones más recientes. Si tienes más, hay que pedir las páginas siguientes de la respuesta.

Paso 3 · Que se ejecute solo

Sirve cualquier programador de tareas: el de tu sistema o una tarea programada de GitHub Actions, gratuita dentro de sus límites. Una vez al día basta: las cifras pueden tardar hasta 48 horas en actualizarse. Si lo ejecutas dos veces el mismo día, el historial tendrá filas repetidas de ese día.

Si usas GitHub Actions, guarda las claves como secretos del repositorio y haz que la tarea guarde los dos archivos en el propio repositorio. Así tienes el historial sin otro servicio. Y avisa: las tareas programadas de GitHub pueden salir con horas de retraso. Para unas métricas diarias no importa.

Cómo leer el resumen

Las cifras sirven para comparar, no para celebrar. Lo que más dice, por este orden:

  1. Cuánta gente lo salta en tres segundos. Mide el gancho: si casi todos se van, el principio no engancha, da igual lo que venga después.
  2. Segundos vistos frente a lo que dura. Mide si el Reel se sostiene.
  3. Guardados y compartidos. Dicen si a alguien le sirvió lo bastante como para quedárselo o enviarlo.

Y dos reglas que aprendimos con nuestros propios Reels:

  • Con pocas vistas, las estimaciones no valen. Nuestro primer Reel, con 7 vistas, figuraba a la vez con un 100 % de gente que lo saltaba en tres segundos y con 18,7 segundos vistos de media sobre 24. Las dos cosas no pueden ser ciertas.
  • Un grupo de tres Reels no demuestra nada. Si tres Reels con un formato van mejor que tres con otro, también cambiaron el tema, el día y la hora. Espera a tener varios de cada uno antes de sacar conclusiones.

Qué se comprobó

  • En producción desde el 9 de octubre de 2026: Ctrl+IA recoge cada día, con una tarea programada, las mismas cifras con las mismas llamadas a las estadísticas, incluido el reintento cifra por cifra. Desde el 8 de octubre la clave tiene instagram_manage_insights y las cifras llegan completas. El tiempo visto llegó en milésimas y el porcentaje de quienes saltan el Reel, como un número entre 0 y 100.
  • Probado el 13 de octubre de 2026: el programa de esta página se ejecutó entero con respuestas simuladas de la API, sin claves: filtró los Reels, rellenó el hueco de una cifra que fallaba, escribió el historial y el resumen.
  • No se probó contra la API real la lista de publicaciones con el campo media_product_type: el programa del proyecto saca los Reels de su propio registro. El campo y sus valores salen de la referencia oficial.
  • No se probó con cuentas de miles de publicaciones.

Errores comunes

  • Falta el permiso de estadísticas. La API responde con un error de permisos. Genera la clave de nuevo con instagram_manage_insights.
  • Usar la clave de usuario. Caduca en horas. La que va en el programa es la de la página.
  • Mirar el Reel de ayer. Sus cifras pueden tardar hasta 48 horas.
  • Sacar conclusiones con 10 vistas. Las estimaciones necesitan público.
  • Dar a la app acceso a todas tus páginas. Marca solo la que vas a medir.

Para seguir

Las cifras dicen qué gancho retiene; el gancho lo escribes tú. Si tus Reels enseñan prompts, empieza por cómo hacer un buen prompt. Y si quieres que Claude ponga orden en el historial cada semana sin abrir el chat, mira las rutinas de Claude Code.

Esta guía es independiente: Ctrl+IA no tiene relación con Meta ni con Instagram. Lo que configures en tu cuenta lo haces bajo tu responsabilidad.

Recibe los prompts nuevos por correo

Al confirmar te llevas de regalo un PDF con los 62 prompts del sitio, listos para copiar. Sin spam, y te das de baja cuando quieras.

Te pediremos confirmar por correo. Al suscribirte aceptas la política de privacidad. Los envíos se gestionan con Kit.

Sigue con