Bookmarks

Fetch Saved Posts

Retrieve all the bookmarks that you've created. You can use the query parameters to filter and paginate results.

GET /v1/bookmarks is the endpoint most integrations start with. It returns the LinkedIn posts (and saved comments) the authenticated account has collected in LinkedMash, newest first, as a cursor-paginated list. Each item carries the post text, permalink, attachments, the author's name, bio and profile image, your labels, read and archive state, and both posted_at and imported_at timestamps — enough to mirror a library into another system without a second call.

The same filters the LinkedMash web app uses are exposed here, and they behave identically: read and unread posts are both returned unless you ask otherwise, and archived posts are hidden by default. Keyword search (q) matches post content; vector_search_term runs semantic search over the same library and needs a vector store that has been initialised at least once.

get/v1/bookmarks

Request

  • Base URL: https://api.linkedmash.com
  • URL: https://api.linkedmash.com/v1/bookmarks
  • Auth: one of:
    • OAuth 2 (client credentials, token URL https://api.linkedmash.com/auth/oauth/token, scopes: library:read)
    • HTTP bearer
    • API key in header linkedmash-api-key

Query parameters

limitinteger
Example:20

The maximum number of bookmarks to return. Default is 20, maximum is 100.

cursorstring

Cursor for pagination. Use the next_cursor value from a previous response.

is_unread_onlyboolean

Return only unread posts. Defaults to false — read and unread are both returned unless you set this to true.

hide_archivedboolean

Filter by archived status. Default is true (hides archived bookmarks).

media_typestring

Filter by media type. Must be one of image, video or pdf; any other value returns 400. Paid plans.

commentstring

Filter by comment: 'only' returns just saved comments, 'exclude' returns only top-level posts (excludes comments). Paid plans.

authorstring
Example:Dickie Bush

Filter by author name.

tagstring

Filter by tag.

posted_fromstring date-time
Example:2026-01-01T00:00:00Z

Filter bookmarks posted after this date/time (ISO 8601 format).

posted_tostring date-time

Filter bookmarks posted before this date/time (ISO 8601 format).

bookmarked_fromstring date-time

Filter bookmarks created after this date/time (ISO 8601 format).

bookmarked_tostring date-time

Filter bookmarks created before this date/time (ISO 8601 format).

sort_bystring

Field to sort by (e.g., 'created_at', 'title').

sort_cursorstring

Value of the sort field from the last item of the previous page, used for stable sorting with pagination.

qstring

Search query to filter bookmarks by title or content.

vector_search_termstring

Vector search term for semantic search.

Response

Successful response.

statusboolean required

Changes

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