---
title: "Count Saved Posts"
method: GET
path: "/v1/bookmarks/count"
tags: ["Bookmarks"]
---

# Count Saved Posts

`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`

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.

## Query parameters

- `is_unread_only` boolean
- `hide_archived` boolean
- `media_type` string
- `author` string
- `tag` string
- `posted_from` string, date-time
- `posted_to` string, date-time
- `bookmarked_from` string, date-time
- `bookmarked_to` string, date-time
- `q` string
- `comment` string

## Response `200`

Successful response.

- object
  - `status` boolean, required
  - `data` object, required
    - `count` integer, required

## Other responses

- `400`: Bad Request. Invalid media_type or an invalid comment value.
- `401`: Unauthorized. The Authorization header is missing or the key is not a valid LinkedMash API key. Create or rotate keys on the API page in your LinkedMash settings.
- `500`: Server Error. Something failed on our side. The body carries message "Failed to count bookmarks". Retry once; if it persists the request is not the problem.

---

[API](https://skmtc.dev/linkedmash/apis/linkedmash-api.md) · [All operations](https://skmtc.dev/linkedmash/apis/linkedmash-api/llms.txt) · [OpenAPI document](https://skmtc.dev/linkedmash/apis/linkedmash-api/revisions/eef45d6fbea3?raw)