SaveIt.now
Sign In

List Bookmarks

Search and list bookmarks using the SaveIt.now API

Search and retrieve bookmarks from your SaveIt.now account.

Query Parameters

Parameter Type Required Description
query string No Search query to filter bookmarks
tags string No Comma-separated list of tags to filter by
types string No Comma-separated list of bookmark types to filter by
special string No Special filter: READ, UNREAD, or STAR
limit integer No Number of results per page (default: 20, max: 100)
cursor string No Cursor for pagination (used for fetching next page)

Search Functionality

The search query (query parameter) supports:

  • Full-text search: Searches in title, description, and URL
  • Exact phrases: Use quotes for exact matches: "web development"
  • Boolean operators: Use AND, OR, NOT operators
  • Wildcards: Use * for partial matches

Pagination

Use cursor-based pagination with limit and cursor parameters:

# Get first 20 bookmarks
curl -X GET "https://saveit.now/api/v1/bookmarks?limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Get next 20 bookmarks using cursor from previous response
curl -X GET "https://saveit.now/api/v1/bookmarks?limit=20&cursor=eyJpZCI6ImJtXzEyMzQ1Njc4OTAifQ" \
  -H "Authorization: Bearer YOUR_API_KEY"

Notes

  • Search is case-insensitive
  • Results are sorted by creation date (newest first) by default
  • Empty search queries return all bookmarks
  • Tag filtering is exact match (case-insensitive)
  • Type filtering supports: ARTICLE, VIDEO, IMAGE, AUDIO, PDF, DOCUMENT, OTHER
  • Special filters allow filtering by read status or starred bookmarks
Create BookmarkDelete Bookmark