# SearchOp

> **Class** in `langgraph.store`

📖 [View in docs](https://reference.langchain.com/python/langgraph.store/base/SearchOp)

Operation to search for items within a specified namespace hierarchy.

This operation supports both structured filtering and natural language search
within a given namespace prefix. It provides pagination through limit and offset
parameters.

!!! note

    Natural language search support depends on your store implementation.

???+ example "Examples"

    Search with filters and pagination:

    ```python
    SearchOp(
        namespace_prefix=("documents",),
        filter={"type": "report", "status": "active"},
        limit=5,
        offset=10
    )
    ```

    Natural language search:

    ```python
    SearchOp(
        namespace_prefix=("users", "content"),
        query="technical documentation about APIs",
        limit=20
    )
    ```

## Signature

```python
SearchOp()
```

## Extends

- `NamedTuple`

## Properties

- `namespace_prefix`
- `filter`
- `limit`
- `offset`
- `query`
- `refresh_ttl`

---

[View source on GitHub](https://github.com/langchain-ai/langgraph/blob/916025d2f6d9f6ddb2628bd248bc4f3db632d9a8/libs/checkpoint/langgraph/store/base/__init__.py#L203)