Novos clientes ao longo do tempo
Série diária de novos clientes, com uma aba por canal, incluindo o canal Orgânico.
Use para gráficos de evolução dos clientes conquistados. total é a soma dos pontos de cada canal; somando todos os canais, o resultado bate com newCustomers de /v1/acquisition/summary.
A série é esparsa: dias sem novos clientes não aparecem. Preencha esses dias com zero no seu gráfico.
ClientIdAuthClientSecretAuthx-client-id<token>Client ID
x-client-secret<token>Client secret
organizationId*stringIdentificador da organização (obrigatório). Um valor ausente ou que não seja string resulta em 400.
period?stringDescontinuadoDescontinuado: use startDate e endDate, que têm precedência quando enviados. Período relativo de N dias terminando hoje, inclusive (7d = hoje e os 6 dias anteriores). "Hoje" é o dia de calendário em UTC, e esse último dia ainda está parcial. Valores aceitos: 7d, 30d, 90d, 1y. Omitido ou vazio equivale a 30d; qualquer outro valor retorna 400.
"30d""7d""30d""90d""1y"startDate?stringInício do período (YYYY-MM-DD, inclusivo). Envie junto com endDate: enviar só um dos dois retorna 400. Tem precedência sobre period. Use só a data: data com hora ou data inexistente retorna 400. Regras: startDate ≤ endDate, nenhuma data no futuro (UTC) e no máximo 365 dias entre as datas (até 366 dias no período). A comparação usa o período de mesma duração imediatamente anterior.
dateendDate?stringFim do período (YYYY-MM-DD, inclusivo). Veja startDate para as regras. Quando o fim é hoje, esse último dia ainda está parcial, porque os dados do dia continuam chegando.
dateSérie de novos clientes retornada com sucesso
application/json- response
tabs*array<>Uma aba por canal com dados no período, incluindo Orgânico. Lista vazia quando a organização não tem dados no período.
curl -X GET "https://example.com/v1/acquisition/new-customers-over-time?organizationId=c0ad4763-173e-4a05-9cff-5208c8ea5f6a&period=30d&startDate=2026-03-11&endDate=2026-03-22"{ "tabs": [ { "channel": "Meta Ads", "total": 42, "points": [ { "date": "2026-07-05", "newCustomers": 12 }, { "date": "2026-07-06", "newCustomers": 30 } ] }, { "channel": "Orgânico", "total": 9, "points": [ { "date": "2026-07-05", "newCustomers": 9 } ] } ]}