Raindrop.API

PowerShell module to interact with the Raindrop.io.

Available Endpoints

Authentication

• Get-RaindropAuthHeader: Builds an authorization header for API requests using the provided API token.

User

• Get-RaindropUser: Retrieves information about the authenticated user.

Backup

• New-RaindropBackup: Initiates the creation of a new backup for the authenticated user. This process may take some time.
• Get-RaindropBackup: Retrieves a list of available backups for the authenticated user.
• Save-RaindropBackup: Downloads and saves a specific backup to a file in CSV or HTML format.

Export

• Export-Raindrop: Exports a collection of Raindrop bookmarks in the specified format (CSV, HTML, ZIP, or TXT). Supports sorting by creation date, score, title, or domain, and filtering by search terms.

Examples

# Import the module (adjust path as needed)
Import-Module .\Raindrop.API\Raindrop.API.psm1 -Force

# Set your API token
$ApiToken = 'YOUR_API_TOKEN'

# Get authenticated user info
$user = Get-RaindropUser -ApiToken $ApiToken

# Export bookmarks to a TXT file (sorted & filtered)
# Exports collection 0 (all) to .\export.txt, sorted by created desc, searching 'youtube'
Export-Raindrop -ApiToken $ApiToken -collectionId 0 -format 'txt' -OutFile '.\export.txt' -Sort '-created' -Search 'youtube'

# Export bookmarks to CSV and convert to PS objects
# When called without -OutFile, Export-Raindrop returns CSV text
$csv = Export-Raindrop -ApiToken $ApiToken -collectionId 0 -format 'csv'

# List available backups
Get-RaindropBackup -ApiToken $ApiToken

# Save a specific backup to CSV
# Pick an ID from $backups and save it
Save-RaindropBackup -ApiToken $ApiToken -id 67d6c08737249bbc09d0f54f -format 'csv' -OutFile ".\export.csv"

# Create a new backup (may take time)
New-RaindropBackup -ApiToken $ApiToken

# Download an export as ZIP file
Export-Raindrop -ApiToken $ApiToken -collectionId 0 -format 'zip' -OutFile '.\export-main.zip'

License

MIT License © Alan Płócieniak