---
title: "List private X/Twitter bookmark imports"
method: GET
path: "/x/bookmarks"
---

# List private X/Twitter bookmark imports

`GET /x/bookmarks`

## Request

- Base URL: `https://api.bamf.ai/v1`
- URL: `https://api.bamf.ai/v1/x/bookmarks`
- Auth: HTTP bearer

Requires ideas:read. Private creator inspiration source; opt-in only when passed into idea/post generation. Each bookmark includes folder_memberships (an array of {folder_id, folder_name}); legacy folder_id and folder_name fields remain as a compatibility projection.

## Query parameters

- `creator_id` string
- `status` string
- `folder_id` string
- `folder_name` string
- `search` string
- `since` string, date-time
- `limit` integer

## Response `200`

Bookmark rows

- object
  - `data` object[]
    - `folder_id` string, nullable
    - `folder_name` string, nullable
    - `folder_memberships` object[]
      - `folder_id` string
      - `folder_name` string

---

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