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

Recupere dados analíticos segmentados por fonte de referência.

Token Bearer (token de workspace ou chave API de website)

Os tokens do espaço de trabalho precisam de um seletor de site

Os tokens da API do Workspace podem acessar todos os sites do workspace. Passe websiteId ou domain para que Flowsery saiba qual site consultar ou alterar. As chaves da API do site já têm como escopo um site, portanto o seletor pode ser omitido.

Seletor de site

ParâmetroTipoDescrição
websiteIdstringID do site a ser usado com um token de API do workspace. Omitir ao autenticar com uma chave de API de site.
domainstringSite domain para usar com um token de API do espaço de trabalho quando websiteId não for fornecido. Omitir ao autenticar com uma chave de API de site.

Parâmetros opcionais

ParâmetroTipoDescrição
startAtstringData/hora de início da ISO 8601. A norma são os últimos 30 dias quando omitido.
endAtstringData/hora de término da ISO 8601. O padrão é agora quando omitido.
timezonestringFuso horário para agregacao (por ex., UTC, America/New_York). Recorre ao fuso horário configurado do seu site.
limitnumberNúmero máximo de linhas a retornar (1-1000, padrão: 100).
offsetnumberLinhas a pular para paginação (min 0, padrão: 0).

Parâmetros de filtro

ParâmetroTipoDescrição
filter_countrystringNome do país como retornado por /countries, ex.: United States. Use | para vários valores, ! para excluir e ~ para uma correspondência parcial.
filter_regionstringNome da região ou do estado como retornado por /regions, ex.: Califórnia.
filter_citystringNome da cidade.
filter_devicestringTipo de dispositivo: Desktop, Mobile ou Tablet. Os valores diferenciam maiúsculas de minúsculas.
filter_browserstringNome do navegador. Safari inclui automaticamente Mobile Safari.
filter_osstringSistema operacional.
filter_referrerstringReferência como retornada por /referrers: um nome de fonte como Google para sites reconhecidos, caso contrário o domínio.
filter_refstringParâmetro URL ref.
filter_sourcestringParâmetro URL source.
filter_viastringParâmetro URL via.
filter_utm_sourcestringFonte UTM.
filter_utm_mediumstringMeio UTM.
filter_utm_campaignstringCampanha UTM.
filter_utm_termstringTermo UTM.
filter_utm_contentstringConteúdo UTM.
filter_pagestringCaminho da página.
filter_entry_pagestringCaminho da página de entrada.
filter_hostnamestringHostname/domínio.
filter_channelstringCanal de marketing.
filter_goalstringNome do objetivo.
Exemplo de requisição (curl)
curl --request GET \
  --url https://analytics.flowsery.com/analytics/api/v1/referrers \
  --header 'Authorization: Bearer <api-key>'
200
{
  "status": "success",
  "data": [
    {
      "value": "x.com",
      "visitors": 3450,
      "revenue": 1240,
      "newRevenue": 1120,
      "renewalRevenue": 120,
      "percentage": 29.2,
      "iconUrl": "https://icons.duckduckgo.com/ip3/x.com.ico"
    },
    {
      "value": "Direct/None",
      "visitors": 2890,
      "revenue": 4560,
      "newRevenue": 3650,
      "renewalRevenue": 910,
      "percentage": 24.4,
      "iconUrl": null
    },
    {
      "value": "example.com",
      "visitors": 2150,
      "revenue": 2890,
      "newRevenue": 2280,
      "renewalRevenue": 610,
      "percentage": 18.2,
      "iconUrl": "https://icons.duckduckgo.com/ip3/example.com.ico"
    },
    {
      "value": "Google",
      "visitors": 1840,
      "revenue": 6780,
      "newRevenue": 5080,
      "renewalRevenue": 1700,
      "percentage": 15.6,
      "iconUrl": "https://icons.duckduckgo.com/ip3/google.com.ico"
    },
    {
      "value": "newsletter.example.com",
      "visitors": 1230,
      "revenue": 2150,
      "newRevenue": 1720,
      "renewalRevenue": 430,
      "percentage": 10.4,
      "iconUrl": "https://icons.duckduckgo.com/ip3/newsletter.example.com.ico"
    }
  ],
  "pagination": {
    "limit": 5,
    "offset": 0,
    "total": 119
  }
}