search

Get Search History

Get search history for the authenticated user.

This endpoint retrieves the search history for the authenticated user, returning a list of previously executed searches with their timestamps.

Response

Returns a list of search history items containing:

id: Unique identifier for the search
text: The search query text
user: User who performed the search
created_at: When the search was performed

Error Codes

500 Internal Server Error: Error retrieving search history

GET

/

api

/

v1

/

search

Get Search History

curl --request GET \
  --url https://api.cognee.ai/api/v1/search \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "text": "<string>",
    "user": "<string>",
    "createdAt": "2023-11-07T05:31:56Z"
  }
]

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

Successful Response

id

string<uuid>

required

text

string

required

user

string

required

createdAt

string<date-time>

required

SearchSearch for nodes in the graph database. This endpoint performs semantic search across the knowledge graph to find relevant nodes based on the provided query. It supports different search types and can be scoped to specific datasets. ## Request Parameters - **search_type** (SearchType): Type of search to perform - **datasets** (Optional[List[str]]): List of dataset names to search within - **dataset_ids** (Optional[List[UUID]]): List of dataset UUIDs to search within - **query** (str): The search query string - **system_prompt** Optional[str]: System prompt to be used for Completion type searches in Cognee - **node_name** Optional[list[str]]: Filter results to specific node_sets defined in the add pipeline (for targeted search). - **top_k** (Optional[int]): Maximum number of results to return (default: 10) - **only_context** bool: Set to true to only return context Cognee will be sending to LLM in Completion type searches. This will be returned instead of LLM calls for completion type searches. ## Response Returns a list of search results containing relevant nodes from the graph. ## Error Codes - **409 Conflict**: Error during search operation - **403 Forbidden**: User doesn't have permission to search datasets (returns empty list) ## Notes - Datasets sent by name will only map to datasets owned by the request sender - To search datasets not owned by the request sender, dataset UUID is needed - If permission is denied, returns empty list instead of error

⌘I

Get Search History

curl --request GET \
  --url https://api.cognee.ai/api/v1/search \
  --header 'Authorization: Bearer <token>'

[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "text": "<string>",
    "user": "<string>",
    "createdAt": "2023-11-07T05:31:56Z"
  }
]