List bookmarks
Articles in one list: Home, Archive, Liked, a folder or a tag, with reading progress.
GET https://cotlet.dev/api/v1/instapaper/bookmarks
read
Returns saved articles from one list, newest first, with title, URL, saved time, reading progress from 0 to 1, and whether each is liked and archived. Choose the list with section: home, archive, liked, folder or tag. Section folder needs folder_id and section tag needs tag. Pass offset to read the next page. Folder and tag together are not allowed.
Parameters
| Name | Type | Description |
|---|---|---|
| section enum | enum | home, archive, liked, folder or tag. Default: home. |
| folder_id integer | integer | Folder ID from list_folders. Needed for section folder. |
| tag string | string | Tag name from list_tags. Needed for section tag. |
| limit integer | integer | Articles per page. Default: 25. |
| offset integer | integer | Number of articles to skip. Default: 0. |
Request
curl https://cotlet.dev/api/v1/instapaper/bookmarks \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("instapaper", "list_bookmarks")const result = await cotlet.call('instapaper', 'list_bookmarks');cotlet call instapaper list_bookmarksExample response
{
"bookmarks": [
{
"bookmark_id": 1893240551,
"title": "How to Salt Pasta Water",
"url": "https://cooking.example.com/salt-pasta-water",
"saved_at": "2026-08-03T18:22:00Z",
"progress": 1,
"liked": false,
"archived": false,
"folder_id": null,
"tags": [
"Cooking"
]
}
],
"total": 212
}