Getting started
Quick Start
Get up and running with the bookmark.land API in 5 minutes
Prerequisites
- A bookmark.land account on the Pro plan or higher (free accounts cannot access the API)
- An API token (created from your account settings)
Step 1: Create an API Token
- Go to Settings in your bookmark.land dashboard
- Navigate to the API Tokens section
- Click Create Token
- Give it a name and select the scopes you need
- Copy the token -- it will only be shown once
Your token looks like this:
bkl_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4Step 2: Make Your First Request
curl -H "Authorization: Bearer bkl_your_token_here" \
https://api.bookmark.land/v1/bookmarks?limit=3Step 3: Create a Bookmark
curl -X POST https://api.bookmark.land/v1/bookmarks \
-H "Authorization: Bearer bkl_your_token_here" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com",
"title": "My First API Bookmark",
"tags": ["api", "test"]
}'Step 4: Verify It Worked
curl -H "Authorization: Bearer bkl_your_token_here" \
https://api.bookmark.land/v1/bookmarks/search?q=API+BookmarkResponse Format
Every response is wrapped in an envelope:
Success:
{
"data": { ... },
"meta": { "requestId": "req_a1b2c3d4e5f6a1b2" }
}Error:
{
"error": {
"code": "SCOPE_REQUIRED",
"message": "This endpoint requires the \"bookmarks:write\" scope"
},
"meta": { "requestId": "req_a1b2c3d4e5f6a1b2" }
}