Aquisição

Novos clientes ao longo do tempo

GET
/v1/acquisition/new-customers-over-time

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.

Autorização

ClientIdAuthClientSecretAuth
headerx-client-id<token>

Client ID

headerx-client-secret<token>

Client secret

Parâmetros de query

organizationId*string

Identificador da organização (obrigatório). Um valor ausente ou que não seja string resulta em 400.

period?stringDescontinuado

Descontinuado: 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.

Padrão"30d"
Valor em"7d""30d""90d""1y"
startDate?string

Iní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.

Formatodate
endDate?string

Fim 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.

Formatodate
gtmMotionId?string

GTM motion of the organization (UUID, as gtm_motions.id), V4MOS-2707. Omitted, or the default motion of the organization: the organization numbers, exactly as before. Another motion of the organization: /v1/acquisition/paid-media answers with that motion's own rows (investment, impressions, clicks, CRM leads and CPL from analytics.obt_cpl_daily_by_gtm_motion; Meta/Google platform leads and Meta reach are null, they have no motion grain yet); every other acquisition route answers 422 GTM_MOTION_DATA_NOT_AVAILABLE. Not a UUID: 400. Not a live motion of the organization: 403 GTM_MOTION_NOT_IN_ORGANIZATION.

Formatouuid

Corpo da resposta

Série de novos clientes retornada com sucesso

application/json
  1. 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&gtmMotionId=019a5b2e-7c4d-7abc-8def-0123456789ab"
{  "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        }      ]    }  ]}