Get New Customers Over Time
Daily series of new customers, with one tab per channel, the Orgânico (organic) channel included.
Use it for charts of customers won over time. total is the sum of each channel's points; summed across channels, it matches newCustomers from /v1/acquisition/summary.
The series is sparse: days with no new customer are omitted. Fill those days with zero in your chart.
ClientIdAuthClientSecretAuthx-client-id<token>Client ID
x-client-secret<token>Client secret
organizationId*stringOrganization identifier (required). A missing or non-string value is a 400.
period?stringDeprecatedDeprecated: use startDate and endDate, which take precedence when sent. Relative period of N days ending today, inclusive (7d = today and the 6 days before it). "Today" is the UTC calendar day, and that last day is still partial. Accepted values: 7d, 30d, 90d, 1y. Omitted or empty means 30d; any other value returns 400.
"30d""7d""30d""90d""1y"startDate?stringStart of the period (YYYY-MM-DD, inclusive). Send it together with endDate: sending only one of them returns 400. Takes precedence over period. Send the date only: a date with a time or a date that does not exist returns 400. Rules: startDate ≤ endDate, neither date in the future (UTC), and at most 365 days between the dates (up to 366 days in the period). The comparison uses the period of the same length right before it.
dateendDate?stringEnd of the period (YYYY-MM-DD, inclusive). See startDate for the rules. When the end date is today, that last day is still partial, because the day's data keeps arriving.
dateNew customers series returned successfully
application/json- response
tabs*array<>One tab per channel with data in the period, Orgânico (organic) included. Empty when the organization has no data in the period.
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 } ] } ]}