api-referenceGET
GET
https://analytics.flowsery.com/api/v1/timeseriesRecuperez les donnees analytiques en series temporelles groupees par heure, jour, semaine ou mois.
Cle API (Bearer token)
Parametres facultatifs
| Parametre | Type | Description |
|---|---|---|
interval | string | Intervalle d'agregation. Valeurs acceptees : hour, day, week, month. |
startAt | string | Date/heure de début ISO 8601. La valeur par défaut est les 30 derniers jours en cas d'omission. |
endAt | string | ISO 8601 end date/time. Defaults to now when omitted. |
timezone | string | Fuseau horaire pour l'agregation (par ex., UTC, America/New_York). Se rabat sur le fuseau horaire configure du site. |
limit | number | Répercuté dans l'objet de pagination de réponse. Il ne découpe pas la série renvoyée. |
offset | number | Répercuté dans l'objet de pagination de réponse. Il ne découpe pas la série renvoyée. |
Parametres de filtre
| Parametre | Type | Description |
|---|---|---|
filter_country | string | Nom ou code de pays (par ex., filter_country=United States,Canada). |
filter_region | string | Region ou etat. |
filter_city | string | Nom de ville. |
filter_device | string | Type d'appareil (desktop, mobile, tablet). |
filter_browser | string | Nom du navigateur (Chrome, Safari, Firefox, Edge). Safari inclut automatiquement Mobile Safari. |
filter_os | string | Systeme d'exploitation (Mac OS, Windows, iOS, Android). |
filter_referrer | string | Domaine referent ou nom de referent connu. |
filter_ref | string | Valeur du parametre URL ref. |
filter_source | string | Valeur du parametre URL source. |
filter_via | string | Valeur du parametre URL via. |
filter_utm_source | string | Source UTM. |
filter_utm_medium | string | Medium UTM. |
filter_utm_campaign | string | Campagne UTM. |
filter_utm_term | string | Terme UTM. |
filter_utm_content | string | Contenu UTM. |
filter_page | string | Chemin ou URL de page. |
filter_entry_page | string | Chemin ou URL de page d'entree. |
filter_hostname | string | Nom d'hote/domaine. |
filter_channel | string | Canal marketing. |
filter_goal | string | Nom de l'objectif. |
Notes
Le API renvoie l'état, l'intervalle, le fuseau horaire, la devise, les lignes de données, les totaux et un écho de pagination. Les lignes de données incluent l'horodatage, le nom, les visiteurs, les sessions, les revenus, le renouvellementRevenue, le remboursementRevenue, le taux de conversion et la valeur kpi.Exemple de requete (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 }
}