Count unsorted

{baseDir}/scripts/raindrop.sh count -1

Create collection and move bookmarks

{baseDir}/scripts/raindrop.sh create-collection "AI Coding" {baseDir}/scripts/raindrop.sh move 12345 66016720

Bulk move (efficient!)

{baseDir}/scripts/raindrop.sh bulk-move "123,456,789" 66016720


## Commands

### Reading

| Command | Description |
|---------|-------------|
| `whoami` | Show authenticated user |
| `collections` | List all collections with IDs |
| `list [ID]` | List bookmarks (default: 0 = all) |
| `count [ID]` | Count bookmarks in collection |
| `search QUERY [ID]` | Search bookmarks |
| `get ID` | Get bookmark details |
| `tags` | List all tags with counts |
| `list-untagged [ID]` | Find bookmarks without tags |
| `cache ID` | Get permanent copy (Pro only) |

### Writing

| Command | Description |
|---------|-------------|
| `add URL [ID]` | Add bookmark (default: -1 = Unsorted) |
| `delete ID` | Delete bookmark |
| `create-collection NAME` | Create new collection |
| `move ID COLLECTION` | Move bookmark to collection |
| `update ID [opts]` | Update tags/title/collection |
| `bulk-move IDS TARGET [SOURCE]` | Move multiple bookmarks (source defaults to -1/Unsorted) |
| `suggest URL` | Get AI-suggested tags/title |

### Options

| Flag | Description |
|------|-------------|
| `--json` | Raw JSON output |
| `--limit N` | Max results (default: 25) |
| `--page N` | Pagination (0-indexed) |
| `--delay MS` | Delay between API calls (rate limiting) |
| `--token TOKEN` | Override API token |

### Update Options

For the `update` command:

| Flag | Description |
|------|-------------|
| `--tags TAG1,TAG2` | Set tags (comma-separated) |
| `--title TITLE` | Set title |
| `--collection ID` | Move to collection |

### Collection IDs

- `0` = All bookmarks
- `-1` = Unsorted
- `-99` = Trash
- `N` = Specific collection (get IDs from `collections`)

## Examples

```bash
# List unsorted with pagination
{baseDir}/scripts/raindrop.sh list -1 --limit 50 --page 0
{baseDir}/scripts/raindrop.sh list -1 --limit 50 --page 1

# Create collection
{baseDir}/scripts/raindrop.sh create-collection "AI Coding"
# Output: Created: AI Coding / ID: 66016720

# Move single bookmark
{baseDir}/scripts/raindrop.sh move 1234567 66016720

# Update bookmark with tags and move
{baseDir}/scripts/raindrop.sh update 1234567 --tags "claude-code,workflow,tips" --collection 66016720

# Bulk move with rate limiting (100ms between calls)
{baseDir}/scripts/raindrop.sh bulk-move "123,456,789,101112" 66016720 --delay 100

# Find untagged bookmarks in unsorted
{baseDir}/scripts/raindrop.sh list-untagged -1 --limit 100

# Get JSON for scripting
{baseDir}/scripts/raindrop.sh list -1 --json --limit 50 | jq '.items[]._id'

# Count unsorted bookmarks
{baseDir}/scripts/raindrop.sh count -1

Bulk Operations

For large batch operations, use bulk-move which uses the Raindrop batch API (up to 100 items per request):

# Get IDs from unsorted
ids=$({baseDir}/scripts/raindrop.sh list -1 --json --limit 100 | jq -r '[.items[]._id] | join(",")')

# Move all to collection
{baseDir}/scripts/raindrop.sh bulk-move "$ids" 66016720

Rate Limiting

Raindrop API has rate limits. For bulk operations:

Use --delay 100 (100ms between calls)
Use bulk-move instead of individual move calls
Process in batches of 50-100

Direct API

For operations not covered:

source ~/.config/raindrop.env

# Update tags
curl -X PUT "https://api.raindrop.io/rest/v1/raindrop/ID" \
  -H "Authorization: Bearer $RAINDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"tags": ["tag1", "tag2"]}'

# Bulk update (up to 100 IDs)
curl -X PUT "https://api.raindrop.io/rest/v1/raindrops" \
  -H "Authorization: Bearer $RAINDROP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ids": [123, 456, 789], "collectionId": 12345}'

API docs: https://developer.raindrop.io/

raindrop

Raindrop.io Bookmarks

Setup

Quick Start