Obtener datos de series temporales

api-referenceGET

GEThttps://analytics.flowsery.com/analytics/api/v1/timeseries

Obtener datos de analisis en series temporales agrupados por hora, dia, semana o mes.

Token Bearer (token de workspace o clave API de sitio web)

Los tokens de espacio de trabajo necesitan un selector de sitio web

Los tokens de API del espacio de trabajo pueden acceder a todos los sitios web del espacio de trabajo. Pase <code>websiteId</code> o <code>domain</code> para que Flowsery sepa qué sitio web consultar o mutar. Las claves API del sitio web ya están destinadas a un sitio web, por lo que se puede omitir el selector.

Selector de sitios web

Parametro	Tipo	Descripcion
`websiteId`	`string`	ID del sitio web para usar con un token de API del espacio de trabajo. Omitir al autenticarse con una clave API de sitio web.
`domain`	`string`	Sitio web domain para usar con un token API de espacio de trabajo cuando no se proporciona websiteId. Omitir al autenticarse con una clave API de sitio web.

Parametros opcionales

Parametro	Tipo	Descripcion
`interval`	`string`	Intervalo de agregacion. Valores aceptados: hour, day, week, month.
`startAt`	`string`	Fecha/hora de inicio ISO 8601. El valor predeterminado es los últimos 30 días cuando se omite.
`endAt`	`string`	Fecha/hora de finalización ISO 8601. El valor predeterminado es ahora cuando se omite.
`timezone`	`string`	Zona horaria para la agregacion (por ejemplo, UTC, America/New_York). Recurre a la zona horaria configurada del sitio.
`limit`	`number`	Se hizo eco en el objeto de paginación de respuesta. No corta la serie devuelta.
`offset`	`number`	Se hizo eco en el objeto de paginación de respuesta. No corta la serie devuelta.

Parametros de filtro

Parametro	Tipo	Descripcion
`filter_country`	`string`	Nombre del país tal como lo devuelve /countries, p. ej. United States. Usa \| para varios valores, ! para excluir y ~ para una coincidencia parcial.
`filter_region`	`string`	Nombre de la región o el estado tal como lo devuelve /regions, p. ej. California.
`filter_city`	`string`	Nombre de ciudad.
`filter_device`	`string`	Tipo de dispositivo: Desktop, Mobile o Tablet. Los valores distinguen mayúsculas y minúsculas.
`filter_browser`	`string`	Nombre del navegador (Chrome, Safari, Firefox, Edge). Safari incluye Mobile Safari automaticamente.
`filter_os`	`string`	Sistema operativo (Mac OS, Windows, iOS, Android).
`filter_referrer`	`string`	Referente tal como lo devuelve /referrers: un nombre de fuente como Google para los sitios reconocidos y, si no, el dominio.
`filter_ref`	`string`	El valor del parametro de URL ref.
`filter_source`	`string`	El valor del parametro de URL source.
`filter_via`	`string`	El valor del parametro de URL via.
`filter_utm_source`	`string`	Fuente UTM.
`filter_utm_medium`	`string`	Medio UTM.
`filter_utm_campaign`	`string`	Campana UTM.
`filter_utm_term`	`string`	Termino UTM.
`filter_utm_content`	`string`	Contenido UTM.
`filter_page`	`string`	Ruta de pagina o URL.
`filter_entry_page`	`string`	Ruta o URL de pagina de entrada.
`filter_hostname`	`string`	Nombre de host/dominio.
`filter_channel`	`string`	Canal de marketing.
`filter_goal`	`string`	Nombre del objetivo.

Notas

La API devuelve status, interval, timezone, currency, las filas de datos, los totales y un eco de la paginación. Cada fila incluye timestamp, name, visitors, sessions, revenue, newRevenue, renewalRevenue, refundedRevenue, conversionRate y kpiValue. Sea cual sea el intervalo, el periodo por defecto son los últimos 30 días: pasa startAt y endAt para otro periodo y usa hour solo para unos pocos días.

Solicitud de ejemplo (curl)

curl --request GET \
  --url 'https://analytics.flowsery.com/analytics/api/v1/timeseries?interval=day&limit=30' \
  --header 'Authorization: Bearer <api-key>'

200

{
  "status": "success",
  "interval": "day",
  "timezone": "Asia/Calcutta",
  "currency": "USD",
  "data": [
    {
      "timestamp": "2025-12-17T00:00:00+05:30",
      "name": "17 Dec",
      "visitors": 528,
      "sessions": 604,
      "revenue": 1540,
      "newRevenue": 1220,
      "renewalRevenue": 320,
      "refundedRevenue": 40,
      "conversionRate": 1.42,
      "kpiValue": 1540
    }
  ],
  "totals": {
    "visitors": 14213,
    "sessions": 20181,
    "revenue": 27351
  },
  "pagination": { "limit": 30, "offset": 0, "total": 30 }
}