Last updated April 2026

Save Bookmarks from the Terminal with curl

Save This One has a simple API endpoint you can hit with curl. Save a bookmark from your terminal in one command. Add it as a shell alias and you have a CLI bookmarking tool. Free.

Save and manage bookmarks from the command line.

Setup

You need your API token. In the web app sidebar, click the key icon, then Generate Token and Copy.

Every request needs an Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Replace YOUR_API_TOKEN with your copied token. Mind the space after Bearer.

Save a bookmark

curl -X POST https://app.savethisone.com/api/bookmarks \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com"}'

With tags:

curl -X POST https://app.savethisone.com/api/bookmarks \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com", "tags": ["reading", "tech"]}'

List bookmarks

curl https://app.savethisone.com/api/bookmarks \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Archived only:

curl "https://app.savethisone.com/api/bookmarks?archived=true" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Archive a bookmark

curl -X PATCH https://app.savethisone.com/api/bookmarks \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "BOOKMARK_ID", "action": "archive"}'

Delete a bookmark

curl -X DELETE https://app.savethisone.com/api/bookmarks \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"id": "BOOKMARK_ID"}'

List tags

curl https://app.savethisone.com/api/tags \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Shell function

Add to ~/.bashrc or ~/.zshrc for quick saving:

bookmark() {
  local url="$1"
  shift
  local tags=""

  if [ $# -gt 0 ]; then
    tags=$(printf '"%s",' "$@")
    tags="[${tags%,}]"
  fi

  local body
  if [ -n "$tags" ]; then
    body="{\"url\": \"$url\", \"tags\": $tags}"
  else
    body="{\"url\": \"$url\"}"
  fi

  curl -s -X POST https://app.savethisone.com/api/bookmarks \
    -H "Authorization: Bearer YOUR_API_TOKEN" \
    -H "Content-Type: application/json" \
    -d "$body" | python3 -m json.tool
}

Reload your shell: source ~/.zshrc

bookmark "https://example.com"
bookmark "https://example.com" reading tech
Start saving free