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

Obtener datos de análisis en series temporales agrupados por hora, día, 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 websiteId o domain 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

ParámetroTipoDescripción
websiteIdstringID del sitio web para usar con un token de API del espacio de trabajo. Omitir al autenticarse con una clave API de sitio web.
domainstringSitio 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.

Parámetros opcionales

ParámetroTipoDescripción
intervalstringIntervalo de agregación. Valores aceptados: hour, day, week, month.
startAtstringFecha/hora de inicio ISO 8601. El valor predeterminado es los últimos 30 días cuando se omite.
endAtstringFecha/hora de finalización ISO 8601. El valor predeterminado es ahora cuando se omite.
timezonestringZona horaria para la agregación (por ejemplo, UTC, America/New_York). Recurre a la zona horaria configurada del sitio.
limitnumberSe hizo eco en el objeto de paginación de respuesta. No corta la serie devuelta.
offsetnumberSe hizo eco en el objeto de paginación de respuesta. No corta la serie devuelta.

Parámetros de filtro

ParámetroTipoDescripción
filter_countrystringNombre del país tal como lo devuelve /countries, p. ej. United States. Usa | para varios valores, ! para excluir y ~ para una coincidencia parcial.
filter_regionstringNombre de la región o el estado tal como lo devuelve /regions, p. ej. California.
filter_citystringNombre de ciudad.
filter_devicestringTipo de dispositivo: Desktop, Mobile o Tablet. Los valores distinguen mayúsculas y minúsculas.
filter_browserstringNombre del navegador (Chrome, Safari, Firefox, Edge). Safari incluye Mobile Safari automáticamente.
filter_osstringSistema operativo (Mac OS, Windows, iOS, Android).
filter_referrerstringReferente tal como lo devuelve /referrers: un nombre de fuente como Google para los sitios reconocidos y, si no, el dominio.
filter_refstringEl valor del parámetro de URL ref.
filter_sourcestringEl valor del parámetro de URL source.
filter_viastringEl valor del parámetro de URL via.
filter_utm_sourcestringFuente UTM.
filter_utm_mediumstringMedio UTM.
filter_utm_campaignstringCampaña UTM.
filter_utm_termstringTérmino UTM.
filter_utm_contentstringContenido UTM.
filter_pagestringRuta de página o URL.
filter_entry_pagestringRuta o URL de página de entrada.
filter_hostnamestringNombre de host/dominio.
filter_channelstringCanal de marketing.
filter_goalstringNombre 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 }
}