List highlights

The highlighted passages of one article.

GET https://cotlet.dev/api/v1/instapaper/bookmarks/{bookmark_id}/highlights

read

Returns the highlights you made in one saved article, with the highlighted text and when you made each one. An article with no highlights returns an empty list. One call covers one article, so a digest reads one article after another.

Parameters

Parameters: list_highlights
NameTypeDescription
bookmark_id integer required integer Bookmark ID from list_bookmarks.

Request

cURL
curl https://cotlet.dev/api/v1/instapaper/bookmarks/1893240551/highlights \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("instapaper", "list_highlights", {"bookmark_id":1893240551})
Node.js
const result = await cotlet.call('instapaper', 'list_highlights', {"bookmark_id":1893240551});
CLI
cotlet call instapaper list_highlights --data '{"bookmark_id":1893240551}'

Example response

JSON

{
  "bookmark_id": 1893240551,
  "highlights": [
    {
      "highlight_id": 77120431,
      "text": "Salt the water until it tastes like the sea, then add the pasta.",
      "created_at": "2026-10-12T19:04:00Z"
    }
  ]
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.