Items

Search saved Items

Search saved Items.

get/api/items/search

Request

  • Base URL: https://keep.md
  • URL: https://keep.md/api/items/search
  • Auth: one of:
    • HTTP bearer
    • API key in cookie keep.session_token

Query parameters

qstring required

Required search query

mode'lexical' | 'semantic' | 'hybrid'
integer
OR
string date-time

Unix timestamp or ISO date

integer
OR
string date-time

Unix timestamp or ISO date

statusstring

Comma-separated statuses. Archived and deleted Items are excluded when omitted.

collectionstring

Collection ID, name, or slug

tagsstring

Comma-separated tag names or slugs

sourcestring

Capture source or website

include'content'

Set to content to include saved content

limitinteger

Limit request parameter.

offsetinteger

Offset request parameter.

Headers

Keep-API-Versionstring
Example:2026-08-24

Optional date-based Keep API version. Omit it to use the current version.

Response

Matching Items

limitinteger required
offsetinteger required
countinteger required
totalinteger
hasMoreboolean

Changes

No recorded changes to this operation across all 1 revision of this API.