---
title: "Semantic search over your memories"
method: GET
path: "/v1/memories/search"
tags: ["Memories"]
---

# Semantic search over your memories

`GET /v1/memories/search`

## Request

- Base URL: `https://api.chainmemory.ai`
- URL: `https://api.chainmemory.ai/v1/memories/search`
- Auth: API key in header `x-api-key`

The query text travels in the URL: the server embeds it, keeps it in its search log, and it appears in web server access logs. To keep the query off the server, use POST with a vector instead. Sealed memories appear only if their `embedding` was sent when they were stored; they come back without text and, in this text search, without their blob: use POST, or GET /v1/memory/{id}/blob, to decrypt them on the client. Score = 0.5 × semantic similarity + 0.3 × recency (one-week half-life) + 0.2 × importance/10.

## Query parameters

- `q` string, required
- `limit` integer

## Response `200`

Matches with a relevance score

---

[API](https://skmtc.dev/chainmemory/apis/chainmemory-api.md) · [All operations](https://skmtc.dev/chainmemory/apis/chainmemory-api/llms.txt) · [OpenAPI document](https://skmtc.dev/chainmemory/apis/chainmemory-api/revisions/5331e0f0b6af?raw)