WebCull - Documentation - Bookmark Reads

Bookmark Reads

Inspect Placement Before Fetching Details

Bookmark read commands are designed for large accounts. Start with counts and shallow trees, collect likely IDs, then fetch only the records that matter.

Count

Check How Large A Folder Is

webcull bookmarks count --path "/Marketing/Competitors"

{
  "success": "true",
  "count": 84,
  "parent_id": 2301
}

Use the count before tree expansion. If the count is large, lower --limit, lower --max-depth, or choose a narrower path.

Tree

List A Bounded Folder Tree

webcull bookmarks tree --path "/Marketing" --max-depth 1 --limit 25 --fields id,parent_id,type,title,url

{
  "success": "true",
  "items": [
    {
      "id": 2301,
      "parent_id": 2000,
      "type": "folder",
      "title": "Competitors",
      "url": ""
    },
    {
      "id": 2302,
      "parent_id": 2301,
      "type": "bookmark",
      "title": "Acme pricing",
      "url": "https://acme.example/pricing"
    }
  ],
  "returned": 2,
  "parent_id": 2000,
  "max_depth": 1,
  "page": 1
}

id

The bookmark or folder ID to pass into later get or graph commands.

parent_id

The folder or parent item that contains this result.

returned

How many rows were included after your limits were applied.

Get

Fetch Exact Bookmarks By ID

webcull bookmarks get --ids 2302,2303 --fields id,title,url,notes --max-metadata-chars 1200

{
  "success": "true",
  "items": [
    {
      "id": 2302,
      "title": "Acme pricing",
      "url": "https://acme.example/pricing",
      "notes": "Compare packaging changes before Q3 planning."
    }
  ],
  "returned": 1
}

Fetch notes and longer bookmark details only after narrowing to a small set of IDs. This keeps terminal output readable and easier to review.