api-referenceGET
GET
https://analytics.flowsery.com/api/v1/timeseriesRecupere dados analiticos em series temporais agrupados por hora, dia, semana ou mes.
Chave API (Bearer token)
Parametros opcionais
| Parametro | Tipo | Descricao |
|---|---|---|
interval | string | Intervalo de agregacao. Valores aceitos: hour, day, week, month. |
startAt | string | Data/hora de início da ISO 8601. A norma são os últimos 30 dias quando omitido. |
endAt | string | ISO 8601 end date/time. Defaults to now when omitted. |
timezone | string | Fuso horario para agregacao (por ex., UTC, America/New_York). Recorre ao fuso horario configurado do site. |
limit | number | Ecoado de volta no objeto de paginação de resposta. Não corta a série regressada. |
offset | number | Ecoado de volta no objeto de paginação de resposta. Não corta a série regressada. |
Parametros de filtro
| Parametro | Tipo | Descricao |
|---|---|---|
filter_country | string | Nome ou codigo do pais (por ex., filter_country=United States,Canada). |
filter_region | string | Regiao ou estado. |
filter_city | string | Nome da cidade. |
filter_device | string | Tipo de dispositivo (desktop, mobile, tablet). |
filter_browser | string | Nome do navegador (Chrome, Safari, Firefox, Edge). Safari inclui automaticamente Mobile Safari. |
filter_os | string | Sistema operacional (Mac OS, Windows, iOS, Android). |
filter_referrer | string | Dominio de referencia ou nome de referencia conhecido. |
filter_ref | string | Valor do parametro URL ref. |
filter_source | string | Valor do parametro URL source. |
filter_via | string | Valor do parametro URL via. |
filter_utm_source | string | Fonte UTM. |
filter_utm_medium | string | Meio UTM. |
filter_utm_campaign | string | Campanha UTM. |
filter_utm_term | string | Termo UTM. |
filter_utm_content | string | Conteudo UTM. |
filter_page | string | Caminho ou URL da pagina. |
filter_entry_page | string | Caminho ou URL da pagina de entrada. |
filter_hostname | string | Hostname/dominio. |
filter_channel | string | Canal de marketing. |
filter_goal | string | Nome do objetivo. |
Notas
O API devolve o estado, o intervalo, o fuso horário, a moeda, as linhas de dados, os totais e um eco de paginação. As linhas de dados incluem o carimbo de data/hora, nome, visitantes, sessões, receita, renovaçãoRevenue, refundedRevenue, ConversionRate e kpiValue.Exemplo de requisicao (curl)
curl --request GET \
--url 'https://analytics.flowsery.com/api/v1/timeseries?interval=day&limit=30' \
--header 'Authorization: Bearer <api-key>'200
{
"status": "success",
"interval": "day",
"timezone": "Asia/Calcutta",
"currency": "$",
"data": [
{
"timestamp": "2025-12-17T00:00:00+05:30",
"name": "17 Dec",
"visitors": 528,
"sessions": 604,
"revenue": 1540,
"renewalRevenue": 320,
"refundedRevenue": 40,
"conversionRate": 1.42,
"kpiValue": 1540
}
],
"totals": {
"visitors": 14213,
"sessions": 20181,
"revenue": 27351
},
"pagination": { "limit": 30, "offset": 0, "total": 30 }
}