{
"results": [
{
"chunks": [
{
"content": "Rate limit headers are included in every response. Clients should implement exponential backoff when receiving 429 responses.",
"isRelevant": true,
"position": 3,
"score": 0.85
}
],
"createdAt": "1970-01-01T00:00:00.000Z",
"documentId": "doc_xyz789",
"metadata": {
"source": "upload",
"language": "en"
},
"score": 0.95,
"title": "API Rate Limiting Policy",
"updatedAt": "1970-01-01T00:00:00.000Z",
"type": "web",
"summary": "API rate limit policy: 100 req/min free, 1000 req/min pro.",
"content": "Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s."
}
],
"timing": 123,
"total": 123
}
{
"error": "Invalid request parameters",
"details": "Query must be at least 1 character long"
}
{
"error": "Invalid request parameters",
"details": "Query must be at least 1 character long"
}
{
"error": "Invalid request parameters",
"details": "Query must be at least 1 character long"
}
{
"error": "Invalid request parameters",
"details": "Query must be at least 1 character long"
}
{
"error": "Invalid request parameters",
"details": "Query must be at least 1 character long"
}
Authorizations
Authorization
string
header
required
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
q
string
required
Search query string
Minimum string length: 1
Example:
"what are the API rate limits"
chunkThreshold
number
default:0
Threshold / sensitivity for chunk selection. 0 is least sensitive (returns most chunks, more results), 1 is most sensitive (returns lesser chunks, accurate results)
Required range: 0 <= x <= 1
Example:
0.5
containerTag
string
Optional single container tag. Use this or containerTags.
Maximum string length: 100
Pattern: ^[a-zA-Z0-9_:-]+$
Example:
"user_alex"
containerTags
string[]
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.
Maximum string length: 100
Pattern: ^[a-zA-Z0-9_:-]+$
docId
string
Optional document ID to search within. You can use this to find chunks in a very large document.
Maximum string length: 255
documentThreshold
number
default:0
deprecated
DEPRECATED: This field is no longer used in v3 search. The search now uses chunkThreshold only. This parameter will be ignored.
Required range: 0 <= x <= 1
filters
object
Optional filters to apply to the search. Can be a JSON string or Query object.
Option 1
Option 2
Show child attributes
includeFullDocs
boolean
default:false
If true, include full document in the response. This is helpful if you want a chatbot to know the full context of the document.
Example:
false
includeSummary
boolean
default:false
If true, include document summary in the response. This is helpful if you want a chatbot to know the full context of the document.
limit
integer
default:10
Maximum number of results to return
Required range: 1 < x <= 100
Example:
10
onlyMatchingChunks
boolean
default:true
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.
rerank
boolean
default:false
If true, rerank the results based on the query. This is helpful if you want to ensure the most relevant results are returned.
Example:
false
rewriteQuery
boolean
default:false
If true, rewrites the query to make it easier to find documents. This increases the latency by about 400ms
Example:
false
categoriesFilter
string[]
deprecated
DEPRECATED: Optional category filters
filepath
string
Filter search results by filepath. Exact match for full paths, prefix match if ending with /
Response
Search results
results
object[]
required
Show child attributes
timing
number
required
total
number
required
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"supermemory | Memory API for the AI era","description":"Frontier agent memory and context platform","colors":{"primary":"#091120","light":"#F5F5F5","dark":"#091120"},"logo":{"light":"https://mintcdn.com/supermemory/1szAHJ3-ym4bjQ4U/logo/light.svg?fit=max\u0026auto=format\u0026n=1szAHJ3-ym4bjQ4U\u0026q=85\u0026s=e4571d11b31900b962a200bf7206e7d9","dark":"https://mintcdn.com/supermemory/1szAHJ3-ym4bjQ4U/logo/dark.svg?fit=max\u0026auto=format\u0026n=1szAHJ3-ym4bjQ4U\u0026q=85\u0026s=23c339f1eafcd1c5ad241c14d94dad53"},"favicon":{"light":"https://mintcdn.com/supermemory/p0zPjih-OxhkPwgX/favicon-light-mode.png?fit=max\u0026auto=format\u0026n=p0zPjih-OxhkPwgX\u0026q=85\u0026s=2f4fb184e0e1a2b9a5e9fd27d3aca4b7","dark":"https://mintcdn.com/supermemory/p0zPjih-OxhkPwgX/favicon-dark-mode.png?fit=max\u0026auto=format\u0026n=p0zPjih-OxhkPwgX\u0026q=85\u0026s=839400ffc6b2249c0930e3d7376b4459"},"api":{"openapi":"https://api.supermemory.ai/v4/openapi","examples":{"defaults":"required","languages":["typescript","python","bash"],"prefill":true}},"background":{"color":{"light":"#FFFFFF","dark":"#0A0A0A"}},"navbar":{"links":[{"href":"https://supermemory.ai/changelog","label":"Changelog"},{"href":"mailto:support@supermemory.com","label":"Support"}],"primary":{"type":"button","label":"Dashboard","href":"https://console.supermemory.ai"}},"footer":{"socials":{"github":"https://github.com/supermemoryai","linkedin":"https://linkedin.com/company/supermemory","x":"https://x.com/supermemory"}},"fonts":{"heading":{"family":"Geist","weight":500},"body":{"family":"Geist"}},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light-default","dark":"github-dark-default"}},"latex":false},"banner":{"content":"**v3 and v4 are deprecated and will be shut down on December 31, 2026.** Move to v5 before then. [Read the migration guide](/migration/api-v5).","dismissible":true},"contextual":{"options":["copy","view","assistant","chatgpt","claude","mcp","add-mcp","cursor","vscode","download-spec"],"display":"header"},"thumbnails":{"appearance":"dark","background":"https://mintcdn.com/supermemory/h0P1q8R9RVJPj3Y5/images/og-background.jpg?fit=max\u0026auto=format\u0026n=h0P1q8R9RVJPj3Y5\u0026q=85\u0026s=c415d91bd85a6db507dd36eb330edb9a","fonts":{"family":"Geist"}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"supermemory","hasAudioNarration":false,"actualSubdomain":"supermemory","customDomains":["supermemory.ai","docs.supermemory.ai"],"gitSource":{"type":"github","owner":"supermemoryai","repo":"supermemory","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afd1afc4aead03cc72c1b18","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"Developer platform","count":189},{"language":"default","tag":"API reference","count":91},{"language":"default","tag":"Developer platform (API)","count":75},{"language":"default","tag":"Using supermemory","count":31},{"language":"default","tag":"Plugins and MCP","count":24},{"language":"default","tag":"API integrations","count":23},{"language":"default","tag":"Connectors","count":19},{"language":"default","tag":"Migration guides","count":15},{"language":"default","tag":"Ingest","count":13},{"language":"default","tag":"Connections","count":11}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"enableAskAiSearchBar":true,"deflection":{"enabled":true,"email":"support@supermemory.com","showHelpButton":true}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6902c52aad086969d32e674e","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"User profiles and tool use together for multimodal use cases","status":"active","generatedBy":"manual","createdAt":"2025-10-30T01:53:46.092Z","updatedAt":"2025-10-30T01:53:46.092Z","__v":0},{"_id":"6902c51ead086969d32e6474","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"I am building XYZ. how do I use user profiles with the python SDK?","status":"active","generatedBy":"manual","createdAt":"2025-10-30T01:53:34.162Z","updatedAt":"2025-10-30T01:53:34.162Z","__v":0}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","href":"/docs/_mintlify/custom/supermemory/0ad5c1b8d894c2cb/style.css"}]}
{"page":{"pagePath":"api-reference/documents/search-documents","slug":"/api-reference/documents/search-documents","pageMetadata":{"title":"Search documents","description":"Search memories with advanced filtering","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/search","href":"/api-reference/documents/search-documents","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Search memories with advanced filtering\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light-default","dark":"github-dark-default"}},"config":{},"pageMetadata":{"title":"Search documents","description":"Search memories with advanced filtering","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/search","href":"/api-reference/documents/search-documents","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/supermemory/71b914845a04a595/theme-switch.js"],"openApiReferenceData":{"operation":{"operationId":"postV3Search","description":"Search memories with advanced filtering","responses":{"200":"aea047db-40ce-49a0-9594-60e916a3466d","400":"43b124d6-ba8c-486a-bf89-3078a8462d7f","401":"96d63be1-05e1-4c8b-9880-56bf1983701e","402":"baae1573-a88f-4beb-8703-079ca36b437a","404":"02b1d37a-9a74-480f-9adf-6dc875783ad3","500":"87af332f-df0d-4aa9-a2f9-c6673d843def"},"summary":"Search documents","tags":["Documents"],"requestBody":"697f77cf-cf04-4931-b757-168fe33905e0","x-codeSamples":[{"lang":"typescript","label":"TypeScript SDK","source":"import Supermemory from \"supermemory\";\n\nconst client = new Supermemory({\n apiKey: process.env.SUPERMEMORY_API_KEY,\n});\n\n// Document / SuperRAG search (chunk-level)\nconst results = await client.search.documents({\n q: \"gift policy for VP promotions\",\n containerTags: [\"user_123\"],\n limit: 5,\n});\n\nfor (const hit of results.results) {\n // document hits expose documentId + score (not memory-style id/similarity)\n console.log(hit.title ?? hit.documentId, hit.score);\n}"},{"lang":"python","label":"Python SDK","source":"from supermemory import Supermemory\n\nclient = Supermemory() # uses SUPERMEMORY_API_KEY\n\nresults = client.search.documents(\n q=\"gift policy for VP promotions\",\n container_tags=[\"user_123\"],\n limit=5,\n)\nfor hit in results.results:\n print(getattr(hit, \"title\", None) or hit.document_id, hit.score)"},{"lang":"bash","label":"cURL","source":"curl -X POST \"https://api.supermemory.ai/v3/search\" \\\n -H \"Authorization: Bearer $SUPERMEMORY_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"q\": \"gift policy for VP promotions\",\n \"containerTags\": [\"user_123\"],\n \"limit\": 5\n }'"}],"method":"post","type":"path","servers":["001dcd81-a783-4cbb-8e87-42d08573ab56"],"security":["86ef9429-c1ae-49e3-a7d5-72abd7c573b1"],"path":"/v3/search","baseUrlOptions":["https://api.supermemory.ai"],"title":"Search documents","codeSamples":[{"label":"TypeScript SDK","lang":"typescript","source":"import Supermemory from \"supermemory\";\n\nconst client = new Supermemory({\n apiKey: process.env.SUPERMEMORY_API_KEY,\n});\n\n// Document / SuperRAG search (chunk-level)\nconst results = await client.search.documents({\n q: \"gift policy for VP promotions\",\n containerTags: [\"user_123\"],\n limit: 5,\n});\n\nfor (const hit of results.results) {\n // document hits expose documentId + score (not memory-style id/similarity)\n console.log(hit.title ?? hit.documentId, hit.score);\n}"},{"label":"Python SDK","lang":"python","source":"from supermemory import Supermemory\n\nclient = Supermemory() # uses SUPERMEMORY_API_KEY\n\nresults = client.search.documents(\n q=\"gift policy for VP promotions\",\n container_tags=[\"user_123\"],\n limit=5,\n)\nfor hit in results.results:\n print(getattr(hit, \"title\", None) or hit.document_id, hit.score)"},{"label":"cURL","lang":"bash","source":"curl -X POST \"https://api.supermemory.ai/v3/search\" \\\n -H \"Authorization: Bearer $SUPERMEMORY_API_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"q\": \"gift policy for VP promotions\",\n \"containerTags\": [\"user_123\"],\n \"limit\": 5\n }'"}],"requestExampleLanguages":["typescript","python","bash"],"requiredOnlyExamples":true,"requestExampleType":"codeSamples","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[{"body.q":"what are the API rate limits","body.chunkThreshold":0.5,"body.containerTag":"user_alex","body.containerTags.items.0":"\u003cstring>","body.docId":"\u003cstring>","body.documentThreshold":0,"body.filters.oneOf.0.OR.items.0.oneOf.0.key":"\u003cstring>","body.filters.oneOf.0.OR.items.0.oneOf.0.value":"\u003cstring>","body.filters.oneOf.0.OR.items.0.oneOf.0.filterType":"metadata","body.filters.oneOf.0.OR.items.0.oneOf.0.negate.oneOf.0":true,"body.filters.oneOf.0.OR.items.0.oneOf.0.ignoreCase.oneOf.0":true,"body.filters.oneOf.0.OR.items.0.oneOf.0.numericOperator":"=","body.includeFullDocs":false,"body.includeSummary":false,"body.limit":10,"body.onlyMatchingChunks":true,"body.rerank":false,"body.rewriteQuery":false,"body.categoriesFilter.items.0":"\u003cstring>","body.filepath":"\u003cstring>"}]},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"q":{"type":"string","minLength":1,"description":"Search query string","example":"what are the API rate limits","isRequired":true,"uniqueKey":"q","typeLabel":"string"},"chunkThreshold":{"description":"Threshold / sensitivity for chunk selection. 0 is least sensitive (returns most chunks, more results), 1 is most sensitive (returns lesser chunks, accurate results)","example":0.5,"maximum":1,"minimum":0,"default":0,"type":"number","uniqueKey":"chunkThreshold","typeLabel":"number"},"containerTag":{"description":"Optional single container tag. Use this or containerTags.","example":"user_alex","type":"string","maxLength":100,"pattern":"^[a-zA-Z0-9_:-]+$","uniqueKey":"containerTag","typeLabel":"string"},"containerTags":{"description":"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.","type":"array","items":{"type":"string","maxLength":100,"pattern":"^[a-zA-Z0-9_:-]+$","uniqueKey":"containerTags.items.[INDEX]","typeLabel":"string"},"uniqueKey":"containerTags","typeLabel":"string[]"},"docId":{"description":"Optional document ID to search within. You can use this to find chunks in a very large document.","type":"string","maxLength":255,"uniqueKey":"docId","typeLabel":"string"},"documentThreshold":{"description":"DEPRECATED: This field is no longer used in v3 search. The search now uses chunkThreshold only. This parameter will be ignored.","maximum":1,"minimum":0,"deprecated":true,"default":0,"type":"number","uniqueKey":"documentThreshold","typeLabel":"number"},"filters":{"oneOf":[{"type":"object","description":"Optional filters to apply to the search. Can be a JSON string or Query object.","required":["OR"],"properties":{"OR":{"type":"array","items":{"oneOf":[{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["key","value"],"properties":{"key":{"type":"string","isRequired":true,"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.key","typeLabel":"string"},"value":{"type":"string","isRequired":true,"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.value","typeLabel":"string"},"filterType":{"default":"metadata","type":"string","enum":["metadata","numeric","array_contains","string_contains"],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.filterType","typeLabel":"enum\u003cstring>"},"negate":{"oneOf":[{"type":"boolean","uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.negate.oneOf.0","typeLabel":"boolean"},{"type":"string","enum":["true","false"],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.negate.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.negate","typeLabel":"boolean | enum\u003cstring>"},"ignoreCase":{"oneOf":[{"type":"boolean","uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.ignoreCase.oneOf.0","typeLabel":"boolean"},{"type":"string","enum":["true","false"],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.ignoreCase.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.ignoreCase","typeLabel":"boolean | enum\u003cstring>"},"numericOperator":{"default":"=","type":"string","enum":[">","\u003c",">=","\u003c=","="],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0.numericOperator","typeLabel":"enum\u003cstring>"}},"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["OR"],"properties":{"OR":{"type":"array","items":{"$circularRef":"82064fa3-2df4-4ded-9615-029c7d3b0813"},"description":"OR: Array of conditions or nested expressions","isRequired":true,"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.1.OR","typeLabel":"array"}},"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["AND"],"properties":{"AND":{"type":"array","items":{"$circularRef":"82064fa3-2df4-4ded-9615-029c7d3b0813"},"description":"AND: Array of conditions or nested expressions","isRequired":true,"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.2.AND","typeLabel":"array"}},"uniqueKey":"filters.oneOf.0.OR.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"filters.oneOf.0.OR.items.[INDEX]","typeLabel":"object"},"description":"Array of OR filter expressions","isRequired":true,"uniqueKey":"filters.oneOf.0.OR","typeLabel":"object[]"}},"uniqueKey":"filters.oneOf.0","typeLabel":"object"},{"type":"object","description":"Optional filters to apply to the search. Can be a JSON string or Query object.","required":["AND"],"properties":{"AND":{"type":"array","items":{"oneOf":[{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["key","value"],"properties":{"key":{"type":"string","isRequired":true,"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.key","typeLabel":"string"},"value":{"type":"string","isRequired":true,"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.value","typeLabel":"string"},"filterType":{"default":"metadata","type":"string","enum":["metadata","numeric","array_contains","string_contains"],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.filterType","typeLabel":"enum\u003cstring>"},"negate":{"oneOf":[{"type":"boolean","uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.negate.oneOf.0","typeLabel":"boolean"},{"type":"string","enum":["true","false"],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.negate.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.negate","typeLabel":"boolean | enum\u003cstring>"},"ignoreCase":{"oneOf":[{"type":"boolean","uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.ignoreCase.oneOf.0","typeLabel":"boolean"},{"type":"string","enum":["true","false"],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.ignoreCase.oneOf.1","typeLabel":"enum\u003cstring>"}],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.ignoreCase","typeLabel":"boolean | enum\u003cstring>"},"numericOperator":{"default":"=","type":"string","enum":[">","\u003c",">=","\u003c=","="],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0.numericOperator","typeLabel":"enum\u003cstring>"}},"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["OR"],"properties":{"OR":{"type":"array","items":{"$circularRef":"82064fa3-2df4-4ded-9615-029c7d3b0813"},"description":"OR: Array of conditions or nested expressions","isRequired":true,"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.1.OR","typeLabel":"array"}},"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.1","typeLabel":"object"},{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["AND"],"properties":{"AND":{"type":"array","items":{"$circularRef":"82064fa3-2df4-4ded-9615-029c7d3b0813"},"description":"AND: Array of conditions or nested expressions","isRequired":true,"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.2.AND","typeLabel":"array"}},"uniqueKey":"filters.oneOf.1.AND.items.[INDEX].oneOf.2","typeLabel":"object"}],"uniqueKey":"filters.oneOf.1.AND.items.[INDEX]","typeLabel":"object"},"description":"Array of AND filter expressions","isRequired":true,"uniqueKey":"filters.oneOf.1.AND","typeLabel":"object[]"}},"uniqueKey":"filters.oneOf.1","typeLabel":"object"}],"uniqueKey":"filters","typeLabel":"object"},"includeFullDocs":{"default":false,"description":"If true, include full document in the response. This is helpful if you want a chatbot to know the full context of the document. ","example":false,"type":"boolean","uniqueKey":"includeFullDocs","typeLabel":"boolean"},"includeSummary":{"default":false,"description":"If true, include document summary in the response. This is helpful if you want a chatbot to know the full context of the document. ","type":"boolean","uniqueKey":"includeSummary","typeLabel":"boolean"},"limit":{"default":10,"description":"Maximum number of results to return","example":10,"maximum":100,"minimum":1,"type":"integer","exclusiveMinimum":0,"uniqueKey":"limit","typeLabel":"integer"},"onlyMatchingChunks":{"default":true,"description":"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.","type":"boolean","uniqueKey":"onlyMatchingChunks","typeLabel":"boolean"},"rerank":{"default":false,"description":"If true, rerank the results based on the query. This is helpful if you want to ensure the most relevant results are returned.","example":false,"type":"boolean","uniqueKey":"rerank","typeLabel":"boolean"},"rewriteQuery":{"default":false,"description":"If true, rewrites the query to make it easier to find documents. This increases the latency by about 400ms","example":false,"type":"boolean","uniqueKey":"rewriteQuery","typeLabel":"boolean"},"categoriesFilter":{"description":"DEPRECATED: Optional category filters","deprecated":true,"type":"array","items":{"type":"string","uniqueKey":"categoriesFilter.items.[INDEX]","typeLabel":"string"},"uniqueKey":"categoriesFilter","typeLabel":"string[]"},"filepath":{"description":"Filter search results by filepath. Exact match for full paths, prefix match if ending with /","x-hidden":true,"type":"string","uniqueKey":"filepath","typeLabel":"string"}},"required":["q"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"q":"what are the API rate limits","chunkThreshold":0.5,"containerTag":"user_alex","containerTags":["\u003cstring>"],"docId":"\u003cstring>","documentThreshold":0,"filters":{"OR":[{"key":"\u003cstring>","value":"\u003cstring>","filterType":"metadata","negate":true,"ignoreCase":true,"numericOperator":"="}]},"includeFullDocs":false,"includeSummary":false,"limit":10,"onlyMatchingChunks":true,"rerank":false,"rewriteQuery":false,"categoriesFilter":["\u003cstring>"],"filepath":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"aea047db-40ce-49a0-9594-60e916a3466d":{"content":{"application/json":{"schema":{"type":"object","properties":{"results":{"type":"array","items":{"type":"object","properties":{"chunks":{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","description":"Content of the matching chunk","example":"Rate limit headers are included in every response. Clients should implement exponential backoff when receiving 429 responses.","isRequired":true,"uniqueKey":"results.items.[INDEX].chunks.items.[INDEX].content","typeLabel":"string"},"isRelevant":{"type":"boolean","description":"Whether this chunk is relevant to the query","example":true,"isRequired":true,"uniqueKey":"results.items.[INDEX].chunks.items.[INDEX].isRelevant","typeLabel":"boolean"},"position":{"type":"number","description":"Position of this chunk within the source document (0-indexed). Use it to order chunks and to locate surrounding context chunks (isRelevant=false) relative to the matching ones.","example":3,"isRequired":true,"uniqueKey":"results.items.[INDEX].chunks.items.[INDEX].position","typeLabel":"number"},"score":{"type":"number","description":"Similarity score for this chunk","example":0.85,"maximum":1,"minimum":0,"isRequired":true,"uniqueKey":"results.items.[INDEX].chunks.items.[INDEX].score","typeLabel":"number"}},"required":["content","isRelevant","position","score"],"description":"Matching content chunk","example":{"content":"Rate limit headers are included in every response. Clients should implement exponential backoff when receiving 429 responses.","isRelevant":true,"position":3,"score":0.85},"uniqueKey":"results.items.[INDEX].chunks.items.[INDEX]","typeLabel":"object"},"description":"Matching content chunks from the document","example":[{"content":"Rate limit headers are included in every response. Clients should implement exponential backoff when receiving 429 responses.","isRelevant":true,"position":3,"score":0.85}],"isRequired":true,"uniqueKey":"results.items.[INDEX].chunks","typeLabel":"object[]"},"createdAt":{"type":"string","description":"Document creation date","example":"1970-01-01T00:00:00.000Z","format":"datetime","isRequired":true,"uniqueKey":"results.items.[INDEX].createdAt","typeLabel":"string\u003cdatetime>"},"documentId":{"type":"string","description":"ID of the matching document","example":"doc_xyz789","isRequired":true,"uniqueKey":"results.items.[INDEX].documentId","typeLabel":"string"},"metadata":{"oneOf":[{"type":"object","description":"Document metadata","example":{"source":"upload","language":"en"},"additionalProperties":{"oneOf":[{}],"uniqueKey":"results.items.[INDEX].metadata.oneOf.0.additionalProperties","typeLabel":"any"},"isRequired":true,"uniqueKey":"results.items.[INDEX].metadata.oneOf.0","typeLabel":"object"},{"type":"null","description":"Document metadata","example":{"source":"upload","language":"en"},"isRequired":true,"uniqueKey":"results.items.[INDEX].metadata.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].metadata","typeLabel":"object | null"},"score":{"type":"number","description":"Relevance score of the match","example":0.95,"maximum":1,"minimum":0,"isRequired":true,"uniqueKey":"results.items.[INDEX].score","typeLabel":"number"},"title":{"oneOf":[{"description":"Document title","example":"API Rate Limiting Policy","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"description":"Document title","example":"API Rate Limiting Policy","type":"null","isRequired":true,"uniqueKey":"results.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].title","typeLabel":"string | null"},"updatedAt":{"type":"string","description":"Document last update date","example":"1970-01-01T00:00:00.000Z","format":"datetime","isRequired":true,"uniqueKey":"results.items.[INDEX].updatedAt","typeLabel":"string\u003cdatetime>"},"type":{"oneOf":[{"description":"Document type","example":"web","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].type.oneOf.0","typeLabel":"string"},{"description":"Document type","example":"web","type":"null","isRequired":true,"uniqueKey":"results.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"results.items.[INDEX].type","typeLabel":"string | null"},"summary":{"oneOf":[{"description":"Document summary","example":"API rate limit policy: 100 req/min free, 1000 req/min pro.","type":"string","uniqueKey":"results.items.[INDEX].summary.oneOf.0","typeLabel":"string"},{"description":"Document summary","example":"API rate limit policy: 100 req/min free, 1000 req/min pro.","type":"null","uniqueKey":"results.items.[INDEX].summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].summary","typeLabel":"string | null"},"content":{"oneOf":[{"description":"Full document content (only included when includeFullDocs=true)","example":"Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s.","type":"string","uniqueKey":"results.items.[INDEX].content.oneOf.0","typeLabel":"string"},{"description":"Full document content (only included when includeFullDocs=true)","example":"Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s.","type":"null","uniqueKey":"results.items.[INDEX].content.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].content","typeLabel":"string | null"}},"required":["chunks","createdAt","documentId","metadata","score","title","updatedAt","type"],"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results","typeLabel":"object[]"},"timing":{"type":"number","isRequired":true,"uniqueKey":"timing","typeLabel":"number"},"total":{"type":"number","isRequired":true,"uniqueKey":"total","typeLabel":"number"}},"required":["results","timing","total"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"results":[{"chunks":[{"content":"Rate limit headers are included in every response. Clients should implement exponential backoff when receiving 429 responses.","isRelevant":true,"position":3,"score":0.85}],"createdAt":"1970-01-01T00:00:00.000Z","documentId":"doc_xyz789","metadata":{"source":"upload","language":"en"},"score":0.95,"title":"API Rate Limiting Policy","updatedAt":"1970-01-01T00:00:00.000Z","type":"web","summary":"API rate limit policy: 100 req/min free, 1000 req/min pro.","content":"Our API rate limits are 100 req/min on free and 1000 on pro. Clients should use exponential backoff on 429s."}],"timing":123,"total":123}}},"exampleType":"generated"}},"description":"Search results","exampleType":"generated"},"43b124d6-ba8c-486a-bf89-3078a8462d7f":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"string","description":"Additional error details","example":"Query must be at least 1 character long","uniqueKey":"details","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid request parameters","details":"Query must be at least 1 character long"}}},"exampleType":"generated"}},"description":"Invalid request parameters","exampleType":"generated"},"96d63be1-05e1-4c8b-9880-56bf1983701e":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"string","description":"Additional error details","example":"Query must be at least 1 character long","uniqueKey":"details","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid request parameters","details":"Query must be at least 1 character long"}}},"exampleType":"generated"}},"description":"Unauthorized","exampleType":"generated"},"baae1573-a88f-4beb-8703-079ca36b437a":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"string","description":"Additional error details","example":"Query must be at least 1 character long","uniqueKey":"details","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid request parameters","details":"Query must be at least 1 character long"}}},"exampleType":"generated"}},"description":"Search quota or credits exhausted","exampleType":"generated"},"02b1d37a-9a74-480f-9adf-6dc875783ad3":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"string","description":"Additional error details","example":"Query must be at least 1 character long","uniqueKey":"details","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid request parameters","details":"Query must be at least 1 character long"}}},"exampleType":"generated"}},"description":"Document not found","exampleType":"generated"},"87af332f-df0d-4aa9-a2f9-c6673d843def":{"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string","description":"Error message","example":"Invalid request parameters","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"details":{"type":"string","description":"Additional error details","example":"Query must be at least 1 character long","uniqueKey":"details","typeLabel":"string"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid request parameters","details":"Query must be at least 1 character long"}}},"exampleType":"generated"}},"description":"Server error","exampleType":"generated"}},"security":{"86ef9429-c1ae-49e3-a7d5-72abd7c573b1":{"bearerAuth":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"001dcd81-a783-4cbb-8e87-42d08573ab56":{"description":"Production Server","url":"https://api.supermemory.ai"}},"schemas":{"82064fa3-2df4-4ded-9615-029c7d3b0813":{"oneOf":[{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["key","value"],"properties":{"key":{"type":"string","isRequired":true},"value":{"type":"string","isRequired":true},"filterType":{"default":"metadata","type":"string","enum":["metadata","numeric","array_contains","string_contains"]},"negate":{"oneOf":[{"type":"boolean"},{"type":"string","enum":["true","false"]}]},"ignoreCase":{"oneOf":[{"type":"boolean"},{"type":"string","enum":["true","false"]}]},"numericOperator":{"default":"=","type":"string","enum":[">","\u003c",">=","\u003c=","="]}}},{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["OR"],"properties":{"OR":{"type":"array","items":{"$circularRef":"82064fa3-2df4-4ded-9615-029c7d3b0813"},"description":"OR: Array of conditions or nested expressions","isRequired":true}}},{"type":"object","description":"A single filter condition or a nested AND/OR expression. The API validates up to 5 levels of nesting.","required":["AND"],"properties":{"AND":{"type":"array","items":{"$circularRef":"82064fa3-2df4-4ded-9615-029c7d3b0813"},"description":"AND: Array of conditions or nested expressions","isRequired":true}}}]}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"https://api.supermemory.ai/v4/openapi"},"subdomain":"supermemory","siteName":"supermemory | Memory API for the AI era","title":"Search documents - supermemory | Memory API for the AI era","contextualStarterQuestions":[{"_id":"69e95e72c82b27b92a35aa4a","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"What filters are available?","status":"active","generatedBy":"contextual","path":"api-reference/documents/search-documents","createdAt":"2026-04-22T23:49:06.494Z","updatedAt":"2026-04-22T23:49:06.494Z","__v":0},{"_id":"69e95e72c82b27b92a35aa49","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"How do I search documents?","status":"active","generatedBy":"contextual","path":"api-reference/documents/search-documents","createdAt":"2026-04-22T23:49:06.494Z","updatedAt":"2026-04-22T23:49:06.494Z","__v":0},{"_id":"69e95e72c82b27b92a35aa4b","deploymentId":"679c28b9bb8558c304aa0d79","questionText":"Can I search by metadata?","status":"active","generatedBy":"contextual","path":"api-reference/documents/search-documents","createdAt":"2026-04-22T23:49:06.494Z","updatedAt":"2026-04-22T23:49:06.494Z","__v":0}],"navMaps":{"firstHrefInVersion":{"Legacy (v3, v4)":{"href":"/api-reference/documents/search-documents","matchLevel":0},"Latest (v5)":{"href":"/v5/api-reference/overview","matchLevel":3}},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T18:43:18.229Z","originalFileLocation":"api-reference/documents/search-documents.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Search memories with advanced filtering\">\u003cmeta data-mint-head name=\"application-name\" content=\"supermemory | Memory API for the AI era\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Search documents - supermemory | Memory API for the AI era\">\u003cmeta data-mint-head property=\"og:description\" content=\"Search memories with advanced filtering\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"supermemory | Memory API for the AI era\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://supermemory.ai/docs/api-reference/documents/search-documents\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://supermemory.mintlify.site/docs/_mintlify/api/og/v2?division=Recall\u0026amp;title=Search+documents\u0026amp;description=Search+memories+with+advanced+filtering\u0026amp;theme=f0b184f649948bfd607431b4\u0026amp;signature=375a073144ebeba2269144bb476cafc76ebd3f1598321b802c42a1d2bc36017b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Search documents - supermemory | Memory API for the AI era\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Search memories with advanced filtering\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://supermemory.mintlify.site/docs/_mintlify/api/og/v2?division=Recall\u0026amp;title=Search+documents\u0026amp;description=Search+memories+with+advanced+filtering\u0026amp;theme=f0b184f649948bfd607431b4\u0026amp;signature=375a073144ebeba2269144bb476cafc76ebd3f1598321b802c42a1d2bc36017b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/supermemory/GrDCAjqJehqOwU42/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"supermemory | Memory API for the AI era\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#091120\">\u003clink data-mint-head rel=\"canonical\" href=\"https://supermemory.ai/docs/api-reference/documents/search-documents\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/api-reference/documents/search-documents.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://supermemory.ai/#organization\",\"name\":\"supermemory | Memory API for the AI era\",\"url\":\"https://supermemory.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/supermemory/1szAHJ3-ym4bjQ4U/logo/light.svg?fit=max\u0026auto=format\u0026n=1szAHJ3-ym4bjQ4U\u0026q=85\u0026s=e4571d11b31900b962a200bf7206e7d9\"}},{\"@type\":\"WebSite\",\"@id\":\"https://supermemory.ai/docs#website\",\"name\":\"supermemory | Memory API for the AI era\",\"url\":\"https://supermemory.ai/docs\",\"publisher\":{\"@id\":\"https://supermemory.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://supermemory.ai/docs/api-reference/documents/search-documents#webpage\",\"url\":\"https://supermemory.ai/docs/api-reference/documents/search-documents\",\"name\":\"Search documents\",\"description\":\"Search memories with advanced filtering\",\"dateModified\":\"2026-11-02T18:43:18.229Z\",\"isPartOf\":{\"@id\":\"https://supermemory.ai/docs#website\"},\"breadcrumb\":{\"@id\":\"https://supermemory.ai/docs/api-reference/documents/search-documents#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://supermemory.ai/docs/api-reference/documents/search-documents#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Recall\",\"item\":\"https://supermemory.ai/docs/api-reference/search\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Search documents\",\"item\":\"https://supermemory.ai/docs/api-reference/documents/search-documents\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://supermemory.ai/docs/api-reference/documents/search-documents#apireference\",\"headline\":\"Search documents\",\"name\":\"Search documents\",\"description\":\"Search memories with advanced filtering\",\"url\":\"https://supermemory.ai/docs/api-reference/documents/search-documents\",\"mainEntityOfPage\":{\"@id\":\"https://supermemory.ai/docs/api-reference/documents/search-documents#webpage\"},\"dateModified\":\"2026-11-02T18:43:18.229Z\",\"publisher\":{\"@id\":\"https://supermemory.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://supermemory.ai/docs#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"supermemory | Memory API for the AI era\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"supermemory | Memory API for the AI era\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/api-reference/documents/search-documents.md","siteName":"supermemory | Memory API for the AI era","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":""}]},{"tab":"Developer platform","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/source-code.svg","anchors":[{"anchor":"Developer platform (API)","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","pages":[{"title":"Developer platform (API)","href":"/overview/what-is-supermemory"}]},{"anchor":"API integrations","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/plug-01.svg","pages":[{"title":"API integrations","href":"/integrations/supermemory-sdk"}]},{"anchor":"API reference","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/plug-socket.svg","versions":[{"version":"Legacy (v3, v4)","pages":[{"title":"API reference","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/plug-socket.svg","href":"/api-reference/overview"},{"title":"API keys \u0026 auth","sidebarTitle":"API keys","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/key-01.svg","href":"/authentication"},{"group":"Ingest","icon":"/icons/hugeicons/download-01.svg","pages":[{"title":"Ingest","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/ingest"},{"title":"Add document","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/documents","href":"/api-reference/ingest/add-document"},{"title":"Upload a file","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/documents/file","href":"/api-reference/ingest/upload-a-file"},{"title":"Batch add documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/documents/batch","href":"/api-reference/ingest/batch-add-documents"},{"title":"Ingest or update conversation","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/conversations","href":"/api-reference/ingest/ingest-or-update-conversation"},{"title":"Get document","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/documents/{id}","href":"/api-reference/documents/get-document"}]},{"group":"Recall","icon":"/icons/hugeicons/search-01.svg","pages":[{"title":"Recall","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/search"},{"title":"Search memory entries","description":"Search memory entries - Low latency for conversational","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/search","href":"/api-reference/recall-search/search-memory-entries"},{"title":"Search documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/search","href":"/api-reference/documents/search-documents"},{"title":"Profiles","sidebarTitle":"Profiles overview","description":"Static and dynamic facts about an entity, scoped to a container.","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/id.svg","href":"/api-reference/profiles"},{"title":"Get user profile","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/profile","href":"/api-reference/profiles/get-user-profile"},{"title":"Get profile buckets","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/profile/buckets","href":"/api-reference/profiles/get-profile-buckets"}]},{"group":"Documents","icon":"/icons/hugeicons/file-02.svg","pages":[{"title":"Documents","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/documents"},{"title":"List documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/documents/list","href":"/api-reference/documents/list-documents"},{"title":"Get processing documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/documents/processing","href":"/api-reference/documents/get-processing-documents"},{"title":"Update document","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi patch /v3/documents/{id}","href":"/api-reference/ingest/update-document"},{"title":"Delete document by ID or customId","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi delete /v3/documents/{id}","href":"/api-reference/ingest/delete-document-by-id-or-customid"},{"title":"Bulk delete documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi delete /v3/documents/bulk","href":"/api-reference/ingest/bulk-delete-documents"},{"title":"Get document chunks","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/documents/{id}/chunks","href":"/api-reference/documents/get-document-chunks"},{"title":"Get presigned file URL","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/documents/{id}/file-url","href":"/api-reference/documents/get-presigned-file-url"}]},{"group":"Memories","icon":"/icons/hugeicons/database-01.svg","pages":[{"title":"Memories","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/memories"},{"title":"Create memories directly","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/memories","href":"/api-reference/content-management/create-memories-directly"},{"title":"List memory entries with history","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/memories/list","href":"/api-reference/content-management/list-memory-entries-with-history"},{"title":"Update a memory (creates new version)","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi patch /v4/memories","href":"/api-reference/content-management/update-a-memory-creates-new-version"},{"title":"Forget a memory","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi delete /v4/memories","href":"/api-reference/content-management/forget-a-memory"},{"title":"Forget memories matching a prompt/query","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v4/memories/forget-matching","href":"/api-reference/content-management/forget-memories-matching-a-promptquery"}]},{"group":"Container tags","icon":"/icons/hugeicons/tag-01.svg","pages":[{"title":"Container tags","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/container-tags"},{"title":"List all container tags","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/container-tags/list","href":"/api-reference/container-tags/list-all-container-tags"},{"title":"Get container tag settings","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/container-tags/{containerTag}","href":"/api-reference/container-tags/get-container-tag-settings"},{"title":"Update container tag settings","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi patch /v3/container-tags/{containerTag}","href":"/api-reference/container-tags/update-container-tag-settings"},{"title":"Delete container tag","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi delete /v3/container-tags/{containerTag}","href":"/api-reference/container-tags/delete-container-tag"},{"title":"Merge container tags","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/container-tags/merge","href":"/api-reference/container-tags/merge-container-tags"},{"title":"Get container tag merge status","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/container-tags/merge/{mergeId}","href":"/api-reference/container-tags/get-container-tag-merge-status"}]},{"group":"Connections","icon":"/icons/hugeicons/plug-01.svg","pages":[{"title":"Connections","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/connections"},{"title":"Create connection","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/connections/{provider}","href":"/api-reference/connections/create-connection"},{"title":"List connections","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/connections/list","href":"/api-reference/connections/list-connections"},{"title":"Get connection (by id)","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/connections/{connectionId}","href":"/api-reference/connections/get-connection-by-id"},{"title":"Configure connection","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/connections/{connectionId}/configure","href":"/api-reference/connections/configure-connection"},{"title":"Fetch resources","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/connections/{connectionId}/resources","href":"/api-reference/connections/fetch-resources"},{"title":"Sync connection","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/connections/{provider}/import","href":"/api-reference/connections/sync-connection"},{"title":"List documents","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/connections/{provider}/documents","href":"/api-reference/connections/list-documents"},{"title":"Get connection (by provider)","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/connections/{provider}/connection","href":"/api-reference/connections/get-connection-by-provider"},{"title":"Delete connection by ID","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi delete /v3/connections/{connectionId}","href":"/api-reference/connections/delete-connection-by-id"},{"title":"Delete connection","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi delete /v3/connections/{provider}","href":"/api-reference/connections/delete-connection"}]},{"group":"Settings","icon":"/icons/hugeicons/settings-01.svg","pages":[{"title":"Settings","sidebarTitle":"Overview","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/book-open-01.svg","href":"/api-reference/settings"},{"title":"Get settings","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi get /v3/settings","href":"/api-reference/settings/get-settings"},{"title":"Update settings","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi patch /v3/settings","href":"/api-reference/settings/update-settings"},{"title":"Suggest profile buckets","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/settings/suggest-buckets","href":"/api-reference/settings/suggest-profile-buckets"},{"title":"Reset organization data","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /v3/settings/reset","href":"/api-reference/settings/reset-organization-data"}]},{"group":"Feedback","pages":[{"title":"Send feedback","deprecated":null,"version":null,"openapi":"https://api.supermemory.ai/v4/openapi post /feedback","href":"/api-reference/feedback/send-feedback"}]}]},{"version":"Latest (v5)","default":true,"pages":[{"title":"Latest (v5)","href":"/v5/api-reference/overview"}]}]}]},{"tab":"Plugins and MCP","icon":"https://mintlify.s3.us-west-1.amazonaws.com/supermemory/icons/hugeicons/puzzle.svg","pages":[{"title":"Plugins and MCP","href":"/supermemory-mcp/mcp"}]}]},"basePath":"","title":"Search documents - supermemory | Memory API for the AI era","deploymentId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","buildId":"dpl_2MqcLy8smQrrovUehgcZEsoo1tJX","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-c3oKHz6v.js","dist-CLdzWocy.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-DyP0AOE1.js","snippetPresets-CuYPAUIG.js","utils-ez5j6NBT.js","style-to-object-BY3JEAdk.js","utils-DG4aeUOF.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DFhcMUrP.js","conditional-requirements-CFM0id0Q.js","cloneDeep-ByDTqllG.js","_Uint8Array-CJ2WjX_H.js","isObject-FP1Yky1u.js","ApiExamples-fyn9sMD9.js","usePlaygroundInputsStore-Bf0N_Y6L.js","shallow-CnU26VTn.js","isEqual-OWIKZzop.js","CodeSnippets-CZ9-M31v.js","CodeSnippet-CCk6UVRR.js","getApiPlaygroundDisplay-BUw5JwZB.js","Page-CInwEL5w.js","DynamicMarkdown-CU5QIokU.js","SectionHeading-BoT1NwPU.js","icon-MsvNhD56.js","MethodPill-CC7p0-fp.js","getPastedJson-BOWYR2ND.js","DuplicateIcon-DOWJyC1b.js","createIcon-BsNyCaLY.js","axios-CsQoIw0U.js","Markdown-L0uigQE0.js","AssistantPageLink-Cur5OU4v.js"]}