Search documents
Search memories with advanced filtering
Body ParametersJSONExpand Collapse
Threshold / sensitivity for chunk selection. 0 is least sensitive (returns most chunks, more results), 1 is most sensitive (returns lesser chunks, accurate results)
Optional tags this search should be containerized by. This can be an ID for your user, a project ID, or any other identifier you wish to use to filter documents.
Optional document ID to search within. You can use this to find chunks in a very large document.
DEPRECATED: This field is no longer used in v3 search. The search now uses chunkThreshold only. This parameter will be ignored.
Filter search results by filepath. Exact match for full paths, prefix match if ending with /
filters: optional object { OR } or object { AND } Optional filters to apply to the search. Can be a JSON string or Query object.
Optional filters to apply to the search. Can be a JSON string or Query object.
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } Array of OR filter expressions
Array of OR filter expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } Array of AND filter expressions
Array of AND filter expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
OR: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } OR: Array of conditions or nested expressions
OR: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
And object { AND }
AND: array of object { key, value, filterType, 3 more } or object { OR } or object { AND } AND: Array of conditions or nested expressions
AND: Array of conditions or nested expressions
object { key, value, filterType, 3 more } A single filter condition based on metadata, numeric values, array contents, or string matching
A single filter condition based on metadata, numeric values, array contents, or string matching
Or object { OR }
If true, include full document in the response. This is helpful if you want a chatbot to know the full context of the document.
If true, include document summary in the response. This is helpful if you want a chatbot to know the full context of the document.
If true, only return matching chunks without context. Normally, we send the previous and next chunk to provide more context for LLMs. If you only want the matching chunk, set this to true.
Search documents
curl https://api.supermemory.ai/v3/search \
-H 'Content-Type: application/json' \
-H "Authorization: Bearer $SUPERMEMORY_API_KEY" \
-d '{
"q": "what are the API rate limits",
"chunkThreshold": 0.5,
"containerTag": "user_alex",
"limit": 10
}'{
"results": [
{
"chunks": [
{
"content": "Rate limit headers are included in every response. Clients should implement exponential backoff when receiving 429 responses.",
"isRelevant": true,
"score": 0.85
}
],
"createdAt": "1970-01-01T00:00:00.000Z",
"documentId": "doc_xyz789",
"metadata": {
"source": "bar",
"language": "bar"
},
"score": 0.95,
"title": "API Rate Limiting Policy",
"type": "web",
"updatedAt": "1970-01-01T00:00:00.000Z",
"content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s.",
"summary": "API rate limit policy: 100 req/min free, 1000 req/min pro."
}
],
"timing": 0,
"total": 0
}Returns Examples
{
"results": [
{
"chunks": [
{
"content": "Rate limit headers are included in every response. Clients should implement exponential backoff when receiving 429 responses.",
"isRelevant": true,
"score": 0.85
}
],
"createdAt": "1970-01-01T00:00:00.000Z",
"documentId": "doc_xyz789",
"metadata": {
"source": "bar",
"language": "bar"
},
"score": 0.95,
"title": "API Rate Limiting Policy",
"type": "web",
"updatedAt": "1970-01-01T00:00:00.000Z",
"content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s.",
"summary": "API rate limit policy: 100 req/min free, 1000 req/min pro."
}
],
"timing": 0,
"total": 0
}