> ## Documentation Index
> Fetch the complete documentation index at: https://r2r-patch-fix-ingestion.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Vector Search

Vector search settings can be configured both server-side and at runtime. Runtime settings are passed as a dictionary to the search and RAG endpoints. You may refer to the [search API documentation here](/api-reference/endpoint/search) for additional materials.

Example using the Python SDK:

```python
vector_search_settings = {
    "use_vector_search": True,
    "filters": {"document_type": "article"},
    "search_limit": 20,
    "use_hybrid_search": True,
    "selected_collection_ids": ["c3291abf-8a4e-5d9d-80fd-232ef6fd8526"]
}

response = client.search("query", vector_search_settings=vector_search_settings)
```

#### Configurable Parameters

**VectorSearchSettings**

1. `use_vector_search` (bool): Whether to use vector search
2. `use_hybrid_search` (bool): Whether to perform a hybrid search (combining vector and keyword search)
3. `filters` (dict): Filters to apply to the vector search
4. `search_limit` (int): Maximum number of results to return (1-1000)
5. `selected_collection_ids` (list\[UUID]): Group IDs to search for
6. `index_measure` (IndexMeasure): The distance measure to use for indexing (cosine\_distance, l2\_distance, or max\_inner\_product)
7. `include_values` (bool): Whether to include search score values in the search results
8. `include_metadatas` (bool): Whether to include element metadata in the search results
9. `probes` (Optional\[int]): Number of ivfflat index lists to query (default: 10)
10. `ef_search` (Optional\[int]): Size of the dynamic candidate list for HNSW index search (default: 40)
11. `hybrid_search_settings` (Optional\[HybridSearchSettings]): Settings for hybrid search

**HybridSearchSettings**

1. `full_text_weight` (float): Weight to apply to full text search (default: 1.0)
2. `semantic_weight` (float): Weight to apply to semantic search (default: 5.0)
3. `full_text_limit` (int): Maximum number of results to return from full text search (default: 200)
4. `rrf_k` (int): K-value for RRF (Rank Reciprocal Fusion) (default: 50)

#### Advanced Filtering

R2R supports complex filtering using PostgreSQL-based queries. Allowed operators include:

* `eq`, `neq`: Equality and inequality
* `gt`, `gte`, `lt`, `lte`: Greater than, greater than or equal, less than, less than or equal
* `like`, `ilike`: Pattern matching (case-sensitive and case-insensitive)
* `in`, `nin`: Inclusion and exclusion in a list of values

Example of advanced filtering:

```python
filters = {
    "$and": [
        {"publication_date": {"$gte": "2023-01-01"}},
        {"author": {"$in": ["John Doe", "Jane Smith"]}},
        {"category": {"$ilike": "%technology%"}}
    ]
}
vector_search_settings["filters"] = filters
```