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

Recupere dados analiticos segmentados por pais.

Bearer Token (chave API)

Parametros de consulta

ParametroTipoDescricao
startAtstringData/hora de início ISO 8601 (por exemplo, 2024-01-01T00:00:00Z). O predefinido é os últimos 30 dias quando omitido.
endAtstringISO 8601 end date/time. Defaults to now when omitted.
timezonestringFuso horario para agregacao (por ex., UTC, America/New_York). Recorre ao fuso horario configurado do site.
limitnumberNumero maximo de linhas a retornar (1-1000, padrao: 100).
offsetnumberLinhas a pular para paginacao (min 0, padrao: 0).

Parametros de filtro

ParametroTipoDescricao
filter_countrystringNome ou indicativo do país. Usar | para vários valores e! para excluir.
filter_regionstringRegiao ou estado.
filter_citystringNome da cidade.
filter_devicestringTipo de dispositivo. Utilize valores de back-end como Desktop|Mobile|Tablet e! para excluir.
filter_browserstringNome do navegador. Safari inclui automaticamente Mobile Safari.
filter_osstringSistema operacional (Mac OS, Windows, iOS, Android).
filter_referrerstringDominio de referencia ou nome conhecido.
filter_refstringValor do parametro URL ref.
filter_sourcestringValor do parametro URL source.
filter_viastringValor do parametro URL via.
filter_utm_sourcestringFonte UTM.
filter_utm_mediumstringMeio UTM.
filter_utm_campaignstringCampanha UTM.
filter_utm_termstringTermo UTM.
filter_utm_contentstringConteudo UTM.
filter_pagestringCaminho ou URL da pagina.
filter_entry_pagestringCaminho ou URL da pagina de entrada.
filter_hostnamestringHostname/dominio.
filter_channelstringCanal de marketing.
filter_goalstringNome do objetivo.

Campos de resposta

Cada item no array <code>data</code> contem o nome do pais, uma URL de imagem SVG da bandeira, a contagem de visitantes e a receita atribuida a esse pais.

Combinar filtros

Passe valores separados por virgula em um unico parametro de filtro para corresponder a multiplos itens. Combine diferentes parametros de filtro para refinar os resultados (por ex., <code>filter_country=United States,Canada&filter_device=mobile</code>).
Exemplo de requisicao (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
  }
}