Search thread summaries
Thread-summary search supports only the metadata_filters filter, which matches the metadata of the thread episodes. Every other filter returns unsupported_filter.
Authentication
Type “Api-Key” followed by a space and the project API key.
Path parameters
Query parameters
The maximum number of items in one page. The SDK method returns a pager. In Python, .items holds only the first page. In TypeScript, .data holds only the first page. To read every page, iterate the pager: use for or list(...) in Python, or for await in TypeScript. In Go, the method returns one page, and Iterator() reads all pages. Search ranks a limited set of results, so iteration ends after that set. To get the top N results, set page_size to N and read the first page.
Request
Nodes used as BFS origins for graph-distance-aware retrieval.
The node to rank results by distance from. Required when reranker is node_distance.
The default is false. When true, Zep removes low-quality results at the knee of the cross-encoder score curve. The filter never removes a result with a score of 0.9 or more. It keeps at least 5 results, or all results when fewer than 5 are available. The filter only removes results, so a page still returns up to page_size results. Use this field only with reranker cross_encoder. It is not supported for episode search. Invalid combinations return a 400 error. The cutoff is approximate, not guaranteed. When the cross-encoder does not score the results, for example after a timeout, Zep returns the results without the filter.
Response
The cursor to pass as the next request’s cursor to fetch the following page; absent when no further pages remain.
Omitted for this collection; use next_cursor to detect the end of pagination.