# Filtrar lista

> Mantenha só os itens de uma lista que atendem às suas condições, como um campo com uma palavra ou uma data desde a última execução. Use AND ou OR.

Source: https://nodaro.ai/pt-BR/docs/nodes/automate/filter-list

O nó **Filtrar lista** (Filter List) mantém só os itens de uma lista que atendem às suas condições. Cada condição testa um campo de cada item, por exemplo `likes` maior que `1000`, ou `caption` contém `sale`. Combine várias condições com AND ou OR. Use o Filtrar lista para reduzir uma lista extraída ou gerada antes que cada item restante passe pelo próximo nó. O nó é gratuito.

- Found in: Automate › Lists & Batching
- Output: data
- API type: `filter-list`

## Quando usar
- Manter só os posts extraídos com curtidas suficientes antes de reescrevê-los.
- Manter só os itens do feed publicados desde a última execução agendada.
- Descartar os itens em que falta um campo, como posts sem vídeo.
- Deixar um lote menor, e mais barato, antes que ele passe por um nó pago.

## Início rápido
### Adicionar o nó
Pressione Tab no canvas e escolha **Automatizar › Listas e lotes › Filtrar lista**.

### Conectar uma lista
Conecte uma lista à entrada **Lista**, por exemplo do [**Extrair da web** (Web Scrape)](https://nodaro.ai/docs/nodes/automate/web-scrape), da [**Lista** (List)](https://nodaro.ai/docs/nodes/automate/list) ou do [**Dividir texto** (Split Text)](https://nodaro.ai/docs/nodes/automate/split-text). Quando o nó anterior tem um resultado, o painel de configurações mostra o primeiro item em **Amostra do nó anterior (primeiro item)**.

### Adicionar condições
Clique em **Adicionar condição**. Escolha um campo, um operador e um valor. Adicione mais condições e escolha **AND** ou **OR** para combiná-las.

### Executar
A saída **Filtrados** leva só os itens que passam. Para executar o próximo nó uma vez por item restante, mude essa conexão para **Cada item**.

Workflow: O Filtrar lista mantém os posts populares, o Extrair campo pega as legendas deles e o Prompt reescreve cada legenda.

- Instagram → Filtrar lista (lista)
- Filtrar lista → Extrair campo (origem)
- Extrair campo → Prompt (prompt · Cada item)

## Entradas e saídas
| Entrada ou saída | Aceita ou envia | O que faz |
| --- | --- | --- |
| **Lista** | Uma lista de itens de texto ou JSON | A lista a filtrar. Quando uma condição cita um campo, cada item é lido como JSON. |
| **Filtrados** | Uma lista | Os itens que passam nas condições, na ordem original. |

## Configurações
| Configuração | O que faz |
| --- | --- |
| **Condições** | Uma linha por teste: um campo, um operador e um valor. Sem condições, todos os itens passam. |
| **AND** ou **OR** | **AND** mantém um item que passa em todas as condições. **OR** mantém um item que passa em pelo menos uma. O padrão é **AND**. |
| **Diferenciar maiúsculas de minúsculas** | Ativado por padrão, então `Sale` e `sale` são diferentes. Desmarque para ignorar maiúsculas e minúsculas. |
| **Amostra do nó anterior (primeiro item)** | Uma prévia do primeiro item que chega, para você ver os campos dele. Os campos que as suas condições usam ficam marcados. |

### Cada condição
- **Campo** — escolha um campo detectado nos dados do nó anterior, **(item inteiro)** para testar o item inteiro, ou **Caminho personalizado…** para digitar um caminho com pontos, como `author.name`. **← Voltar à lista de campos** volta aos campos detectados.
- **Operador** — **é igual a**, **é diferente de**, **maior que**, **menor que**, **maior ou igual**, **menor ou igual**, **contém**, **não contém**, **começa com**, **termina com**, **corresponde à regex**, **existe** ou **não existe**. **existe** e **não existe** não precisam de valor.
- **Valor** — o valor com que comparar. Um botão ao lado dele alterna entre um valor digitado e uma variável.

## Filtrar por data
Alguns campos guardam uma data ou uma hora, como `created_at`, `published_at`, `timestamp`, `date` ou qualquer campo que termine em `_at` ou `Date`. Quando uma condição usa um desses campos com **maior que**, **menor que**, **maior ou igual** ou **menor ou igual**, o valor vira um seletor de data:

| Opção | Compara com |
| --- | --- |
| **Desde a última execução** | A hora em que o gatilho do workflow disparou pela última vez. Só funciona em execuções iniciadas por um gatilho ou por um agendamento. Uma execução manual trata essa opção como vazia. |
| **Últimas N horas** | Um momento N horas antes de agora. |
| **Últimos N dias** | Um momento N dias antes de agora. |
| **Últimas N semanas** | Um momento N semanas antes de agora. |
| **Personalizado…** | Qualquer data que você digitar. |

Por exemplo, `published_at` **maior que** **Últimos N dias**, com N igual a 1, mantém os itens publicados no último dia.

Os outros campos aceitam um valor digitado ou uma destas variáveis:

- `{{now}}` — a hora atual.
- `{{trigger.last_triggered_at}}` — a última vez que o gatilho do workflow disparou.
- `{{last_N_hours:3}}`, `{{last_N_days:1}}` e `{{last_N_weeks:2}}` — uma janela de tempo contada para trás a partir de agora. Mude o número para mudar a janela.

## Créditos
O Filtrar lista é gratuito.

## Dicas
- **Filtre antes de um lote.** Cada item que você descarta é uma execução do próximo nó que você não paga.
- **Processe só os itens novos.** Combine um [**Gatilho agendado** (Schedule Trigger)](https://nodaro.ai/docs/nodes/automate/schedule-trigger) com uma condição **Desde a última execução**, e cada execução trata só o que chegou desde a anterior.
- **Olhe a amostra primeiro.** Os nomes de campo em **Amostra do nó anterior (primeiro item)** são os nomes que as suas condições devem usar.
- **Escolha em vez de filtrar.** Para pegar um item ou uma fatia pela posição, use o [**Selecionar itens** (Selector)](https://nodaro.ai/docs/nodes/automate/selector). Para colocar a lista em ordem, use o [**Ordenar lista** (Sort List)](https://nodaro.ai/docs/nodes/automate/sort-list).

## Frequently asked questions

### Como mantenho só alguns itens de uma lista no Nodaro?

Adicione um nó “Filtrar lista” depois da lista, com uma condição por regra. Por exemplo, teste se um campo contém uma palavra ou se um número é maior que um limite. A saída “Filtrados” leva só os itens que passam.

### O “Filtrar lista” consegue manter só os itens novos desde a última execução?

Sim. Escolha um campo de data, como published_at, o operador “maior que” e o valor “Desde a última execução”. Isso funciona em execuções iniciadas por um gatilho ou por um agendamento; uma execução manual trata “Desde a última execução” como vazio.

### O “Filtrar lista” custa créditos?

Não. O “Filtrar lista” é gratuito. Filtrar uma lista antes de um lote também economiza créditos, porque cada item que você descarta é uma execução do próximo nó que você não paga.

### Qual é a diferença entre AND e OR?

AND mantém um item só quando ele passa em todas as condições. OR mantém um item quando ele passa em pelo menos uma condição. AND é o padrão.