Items

Read an Item overview, search window, line range, or full document

Read an Item overview, search window, line range, or full document.

get/api/items/{id}/read

Request

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

Path parameters

idstring required

Saved Item ID

Query parameters

view'overview' | 'search' | 'lines' | 'full'
headingLimitinteger
linesstring

Required for lines view. Maximum 200 lines.

qstring

Required for search view

contextLinesinteger
limitinteger

Headers

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

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

Response

Bounded Item read

object required

Search windows total at most 200 lines and 16000 UTF-8 bytes. Exact slices contain at most 200 lines and 32000 UTF-8 bytes.

Changes

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