> ## Documentation Index
> Fetch the complete documentation index at: https://docs.selltrust.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Prévia de Público

Calcula, sem enviar nada, quantos clientes um público alcança agora. Devolve a contagem, uma amostra dos emails, quantos ficaram de fora e uma estimativa de quanto a fila leva para terminar.

Regras disponíveis:

| `type` | Campos | Quem entra |
| - | - | - |
| `PURCHASED_LAST_DAYS` | `days` | Comprou nos últimos N dias |
| `NOT_PURCHASED_LAST_DAYS` | `days` | Já comprou, mas não nos últimos N dias |
| `NEVER_PURCHASED` | — | Tem cadastro ou pedido na loja, mas nenhum pedido aprovado |
| `PURCHASED_PRODUCT` | `product_id` | Comprou o produto (variações contam para o produto principal) |
| `PURCHASED_CATEGORY` | `category_id` | Comprou algo da categoria (subcategorias contam) |
| `USED_COUPON` | `coupon_code` | Usou o cupom em um pedido aprovado |
| `TOTAL_SPENT` | `operator` (`GT` ou `LT`), `value` | Total gasto maior ou menor que o valor |
| `ORDER_COUNT` | `operator` (`GT` ou `LT`), `value` | Número de pedidos aprovados maior ou menor que o valor |

> [!NOTE]
>
> Exige a permissão **Gerenciar Marketing** (`MANAGE_MARKETING`) do usuário que criou o token. Veja [Permissões do token](https://docs.selltrust.com.br/api-reference/permissions.md).

**Authorization** `string` *required*

Token de API no formato `Bearer stk_live_...`.

**audience** `object` *required*

Público a calcular.

**audience.match** `string` *required*

`ALL` (todas as regras) ou `ANY` (qualquer regra).

**audience.rules** `array` *required*

Até 20 regras. Vazio alcança todos os clientes.

```json Exemplo de corpo theme={null}
{
  "audience": {
    "match": "ALL",
    "rules": [
      {
        "type": "PURCHASED_LAST_DAYS",
        "days": 30
      },
      {
        "type": "TOTAL_SPENT",
        "operator": "GT",
        "value": 300
      }
    ]
  }
}
```

```json Response theme={null}
{
  "count": 128,
  "total_customers": 940,
  "excluded_unsubscribed": 3,
  "excluded_other": 1,
  "sample": [
    "ana@exemplo.com",
    "bruno@exemplo.com",
    "carla@exemplo.com"
  ],
  "limits": {
    "per_minute": 10,
    "per_hour": 120,
    "per_day": 640
  },
  "estimated_minutes": 64,
  "estimated_days": 0
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.