Buscar clientes por evento
Retorna a audiência (a lista de clientes) que têm um evento registrado em
person_event de um dado type, opcionalmente filtrado por termos de texto livre
e uma janela de data. É a busca de audiência genérica por evento — o mesmo motor do
filtro QON event, exposto como um GET simples.
Genérico por type:
type=buy_product— clientes que compraram um produto;terms[]casam o nome do produto (description), todos os termos com AND (substring, insensível a caixa e acento). Ex.:terms[]=tennis&terms[]=pretocasa quem comprou "calçado tennis nike 42 preto e branco".type=membership_joined— clientes que se inscreveram na janela; semterms(eventos de membership não têmdescription).- qualquer tipo futuro (
abandoned_cart,app_open, …) funciona igual.
from/to (YYYY-MM-DD) limitam occurredAt (to é exclusivo no dia seguinte).
Escopo: este endpoint resolve só o critério de evento. A composição
demográfica/comportamental (gênero, idade, RFM, tag, tier) é responsabilidade do
audience builder via o filtro QON event — ver Internal › Services › Register ›
Audiência por evento.
Auth: signature RSA serviço-a-serviço (ver Internal › Integração › Signature).
A organização vem do contexto da requisição.
Exemplos na prática
Clientes que compraram um produto cujo nome contém "tennis" E "preto", em 2026:
GET /api/register/event/search?type=buy_product&terms[]=tennis&terms[]=preto&from=2026-01-01&to=2026-07-01
Clientes que se inscreveram (membership) na mesma janela (sem termos):
GET /api/register/event/search?type=membership_joined&from=2026-01-01&to=2026-07-01
Resposta (AudienceResult — paginado; entries=0 faz streaming de tudo):
{
"total": 144262,
"data": [
{ "id": 4293432, "name": "John Doe", "email": "j@x.com", "gender": "male" }
],
"pagination": { "entries": 50, "totalPages": 2886, "currentPage": 1, "isInitial": true, "isEnd": false }
}Try-it values populated from environment ACME (Demo)
Autenticação
Token
Send your user token in the x-guper-authorization header.