Bookmarks

Count Saved Posts

Get the total count of bookmarks for the authenticated user.

GET /v1/bookmarks/count returns how many saved posts match a filter, without transferring the posts themselves. It accepts the same filter set as GET /v1/bookmarks, so you can size a query before you page through it — useful for progress bars, sync planning, or deciding whether a nightly job has anything to do.

The response echoes an applied_filters object alongside the count. That is deliberate: a count with no record of what it counted is easy to misread, and echoing the resolved filters lets a caller assert that the number covers what it thinks it covers.

get/v1/bookmarks/count

Request

  • Base URL: https://api.linkedmash.com
  • URL: https://api.linkedmash.com/v1/bookmarks/count
  • 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

is_unread_onlyboolean

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

hide_archivedboolean

Exclude archived posts. Defaults to true, matching GET /v1/bookmarks so list and count always agree.

media_typestring
Example:video

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

authorstring

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).

qstring

Search query to filter bookmarks by title or content.

commentstring

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

Response

Successful response.

statusboolean required

Changes

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