List Bookmarks

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