bookmark.land
Api reference

Subscription & Usage

Check your plan limits and current usage

Get Usage

GET /subscription/usage

Scope: bookmarks:read

Returns your current plan, bookmark count, and storage usage.

{
  "data": {
    "bookmarkCount": 1234,
    "trashedCount": 12,
    "bookmarkLimit": 50000,
    "plan": "pro",
    "storage": {
      "usedBytes": 52428800,
      "limitBytes": 524288000,
      "maxFileBytes": 10485760
    }
  }
}
FieldTypeDescription
bookmarkCountnumberCurrent number of active bookmarks
trashedCountnumberCurrent number of trashed bookmarks
bookmarkLimitnumberMaximum bookmarks allowed on your plan
planstringCurrent plan: free, pro, or business
storageobjectStorage usage metadata
storage.usedBytesnumberStorage used in bytes
storage.limitBytesnumberStorage limit in bytes
storage.maxFileBytesnumberPer-file upload limit in bytes

Plan Limits

PlanBookmarksAPI Access
Pro50,000Yes
Business50,000Yes

Free plan users cannot create API tokens or access the API.

When you reach your bookmark limit, create/import operations return a BOOKMARK_LIMIT_REACHED error (422).

On this page