Privacidad y analítica
Utilizamos cookies técnicas necesarias y, solo si das tu consentimiento, analítica y pixels de marketing para mejorar la web y medir campañas.
Redes, publicidad, web y la actividad en Nömad de la marca: cifras con su periodo, su fuente y comparadas.
Actualizado el 1 de enero de 1970
Solo lectura en todas las puertas.
Las cifras principales de la marca en un periodo (seguidores, alcance, interacciones, sesiones web, inversión, publicaciones, trabajos terminados y mensajes con Nömad), comparadas con el periodo anterior, y qué fuentes están conectadas.
| Campo | Valor |
|---|---|
| Tipo | Lectura |
| Método HTTP | POST /api/v1/stats.overview |
| Herramienta MCP | stats_overview |
| Alcance | stats.read |
| Rol mínimo | Lector |
| Confirmación humana | No |
| Puertas | Nödo, Voz, MCP, API, Chat, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
from?: string // First day of the period (YYYY-MM-DD). Default: 28 days before `to`.
to?: string // Last day of the period (YYYY-MM-DD), included. Default: yesterday in `timeZone`.
compare?: "previous" | "year" | "none" // default "previous" · `previous`: the same number of days just before; `year`: the same days a year earlier; `none`: no comparison.
timeZone?: string // ≤ 64 · IANA zone the days are counted in. Default: Europe/Madrid.
}Salida
{
period: {
from: string
to: string
previousFrom: string | null
previousTo: string | null
compare: "previous" | "year" | "none"
timeZone: string
}
figures: Array<{
metric: "followers" | "reach" | "impressions" | "views" | "engagement" | "engagement_rate" | "clicks" | "ctr" | "spend" | "conversions" | "sessions" | "active_users" | "page_views" | "calls" | "directions" | "posts_published" | "works_completed" | "works_opened" | "conversations" | "messages" | "files_added" | "meetings"
value: number | null // Null when no source the brand has measures it in the period.
previous: number | null
change: number | null // Stock metrics (followers): gained or lost during the period.
currency: string | null // ISO currency for `spend`; null when several currencies cannot be added.
sources: string[] // Products (`instagram`, `meta_ads`, `nomad`…) the value comes from.
window: {
from: string
to: string
}
| null // When a provider reported a different window than the period (e.g. Meta Ads last 30 days), the window the value covers.
partial: boolean // True when some connected source could not contribute to this figure in the period.
}>
sources: Array<{
product: string
family: "social" | "web" | "business" | "ads" | "email" | "nomad"
name: string
adapter: "live" | "contract" // `live`: Nömad reads it; `contract`: declared, not read yet (see `missing`).
state: "connected" | "attention" | "not_connected" | "unavailable" // `attention`: connected but a connection needs a person (reconnect in Connections). `unavailable`: cannot be connected yet.
accounts: Array<{
id: string
name: string
handle: string | null
status: string // Connection status: active, limited, refresh_required, expired, revoked, error, paused, disconnected, transferred.
lastReadAt: string | null // Last time Nömad stored a metric of this account.
}>
unlocks: Array<"followers" | "reach" | "impressions" | "views" | "engagement" | "engagement_rate" | "clicks" | "ctr" | "spend" | "conversions" | "sessions" | "active_users" | "page_views" | "calls" | "directions" | "posts_published" | "works_completed" | "works_opened" | "conversations" | "messages" | "files_added" | "meetings"> // Metrics connecting it adds to the report.
missing: string | null // For `contract` adapters: what is missing, in the reader's language.
}>
updatedAt: string | null
}El informe de una sección de Estadísticas (resumen, redes sociales, web, publicidad, contenido, actividad en Nömad o conexiones): cifras comparadas, evolución diaria, desglose por red o cuenta, publicaciones destacadas y fuentes.
| Campo | Valor |
|---|---|
| Tipo | Lectura |
| Método HTTP | POST /api/v1/stats.report |
| Herramienta MCP | stats_report |
| Alcance | stats.read |
| Rol mínimo | Lector |
| Confirmación humana | No |
| Puertas | Nödo, Voz, MCP, API, Chat, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
section?: "overview" | "social" | "web" | "ads" | "content" | "activity" | "sources" // default "overview"
from?: string // First day of the period (YYYY-MM-DD). Default: 28 days before `to`.
to?: string // Last day of the period (YYYY-MM-DD), included. Default: yesterday in `timeZone`.
compare?: "previous" | "year" | "none" // default "previous" · `previous`: the same number of days just before; `year`: the same days a year earlier; `none`: no comparison.
timeZone?: string // ≤ 64 · IANA zone the days are counted in. Default: Europe/Madrid.
}Salida
{
section: "overview" | "social" | "web" | "ads" | "content" | "activity" | "sources"
period: {
from: string
to: string
previousFrom: string | null
previousTo: string | null
compare: "previous" | "year" | "none"
timeZone: string
}
figures: Array<{
metric: "followers" | "reach" | "impressions" | "views" | "engagement" | "engagement_rate" | "clicks" | "ctr" | "spend" | "conversions" | "sessions" | "active_users" | "page_views" | "calls" | "directions" | "posts_published" | "works_completed" | "works_opened" | "conversations" | "messages" | "files_added" | "meetings"
value: number | null // Null when no source the brand has measures it in the period.
previous: number | null
change: number | null // Stock metrics (followers): gained or lost during the period.
currency: string | null // ISO currency for `spend`; null when several currencies cannot be added.
sources: string[] // Products (`instagram`, `meta_ads`, `nomad`…) the value comes from.
window: {
from: string
to: string
}
| null // When a provider reported a different window than the period (e.g. Meta Ads last 30 days), the window the value covers.
partial: boolean // True when some connected source could not contribute to this figure in the period.
}>
series: Array<{
metric: "followers" | "reach" | "impressions" | "views" | "engagement" | "engagement_rate" | "clicks" | "ctr" | "spend" | "conversions" | "sessions" | "active_users" | "page_views" | "calls" | "directions" | "posts_published" | "works_completed" | "works_opened" | "conversations" | "messages" | "files_added" | "meetings"
product: string | null
points: Array<{
day: string
value: number | null
}>
previous: Array<{
day: string
value: number | null
}> // The comparison period, day by day, aligned by position.
}>
breakdown: Array<{
key: string
product: string
family: "social" | "web" | "business" | "ads" | "email" | "nomad"
name: string // Account, page or ad account name as the provider reports it.
handle: string | null
currency: string | null
values: Record<string, number | null> // Normalized metric id → value for the period.
window: {
from: string
to: string
}
| null
}>
topPosts: Array<{
id: string
origin: "nomad" | "imported" // `nomad`: published from Nömad; `imported`: published on the network and imported.
postId: string | null // The Nömad post (open it in Publicaciones); null for imported ones.
product: string
accountName: string | null
text: string | null
permalink: string | null
thumbnailUrl: string | null
publishedAt: string
metrics: Record<string, number> // Latest reading: reach, views, impressions, engagement, likes, comments, shares, saves…
measuredAt: string | null
}>
sources: Array<{
product: string
family: "social" | "web" | "business" | "ads" | "email" | "nomad"
name: string
adapter: "live" | "contract" // `live`: Nömad reads it; `contract`: declared, not read yet (see `missing`).
state: "connected" | "attention" | "not_connected" | "unavailable" // `attention`: connected but a connection needs a person (reconnect in Connections). `unavailable`: cannot be connected yet.
accounts: Array<{
id: string
name: string
handle: string | null
status: string // Connection status: active, limited, refresh_required, expired, revoked, error, paused, disconnected, transferred.
lastReadAt: string | null // Last time Nömad stored a metric of this account.
}>
unlocks: Array<"followers" | "reach" | "impressions" | "views" | "engagement" | "engagement_rate" | "clicks" | "ctr" | "spend" | "conversions" | "sessions" | "active_users" | "page_views" | "calls" | "directions" | "posts_published" | "works_completed" | "works_opened" | "conversations" | "messages" | "files_added" | "meetings"> // Metrics connecting it adds to the report.
missing: string | null // For `contract` adapters: what is missing, in the reader's language.
}>
updatedAt: string | null
}Una métrica día a día en un periodo y en el anterior, sumando las fuentes de la marca o solo una (product).
| Campo | Valor |
|---|---|
| Tipo | Lectura |
| Método HTTP | POST /api/v1/stats.series |
| Herramienta MCP | stats_series |
| Alcance | stats.read |
| Rol mínimo | Lector |
| Confirmación humana | No |
| Puertas | Nödo, Voz, MCP, API, Chat, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
metric: "followers" | "reach" | "impressions" | "views" | "engagement" | "engagement_rate" | "clicks" | "ctr" | "spend" | "conversions" | "sessions" | "active_users" | "page_views" | "calls" | "directions" | "posts_published" | "works_completed" | "works_opened" | "conversations" | "messages" | "files_added" | "meetings"
product?: string // ≤ 60
from?: string // First day of the period (YYYY-MM-DD). Default: 28 days before `to`.
to?: string // Last day of the period (YYYY-MM-DD), included. Default: yesterday in `timeZone`.
compare?: "previous" | "year" | "none" // default "previous" · `previous`: the same number of days just before; `year`: the same days a year earlier; `none`: no comparison.
timeZone?: string // ≤ 64 · IANA zone the days are counted in. Default: Europe/Madrid.
}Salida
{
period: {
from: string
to: string
previousFrom: string | null
previousTo: string | null
compare: "previous" | "year" | "none"
timeZone: string
}
series: {
metric: "followers" | "reach" | "impressions" | "views" | "engagement" | "engagement_rate" | "clicks" | "ctr" | "spend" | "conversions" | "sessions" | "active_users" | "page_views" | "calls" | "directions" | "posts_published" | "works_completed" | "works_opened" | "conversations" | "messages" | "files_added" | "meetings"
product: string | null
points: Array<{
day: string
value: number | null
}>
previous: Array<{
day: string
value: number | null
}> // The comparison period, day by day, aligned by position.
}
}Las publicaciones del periodo (desde Nömad o importadas de la red) ordenadas por interacciones, alcance o visualizaciones, con su última lectura.
| Campo | Valor |
|---|---|
| Tipo | Lectura |
| Método HTTP | POST /api/v1/stats.posts.top |
| Herramienta MCP | stats_posts_top |
| Alcance | stats.read |
| Rol mínimo | Lector |
| Confirmación humana | No |
| Puertas | Nödo, Voz, MCP, API, Chat, Pantallas, Apps |
| Estado | Disponible |
Entrada
{
metric?: "engagement" | "reach" | "views" | "impressions" // default "engagement"
product?: string // ≤ 60
limit?: integer // 1–50 · default 10
from?: string // First day of the period (YYYY-MM-DD). Default: 28 days before `to`.
to?: string // Last day of the period (YYYY-MM-DD), included. Default: yesterday in `timeZone`.
compare?: "previous" | "year" | "none" // default "previous" · `previous`: the same number of days just before; `year`: the same days a year earlier; `none`: no comparison.
timeZone?: string // ≤ 64 · IANA zone the days are counted in. Default: Europe/Madrid.
}Salida
{
period: {
from: string
to: string
previousFrom: string | null
previousTo: string | null
compare: "previous" | "year" | "none"
timeZone: string
}
metric: string
items: Array<{
id: string
origin: "nomad" | "imported" // `nomad`: published from Nömad; `imported`: published on the network and imported.
postId: string | null // The Nömad post (open it in Publicaciones); null for imported ones.
product: string
accountName: string | null
text: string | null
permalink: string | null
thumbnailUrl: string | null
publishedAt: string
metrics: Record<string, number> // Latest reading: reach, views, impressions, engagement, likes, comments, shares, saves…
measuredAt: string | null
}>
}De dónde salen las cifras de la marca: cada red, cuenta publicitaria o analítica, si está conectada, si necesita atención y qué cifras añade conectarla.
| Campo | Valor |
|---|---|
| Tipo | Lectura |
| Método HTTP | POST /api/v1/stats.sources.list |
| Herramienta MCP | stats_sources_list |
| Alcance | stats.read |
| Rol mínimo | Lector |
| Confirmación humana | No |
| Puertas | Nödo, Voz, MCP, API, Chat, Pantallas, Apps |
| Estado | Disponible |
Entrada
{}Salida
{
sources: Array<{
product: string
family: "social" | "web" | "business" | "ads" | "email" | "nomad"
name: string
adapter: "live" | "contract" // `live`: Nömad reads it; `contract`: declared, not read yet (see `missing`).
state: "connected" | "attention" | "not_connected" | "unavailable" // `attention`: connected but a connection needs a person (reconnect in Connections). `unavailable`: cannot be connected yet.
accounts: Array<{
id: string
name: string
handle: string | null
status: string // Connection status: active, limited, refresh_required, expired, revoked, error, paused, disconnected, transferred.
lastReadAt: string | null // Last time Nömad stored a metric of this account.
}>
unlocks: Array<"followers" | "reach" | "impressions" | "views" | "engagement" | "engagement_rate" | "clicks" | "ctr" | "spend" | "conversions" | "sessions" | "active_users" | "page_views" | "calls" | "directions" | "posts_published" | "works_completed" | "works_opened" | "conversations" | "messages" | "files_added" | "meetings"> // Metrics connecting it adds to the report.
missing: string | null // For `contract` adapters: what is missing, in the reader's language.
}>
}