Zeitreihendaten abrufen

api-referenceGET

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

Zeitreihen-Analysedaten abrufen, gruppiert nach Stunde, Tag, Woche oder Monat.

Bearer-Token (Workspace-Token oder Website-API-Schlüssel)

Workspace-Tokens benötigen einen Website-Selektor

Workspace-API-Tokens können auf jede Website im Workspace zugreifen. Übergeben Sie entweder <code>websiteId</code> oder <code>domain</code>, damit Flowsery weiß, welche Website abgefragt oder geändert werden muss. Website-API-Schlüssel sind bereits auf eine Website beschränkt, sodass der Selektor weggelassen werden kann.

Website-Auswahl

Parameter	Typ	Beschreibung
`websiteId`	`string`	Website-ID zur Verwendung mit einem Workspace-API-Token. Bei der Authentifizierung mit einem Website-API-Schlüssel weglassen.
`domain`	`string`	Website domain zur Verwendung mit einem Workspace-API-Token, wenn websiteId nicht bereitgestellt wird. Bei der Authentifizierung mit einem Website-API-Schlüssel weglassen.

Optionale Parameter

Parameter	Typ	Beschreibung
`interval`	`string`	Aggregationsintervall. Akzeptierte Werte: hour, day, week, month.
`startAt`	`string`	ISO 8601-Startdatum/-uhrzeit. Wenn weggelassen, werden standardmäßig die letzten 30 Tage verwendet.
`endAt`	`string`	Datum/Uhrzeit des ISO 8601-Endes. Wird standardmäßig auf „jetzt“ gesetzt, wenn es weggelassen wird.
`timezone`	`string`	Zeitzone fuer die Aggregation (z. B. UTC, America/New_York). Faellt auf die konfigurierte Zeitzone der Website zurueck.
`limit`	`number`	Wird im Antwort-Paginierungsobjekt zurückgegeben. Die zurückgegebene Serie wird nicht in Scheiben geschnitten.
`offset`	`number`	Wird im Antwort-Paginierungsobjekt zurückgegeben. Die zurückgegebene Serie wird nicht in Scheiben geschnitten.

Filterparameter

Parameter	Typ	Beschreibung
`filter_country`	`string`	Laendername oder -code (z. B. filter_country=United States,Canada).
`filter_region`	`string`	Region oder Bundesland.
`filter_city`	`string`	Stadtname.
`filter_device`	`string`	Geraetetyp (desktop, mobile, tablet).
`filter_browser`	`string`	Browsername (Chrome, Safari, Firefox, Edge). Safari schliesst Mobile Safari automatisch ein.
`filter_os`	`string`	Betriebssystem (Mac OS, Windows, iOS, Android).
`filter_referrer`	`string`	Referrer-Domain oder bekannter Referrer-Name.
`filter_ref`	`string`	Der ref-URL-Parameterwert.
`filter_source`	`string`	Der source-URL-Parameterwert.
`filter_via`	`string`	Der via-URL-Parameterwert.
`filter_utm_source`	`string`	UTM-Quelle.
`filter_utm_medium`	`string`	UTM-Medium.
`filter_utm_campaign`	`string`	UTM-Kampagne.
`filter_utm_term`	`string`	UTM-Begriff.
`filter_utm_content`	`string`	UTM-Inhalt.
`filter_page`	`string`	Seitenpfad oder URL.
`filter_entry_page`	`string`	Einstiegsseiten-Pfad oder URL.
`filter_hostname`	`string`	Hostname/Domain.
`filter_channel`	`string`	Marketingkanal.
`filter_goal`	`string`	Zielname.

Hinweise

Der API gibt Status, Intervall, Zeitzone, Währung, Datenzeilen, Summen und ein Paginierungsecho zurück. Zu den Datenzeilen gehören Zeitstempel, Name, Besucher, Sitzungen, Umsatz, Verlängerungsumsatz, Rückerstattungsumsatz, ConversionRate und kpiValue.

Beispielanfrage (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": "$",
  "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 }
}