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

# Fetch Saved Posts

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

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.

## Query parameters

- `limit` integer
- `cursor` string
- `is_unread_only` boolean
- `hide_archived` boolean
- `media_type` string
- `comment` 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
- `sort_by` string
- `sort_cursor` string
- `q` string
- `vector_search_term` string

## Response `200`

Successful response.

- object
  - `status` boolean, required
  - `data` object[], required
    - `post_id` string, required
    - `post_details` object, required
      - `text` string, required
      - `link` string, uri, required
      - `posted_at` string, date-time, required
      - `attachments` object[], required
        - `type` string, required
        - `title` string, required
        - `url` string, uri, required
        - `thumbnail` object[], required
          - `url` string, uri, required
          - `width` integer, required
          - `height` integer, required
    - `author_id` string, required
    - `author_details` object, required
      - `bio` string, required
      - `name` string, required
      - `username` string, required
      - `profile_image` object, required
        - `url` string, uri, required
        - `width` integer, required
        - `height` integer, required
        - `expiresAt` integer, required
    - `tags` unknown, required
    - `is_read` boolean, required
    - `is_archived` boolean, required
    - `posted_at` string, required
    - `imported_at` string, required
    - `sort_index` string, required
  - `meta` object, required
    - `next_cursor` string, required
    - `limit` integer, required
    - `total_count` integer, required

## Other responses

- `400`: Bad Request. Invalid media_type, invalid comment value, a non-positive limit, or a cursor that could not be decoded.
- `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.
- `402`: Payment Required. Code AGENT_CREDITS_EXHAUSTED when a free key has spent its 20 lifetime credits or a paid key has spent its 2,000 monthly credits. Paid credits reset at the UTC month boundary; the response and X-Agent-Credits-Reset-At header name the next reset.
- `500`: Server Error. Something failed on our side. The body carries message "Failed to list 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)