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

> ## Agent Instructions
> Conare's API is at https://api.conare.ai. Authenticate with `Authorization: Bearer $CONARE_API_KEY`.
> The full OpenAPI spec is at https://api.conare.ai/openapi.yaml; each endpoint has a page under /api-reference, and appending .md to any page URL returns its Markdown.
> Embed with model conare-embed-1; send input_type "query" for search queries. Rerank with conare-rerank-1.
> Prefer the TypeScript SDK (`npm install conare`) or plain HTTP in examples.
> Install the Conare skill with `npx skills add https://docs.conare.ai`; search these docs over MCP at https://docs.conare.ai/mcp; the whole site is at https://docs.conare.ai/llms-full.txt.

# Filtri

> Restringi una ricerca o un'eliminazione per metadati con gli operatori di uguaglianza, $in, intervallo, $and e $or, più le regole per testo, numeri e date.

Passa un filtro come `filter` a una [ricerca](https://docs.conare.ai/it/query.md) o a un'[eliminazione](https://docs.conare.ai/it/documents.md#eliminarne-molti) per trovare i documenti in base ai loro [metadati](https://docs.conare.ai/it/write.md#metadati).

```json theme={null}
{ "team": "support", "year": { "$gte": 2024 } }
```

Le chiavi affiancate devono corrispondere tutte.

## Operatori

| Operatore | Corrisponde a |
| - | - |
| `{ "key": value }`, `$eq` | Uguale al valore; su un array, contiene il valore |
| `$in` | Uguale a uno qualsiasi dei valori di una lista |
| `$ne`, `$nin` | Diverso dal valore, o da tutti quelli di una lista (solo ricerche) |
| `$gt`, `$gte`, `$lt`, `$lte` | Maggiore di, almeno, minore di, al massimo |
| `$and`, `$or` | Tutti, o uno qualsiasi, di una lista di filtri |

## Esempi

| Filtro | Corrisponde a |
| - | - |
| `{ "tags": "billing" }` | Documenti il cui array `tags` contiene `billing` |
| `{ "lang": { "$in": ["en", "de"] } }` | Documenti in inglese o in tedesco |
| `{ "$or": [{ "team": "support" }, { "year": { "$in": [2024, 2025] } }] }` | Documenti del team support, o qualsiasi documento del 2024 o del 2025 |
| `{ "published_at": { "$gte": "2025-06-01" } }` | Documenti pubblicati dal 1° giugno 2025 in poi |
| `{ "file_id": "report.pdf" }` | Un [file caricato](https://docs.conare.ai/it/files.md) |
| `{ "file_id": "report.pdf", "page": 3 }` | La pagina 3 di quel file |

## Regole

| Regola | |
| - | - |
| Uguaglianza | Confronta come testo: `3`, `3.0` e `"3"` corrispondono tra loro |
| Intervalli | Numeri con numeri, stringhe con stringhe, byte per byte; scrivi le date in ISO 8601 in un unico formato (`2025-06-01` o `2025-06-01T10:00:00Z`) |
| Mai in un intervallo | Booleani, elementi di array e stringhe oltre 222 byte |
| Chiavi mancanti | Un documento senza la chiave corrisponde a `$ne` e `$nin` |
| Negazioni | Una che esclude la maggior parte dei documenti può restituire meno risultati di `top_k` |
| Dimensione | Fino a 256 condizioni, annidate fino a 8 livelli; ogni `$and`, `$or` e `$in` multivalore conta uno |
| Liste | `$in` e `$nin` accettano fino a 255 valori |
| Chiavi sconosciute | Non vengono verificate: una chiave scritta male non corrisponde a nulla |
| Errori | Un filtro non valido restituisce `400 invalid_filter` |


## Related topics

- [Guida rapida](https://docs.conare.ai/it/quickstart.md)
- [Scrivere documenti](https://docs.conare.ai/it/write.md)
- [API turbopuffer](https://docs.conare.ai/it/turbopuffer.md)


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