API-Referenz

Kampagnen

Name: Flowsery
Author: Flowsery

Kampagnen- und UTM-Aufschlüsselung abrufen

GEThttps://analytics.flowsery.com/campaigns

Analysedaten segmentiert nach Kampagnenparametern abrufen.

API-Schluessel (Bearer-Token)

Optionale Parameter

Parameter	Typ	Beschreibung
`startAt`	`string`	ISO 8601 Startdatum/-zeit. Weglassen fuer Daten ueber den gesamten Zeitraum.
`endAt`	`string`	ISO 8601 Enddatum/-zeit. Muss zusammen mit startAt angegeben werden.
`timezone`	`string`	Zeitzone fuer die Aggregation (z. B. UTC, America/New_York). Faellt auf die konfigurierte Zeitzone Ihrer Website zurueck.
`limit`	`number`	Maximale Anzahl zurueckgegebener Zeilen (1-1000, Standard: 100).
`offset`	`number`	Zu ueberspringende Zeilen fuer Paginierung (min. 0, Standard: 0).

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. Safari schliesst Mobile Safari automatisch ein.
`filter_os`	`string`	Betriebssystem.
`filter_referrer`	`string`	Referrer-Domain oder bekannter Name.
`filter_ref`	`string`	Der ref-URL-Parameter.
`filter_source`	`string`	Der source-URL-Parameter.
`filter_via`	`string`	Der via-URL-Parameter.
`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.
`filter_entry_page`	`string`	Einstiegsseiten-Pfad.
`filter_hostname`	`string`	Hostname/Domain.
`filter_channel`	`string`	Marketingkanal.
`filter_goal`	`string`	Zielname.

Beispielanfrage (curl)

curl --request GET \
  --url https://analytics.flowsery.com/api/v1/campaigns \
  --header 'Authorization: Bearer <api-key>'

200

{
  "status": "success",
  "data": [
    {
      "campaign": {
        "utm_source": "",
        "utm_medium": "",
        "utm_campaign": "",
        "utm_term": "",
        "utm_content": "",
        "ref": "indiepage",
        "source": "",
        "via": ""
      },
      "visitors": 2150,
      "revenue": 3420
    },
    {
      "campaign": {
        "utm_source": "newsletter.example.com",
        "utm_medium": "email",
        "utm_campaign": "product-launch-2025",
        "utm_term": "",
        "utm_content": "",
        "ref": "",
        "source": "",
        "via": ""
      },
      "visitors": 1840,
      "revenue": 2890
    },
    {
      "campaign": {
        "utm_source": "",
        "utm_medium": "",
        "utm_campaign": "",
        "utm_term": "",
        "utm_content": "",
        "ref": "",
        "source": "",
        "via": "partner"
      },
      "visitors": 920,
      "revenue": 1450
    }
  ],
  "pagination": {
    "limit": 5,
    "offset": 0,
    "total": 138
  }
}