Search nodes
Node search does not support edge_types, exclude_edge_types, edge_uuids, connected_node_uuids, source_node_uuids, target_node_uuids, date_filters, or content_policy_violated. content_policy_violated is supported on episode search only. The edge filters select edges. To get the nodes that an edge connects, use graph.search_edges or graph.node.list_neighbors. To filter nodes by created_at, use graph.node.list.
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.