> For the complete documentation index, see [llms.txt](https://docs.aios.foundation/aios-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aios.foundation/aios-docs/aios-agent-sdk/memory-api/search_memories.md).

# search\_memories

**Function**: `search_memories()`\
**Purpose**: Find relevant memories using natural language\
**Parameters**:

* `agent_name`: Namespace identifier
* `query`: Search phrase
* `k`: Maximum results (default:5)

**Example**:

```python
search_memories(
    agent_name="project_bot",
    query="timeline changes",
    k=3
)
```

**Response**:

```json
{
    "success": true,
    "search_results": [
        {
            "memory_id": "mem_abc123",
            "content": "Updated timeline decision...",
            "score": 0.92,
            "metadata": {...}
        }
    ],
    "error": null
}
```