Bookmarks and highlights via the API.
Get bookmarks
Returns JSON Feed that also includes an extra links
array in _microblog
for each item. These link IDs can be used with “/hybrid/bookmarks/123” to show the reader/highlighting web interface.
GET /posts/bookmarks
Authorization: Bearer 123456789
{
"version": "https://jsonfeed.org/version/1",
"title": "Micro.blog - Bookmarks",
"home_page_url": "https://micro.blog/",
"feed_url": "https://micro.blog/posts/bookmarks",
"_microblog": {
"about": "https://micro.blog/about/api"
},
"items": [
{
"id": "1545",
"content_html": "Daring Fireball: On TikTok as a Security Threat <a href=\"https://daringfireball.net/2020/08/on_tiktok_as_a_security_threat\">daringfireball.net</a><p class=\"post_archived_links\">Read: <a href=\"/bookmarks/123\">daringfireball.net</a> ",
"url": "https://daringfireball.net/2020/08/on_tiktok_as_a_security_threat",
"date_published": "2020-09-03T15:15:02+00:00",
"author": {
"name": "daringfireball.net",
"url": "https://daringfireball.net/",
"avatar": "https://daringfireball.net/graphics/favicon.ico?v=005",
"_microblog": {
"username": "daringfireball.net"
}
},
"_microblog": {
"date_relative": "2020-09-03 10:15 am",
"date_favorited": "2020-09-03T15:15:03+00:00",
"links": [
{
"id": 123,
"url": "https://daringfireball.net/...",
"archived_url": "https://s3.amazonaws.com/micro.blog/..."
}
],
"is_bookmark": true,
"is_favorite": true,
"is_deletable": false,
"is_conversation": false
}
}
]
}
Get bookmarks for one tag
GET /posts/bookmarks?tag=example
Authorization: Bearer 123456789
Get highlights
Get recent user highlights in bookmarked web pages. Returns JSON Feed that also includes total highlight count in root-level _microblog
.
GET /posts/bookmarks/highlights
Authorization: Bearer 123456789
{
"version": "https://jsonfeed.org/version/1",
"title": "Micro.blog - Highlights",
"home_page_url": "https://micro.blog/",
"feed_url": "https://micro.blog/posts/bookmarks/highlights",
"_microblog": {
"about": "https://micro.blog/about/api",
"count": 13
},
"items": [
{
"id": 26,
"title": "Daring Fireball: On TikTok as a Security Threat",
"content_text": "The fact that TikTok is owned and controlled by a Chinese company is reason enough to be suspicious",
"date_published": "2020-09-10T18:02:56+00:00"
}
]
}
Load web reader
Returns HTML/JS for the web reader that also allows highlighting. This can be loaded in an in-app web view. Uses link ID from /posts/bookmarks
.
GET /hybrid/bookmarks/123
Authorization: Bearer 123456789
Get one bookmark
GET /posts/bookmarks/123
Authorization: Bearer 123456789
Get all tags
GET /posts/bookmarks/tags
Authorization: Bearer 123456789
Get recent tags
GET /posts/bookmarks/tags?recent=1&count=10
Authorization: Bearer 123456789
Set tags for a bookmark
Updated a bookmark for the given bookmark ID in the path with new tags. The tags are comma-separated and replace any existing tags.
POST /posts/bookmarks/123
Authorization: Bearer 123456789
Content-Type: application/x-www-form-urlencoded
tags=tag1,tag2
Delete a highlight
Highlight ID as returned from /posts/bookmarks/highlights
.
DELETE /posts/bookmarks/highlights/:id
Authorization: Bearer 123456789