---
title: "Search Notes and saved Items in Keep | Keep"
description: "Search Notes and saved Items together. Filter results by source, tag, collection, Project, kind, or state."
canonical: "https://keep.md/docs/search"
language: "en"
---

# Search your Keep library

Search Notes and saved Items together. Filter results by source, tag, collection, Project, kind, or state.

Keep searches both [Notes](https://keep.md/docs/notes) and saved Items. It combines exact text matches with meaning-based matches.

## Use global search

Global search is the fastest way to find context or open part of the app.

1.  Press `Command K` on macOS or `Control K` on Windows and Linux.
2.  Enter words from the Note, Item, or topic.
3.  Select a result.

Results can include Notes, Items, recent Notes, pages, and actions. Note results can show the Project and the latest contributor. Item results can show the source, tags, and saved date.

Keep checks titles, URLs, Note bodies, Item notes, tags, and saved content. It can find a relevant result even when your search does not contain the exact words in that result.

Long searches are split into useful terms. A distinctive title stays ahead of weaker matches, and cue lists in session summaries help Keep recover a Note from the names or concepts you still remember.

## Filter global search

Start a search with one of these filters. Select a suggested value, then enter the rest of your search.

| Filter | Finds |
| --- | --- |
| `source:` | Items from one source or website |
| `tag:` or `#` | Notes and Items with one tag |
| `collection:` or `in:` | Items in one collection |
| `project:` | Notes in one Project |
| `kind:` | Notes with one kind |
| `state:` | Notes with one state |

Use quotation marks around a value that contains spaces.

```
project:"Keep website" session hooks
tag:research agent memory
kind:handoff state:open
source:youtube transcripts
in:"AI research" evaluation
```

## Filter the Feed

The search field in the [Feed](https://keep.md/docs/feed) searches Items only. Press `/` to focus it.

The Feed supports free text and these filters:

-   `source:` for a source or website
-   `tag:` or `#` for a tag
-   `collection:` or `in:` for a collection

You can combine filters with text.

```
authentication tag:security in:research
source:github agent tools
```

The Feed keeps the search and filters in the URL. You can open an Item and move to the previous or next matching Item without losing the search.

## Search from the CLI

`keep search` is the main CLI search command. It searches Notes and Items. In a Git repository, it also uses the repository and current path to rank relevant project context.

```
keep search "OAuth handoff"
keep notes search "OAuth handoff"
keep items search "OAuth handoff"
```

Use `keep notes search` or `keep items search` when you need one resource type. Note search returns bounded results and accepts the same `--project`, `--path`, `--exact-project`, and `--exact-path` filters as the main search command. `keep context` remains a compatibility alias for `keep search`.

See the [CLI guide](https://keep.md/docs/cli) for output and filtering options.

## Search with the API

Use `GET /api/search` to search Notes and Items together.

```
curl "https://keep.md/api/search?q=session%20handoff&types=note,item&mode=hybrid" \
  -H "Authorization: Bearer $KEEP_API_KEY"
```

Use `GET /api/notes/search` for Notes only. Use `GET /api/items/search` for Items only. Search mode can be `lexical`, `semantic`, or `hybrid`.

See the [API reference](https://keep.md/docs/api) for all parameters.