List Tags
Retrieve tags from your SaveIt.now account using the API
Retrieve all tags from your SaveIt.now account with pagination support.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit |
integer | No | Number of results per page (default: 20, max: 100) |
cursor |
string | No | Cursor for pagination (used for fetching next page) |
Response Fields
| Field | Type | Description |
|---|---|---|
success |
boolean | Indicates if the request was successful |
tags |
array | Array of tag objects |
tags[].id |
string | Unique identifier for the tag |
tags[].name |
string | Display name of the tag |
tags[].type |
string | Tag type: USER (manually created) or IA (AI-generated) |
tags[].bookmarkCount |
integer | Number of bookmarks associated with this tag |
hasMore |
boolean | Indicates if there are more results available |
nextCursor |
string | Cursor for fetching the next page (null if no more results) |
Tag Types
SaveIt.now uses two types of tags:
- IA (AI-generated): Tags automatically created by AI when processing bookmarks
- USER: Tags manually created by users
Both types are returned in the API response and can be identified by the type field.
Notes
- Tags are sorted by ID in ascending order for consistent pagination
- Empty tag lists are valid responses (returns empty array)
- The
bookmarkCountfield shows the total number of bookmarks associated with each tag - AI-generated tags (
type: "IA") are created automatically during bookmark processing - User tags (
type: "USER") are created manually by users