Obtener estadísticas

Devuelve las últimas cifras válidas que Sofia recopiló de cada cuenta conectada. Una cuenta aún no recopilada muestra awaiting, nunca cero.

GEThttps://api.sofia-post.com/api/v1/establishments/{id}/insights

GET/v1/establishments/{id}/insights

Clave de API o token de accesoSe guarda solo en esta pestaña y se envía únicamente a api.sofia-post.com.id (path)period (query)

curl -X GET 'https://api.sofia-post.com/api/v1/establishments/{id}/insights' \
  -H "Authorization: Bearer $SOFIA_API_KEY"

Autorizaciones

Authorizationstringobligatorio
Tu clave personal o token de acceso OAuth, enviado como Bearer <token>.

Parámetros de ruta

idstringobligatorio
Identificador del establecimiento.

Parámetros de consulta

periodstring
El periodo; los últimos 28 días si se omite.
Valores permitidos: last24Hourslast7Dayslast28Days

Respuesta

200application/json

Las cifras de cada cuenta conectada.

establishmentIdstringobligatorio
Identificador del establecimiento.
periodstringobligatorio
Periodo que cubren las cifras
Valores permitidos: last24Hourslast7Dayslast28Days
dataobject[]obligatorio
Las cifras de cada cuenta conectada
Mostrar atributos hijos
- platformstringobligatorio
  Identificador de la plataforma de la red
- viewsobjectobligatorio
  Veces que se mostró o reprodujo el contenido. Instagram lo llama views; puede contar varias veces la misma cuenta, así que nunca equivale al alcance.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- reachobjectobligatorio
  Cuentas únicas que vieron el contenido al menos una vez en el periodo.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- reachDeltaPercentobjectobligatorio
  Variación del alcance respecto al periodo anterior, en porcentaje con signo.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- accountsEngagedobjectobligatorio
  Cuentas únicas que interactuaron con el contenido.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- totalInteractionsobjectobligatorio
  Me gusta, comentarios, guardados, compartidos y otras interacciones admitidas.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- likesobjectobligatorio
  Me gusta en el periodo.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- commentsobjectobligatorio
  Comentarios en el periodo.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- sharesobjectobligatorio
  Compartidos en el periodo.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- savesobjectobligatorio
  Guardados en el periodo.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- engagementRatePercentobjectobligatorio
  Interacciones totales divididas por las cuentas alcanzadas, en porcentaje. Lo calcula Sofia, no es una cifra que informe la plataforma. No disponible cuando falta el alcance o es cero.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- engagementDeltaPointsobjectobligatorio
  Variación de la tasa de interacción respecto al periodo anterior, en puntos.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- followersDeltaobjectobligatorio
  Variación neta de seguidores en el periodo. Meta la retiene para las cuentas de Instagram con menos de 100 seguidores, indicada como below-follower-threshold, ni como error ni como 0.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- postsPublishedDuringPeriodobjectobligatorio
  Publicaciones publicadas durante el periodo.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- followersTotalobjectobligatorio
  Número absoluto de seguidores que informa el perfil conectado. En Instagram viene de instagram_business_basic, no de Insights. available con valor 0 significa que la plataforma informó cero; una ausencia es unavailable con su motivo, nunca son la misma cifra.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- postsTotalobjectobligatorio
  Número absoluto de publicaciones en la red, de siempre, que informa el perfil conectado. Mismo contrato que followersTotal: un cero informado sigue siendo cero, una ausencia sigue ausente.
  Mostrar atributos hijos
  - statusstringobligatorio
    Si la plataforma informó realmente de esta métrica. available puede llevar un valor de 0, un cero medido. unavailable nunca lleva valor.
    Valores permitidos: availableunavailable
  - valuenumber
    La cifra medida. Presente solo cuando el estado es available; 0 es un valor real.
  - reasonstring
    Por qué falta la métrica. below-follower-threshold: Meta retiene las métricas de audiencia por debajo de 100 seguidores, no es un error. permission-denied: falta un permiso de Insights en la cuenta conectada, permanente hasta que el propietario la reconecte, nunca transitorio. not-collected: Sofia aún no mide esta cifra en este endpoint, nunca se consultó a la plataforma, así que no es culpa suya.
    Valores permitidos: not-returnedunsupportedbelow-follower-thresholdpermission-deniederrornot-collectedaccount-not-eligibledata-not-readyoutside-retention-window
  - mayBeDelayedboolean
    Verdadero mientras la plataforma pueda seguir completando esta ventana; Instagram publica algunas cifras con hasta 48 horas de retraso.
  - sourceMetricstring
    El campo de la plataforma del que sale esta cifra, full_video_watched_rate en TikTok, post_video_view_time en Facebook. Dos redes llaman «finalización» a cosas distintas; sin este campo, un informe las pondría una junto a otra como si fueran comparables.
  - granularitystring
    Lo que cubre la cifra: un total acumulado, una hora, un día, todo el periodo pedido tal como lo agregó la red, o un segundo de vídeo. Una serie diaria, un agregado de periodo y un total acumulado no son la misma medida: no los pintes en el mismo eje ni los sumes.
    Valores permitidos: lifetimehourdayperiodvideo-second
