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

Recuperez les donnees analytiques segmentees par pays.

Bearer Token (cle API)

Parametres de requete

ParametreTypeDescription
startAtstringDate/heure de début ISO 8601 (par exemple 2024-01-01T00:00:00Z). La valeur par défaut est les 30 derniers jours en cas d'omission.
endAtstringISO 8601 end date/time. Defaults to now when omitted.
timezonestringFuseau horaire pour l'agregation (par ex., UTC, America/New_York). Se rabat sur le fuseau horaire configure du site.
limitnumberNombre maximum de lignes a retourner (1-1000, par defaut : 100).
offsetnumberLignes a ignorer pour la pagination (min 0, par defaut : 0).

Parametres de filtre

ParametreTypeDescription
filter_countrystringNom ou code du pays. Utiliser | pour plusieurs valeurs et! à exclure.
filter_regionstringRegion ou etat.
filter_citystringNom de ville.
filter_devicestringType d'appareil. Utilisez des valeurs backend telles que Desktop|Mobile|Tablet et! à exclure.
filter_browserstringNom du navigateur. Safari inclut automatiquement Mobile Safari.
filter_osstringSysteme d'exploitation (Mac OS, Windows, iOS, Android).
filter_referrerstringDomaine referent ou nom connu.
filter_refstringValeur du parametre URL ref.
filter_sourcestringValeur du parametre URL source.
filter_viastringValeur du parametre URL via.
filter_utm_sourcestringSource UTM.
filter_utm_mediumstringMedium UTM.
filter_utm_campaignstringCampagne UTM.
filter_utm_termstringTerme UTM.
filter_utm_contentstringContenu UTM.
filter_pagestringChemin ou URL de page.
filter_entry_pagestringChemin ou URL de page d'entree.
filter_hostnamestringNom d'hote/domaine.
filter_channelstringCanal marketing.
filter_goalstringNom de l'objectif.

Champs de reponse

Chaque element du tableau <code>data</code> contient le nom du pays, une URL d'image SVG du drapeau, le nombre de visiteurs et les revenus attribues a ce pays.

Combiner les filtres

Passez des valeurs separees par des virgules dans un seul parametre de filtre pour correspondre a plusieurs elements. Combinez differents parametres de filtre pour affiner les resultats (par ex., <code>filter_country=United States,Canada&filter_device=mobile</code>).
Exemple de requete (curl)
curl --request GET \
  --url 'https://analytics.flowsery.com/api/v1/countries?limit=5' \
  --header 'Authorization: Bearer <api-key>'
200
{
  "status": "success",
  "data": [
    {
      "value": "United States",
      "countryCode": "US",
      "visitors": 2840,
      "revenue": 6780,
      "renewalRevenue": 1740,
      "percentage": 44.1
    },
    {
      "value": "France",
      "countryCode": "FR",
      "visitors": 1230,
      "revenue": 2450,
      "renewalRevenue": 530,
      "percentage": 19.1
    },
    {
      "value": "United Kingdom",
      "countryCode": "GB",
      "visitors": 920,
      "revenue": 1450,
      "renewalRevenue": 320,
      "percentage": 14.3
    },
    {
      "value": "Germany",
      "countryCode": "DE",
      "visitors": 780,
      "revenue": 1230,
      "renewalRevenue": 210,
      "percentage": 12.1
    },
    {
      "value": "Spain",
      "countryCode": "ES",
      "visitors": 650,
      "revenue": 980,
      "renewalRevenue": 140,
      "percentage": 10.1
    }
  ],
  "pagination": {
    "limit": 5,
    "offset": 0,
    "total": 148
  }
}