Search Memory

curl --request POST \ --url 'https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes/search' \ --header 'Authorization: Bearer <YOUR_API_KEY>' \ --header 'Content-Type: application/json' \ --data ' { "user_id": "<string>", "query": "<string>", "max_results": 0, "rewrite": false, "rerank": false, "similarity_threshold": 0, "plan_version": "Pro" } '

Returns the most relevant historical memories to the current query based on semantic search. Supports query rewriting, result reranking, and similarity filtering.

Request parameters

Parameter	Type	Required	Description
`user_id`	string	Yes	Memory entity ID
`query`	string	Yes	Search query statement
`max_results`	number	No	Maximum number of results (1~100)
`rewrite`	boolean	No	Whether to rewrite the query to improve accuracy
`rerank`	boolean	No	Whether to rerank results
`similarity_threshold`	number	No	Similarity threshold (0.0~~1.0), recommended 0.5~~0.7
`plan_version`	string	No	`Pro` or `Lite`, defaults to Pro if not provided. Takes precedence over `rerank`

The Pro plan version enables Rerank for higher retrieval quality; the Lite plan version disables Rerank for lower cost. See Billing.

Code examples

curl -X POST https://dashscope.aliyuncs.com/api/v2/apps/memory/memory_nodes/search \
  --header "Authorization: Bearer $DASHSCOPE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "user_id": "user_001",
    "query": "我需要做什么？",
    "max_results": 10,
    "rewrite": true,
    "rerank": true,
    "similarity_threshold": 0.6
  }'

# response
{
  "memory_nodes": [
    {"content": "用户每天上午9点需要喝水提醒", "memory_node_id": "50b46e97..."},
    {"content": "用户明天10点需要整理会议纪要", "memory_node_id": "381cc694..."}
  ],
  "request_id": "a1b2c3d4-..."
}

To view all memories, use ListMemory.

Request parameters

Code examples

Authorizations

Body

Response

​Request parameters

​Code examples

Authorizations

Body

Response

Request parameters

Code examples