- hasInsightsDatabooleanobligatorio
  Verdadero cuando al menos una llamada a Insights tuvo éxito. Los seguidores y el número de publicaciones también vienen del perfil básico, así que su presencia no prueba que Insights se pueda leer.
- mayBeDelayedbooleanobligatorio
  Verdadero mientras la plataforma pueda seguir completando esta ventana (hasta 48 horas).
- socialAccountIdstringobligatorio
  La cuenta conectada a la que pertenecen estas cifras.
- collectionobjectobligatorio
  Los datos de recopilación detrás de estas cifras.
  Mostrar atributos hijos
  - statestringobligatorio
    awaiting-first-collection: la cuenta está conectada y aún no existe ninguna respuesta válida, cada métrica vale not-collected.
    Valores permitidos: collectedawaiting-first-collection
  - isOutdatedbooleanobligatorio
    Verdadero cuando un intento posterior falló, o la siguiente recopilación lleva más de una hora de retraso. Las cifras siguen siendo válidas para su ventana y su fecha; no están al día.
  - isCollectingbooleanobligatorio
    Verdadero mientras se ejecuta una recopilación de esta cuenta.
  - collectedAtnumber
    Cuándo respondió la red (unix ms).
  - windowStartnumber
    Inicio de la ventana pedida a la red (unix ms).
  - windowEndnumber
    Fin de la ventana pedida a la red (unix ms).
  - completenessstring
    partial: la red solo respondió una parte de la ventana, o fallaron algunas métricas.
    Valores permitidos: completepartial
  - nextCollectionAtnumber
    Cuándo toca la siguiente recopilación (unix ms).
  - lastFailedAttemptobject
    El último intento, cuando terminó después de las cifras mostradas y no tuvo éxito.
    Mostrar atributos hijos
    atnumberobligatorio
    Cuándo terminó el intento (unix ms)
    outcomestringobligatorio
    deferred: la red pidió a Sofia que esperara (límite de tasa, cuota). failed: cualquier otro caso.
    Valores permitidos: faileddeferred
    reasonstring
    Por qué, tal como lo clasificó Sofia (reauthentication-required, platform-error…).
- reachDailySeriesnumber[]
  Valores diarios de alcance. Ausente cuando la plataforma no devolvió ninguna serie, nunca rellenado con ceros.
- engagementDailySeriesnumber[]
  Tasa de interacción diaria en porcentaje. Ausente en Instagram: total_interactions no tiene modo de serie temporal, así que no existe una tasa diaria honesta.
- followersDailySeriesnumber[]
  Variación neta diaria de seguidores. Ausente cuando la plataforma no la informa.
- fetchedAtnumber
  Cuándo respondió la red (unix ms). Ausente hasta que la primera recopilación tiene éxito.

401

El token falta, es desconocido, ha caducado o está revocado.

403

El token no tiene el permiso insights:read.

404

Establecimiento fuera del Workspace del token.

4XXapplication/json

Cualquier otro error, en el sobre de error.

Obtener estadísticas

curl --request GET \
  --url 'https://api.sofia-post.com/api/v1/establishments/<id>/insights' \
  --header "Authorization: Bearer $SOFIA_API_KEY"

{
  "establishmentId": "string",
  "period": "last24Hours",
  "data": [
    {
      "platform": "instagram",
      "views": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reach": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reachDeltaPercent": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "accountsEngaged": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "totalInteractions": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "likes": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "comments": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "shares": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "saves": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "engagementRatePercent": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "engagementDeltaPoints": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "followersDelta": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "postsPublishedDuringPeriod": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "reachDailySeries": [
        0
      ],
      "followersDailySeries": [
        0
      ],
      "followersTotal": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "postsTotal": {
        "status": "available",
        "value": 1284,
        "mayBeDelayed": false,
        "sourceMetric": "full_video_watched_rate"
      },
      "hasInsightsData": true,
      "mayBeDelayed": false,
      "fetchedAt": 1739539200000,
      "socialAccountId": "acc_123",
      "collection": {
        "state": "collected",
        "collectedAt": 1739539200000,
        "completeness": "complete",
        "isOutdated": false,
        "isCollecting": false
      }
    }
  ]
}