# Bookmarks: Mosaic API reference

> Bookmarks in Mosaic’s local REST API: 2 routes, each with its method, path, fields, what it returns and the errors it names.

Source: https://mosaicbrowser.com/docs/api/bookmarks

**A profile’s data** REST API

## Bookmarks

Seeded into the bookmarks bar before the browser starts. An empty bar is one more way a profile reads as freshly made.

- [GETRead a profile’s bookmarks](#get-bookmarks)
- [POSTReplace the bookmarks](#set-bookmarks)

## [Read a profile’s bookmarks](#get-bookmarks)

GET`/api/v1/profiles/:id/bookmarks`

The list that will be written into the bookmarks bar the next time this profile launches.

#### Path parameters

| Field | Type | What it is |
| --- | --- | --- |
| `id`required | `string` | The record’s id. |

#### Returns

`{ bookmarks: Array<{ title, url }> }`

## [Replace the bookmarks](#set-bookmarks)

POST`/api/v1/profiles/:id/bookmarks`

Replaces the whole list. Pass `bookmarks` directly, or `text` to be parsed — an exported bookmarks HTML file, a Chromium `Bookmarks` JSON tree, or one per line as `Title | https://…`. Chromium reads the file once at startup and rewrites it on exit, so the change lands on the next launch rather than in a running browser.

#### Path parameters

| Field | Type | What it is |
| --- | --- | --- |
| `id`required | `string` | The record’s id. |

#### Body

| Field | Type | What it is |
| --- | --- | --- |
| `bookmarks` | `Array<{ title, url }>` | The list to store. |
| `text` | `string` | A pasted export, parsed instead of `bookmarks`. |

#### Returns

`{ count, bookmarks }`

## Run the API on your own profiles

The REST API and the MCP server are part of Pro: $49 a month, with the first 14 days free. Free has every browser feature and no API key.

Mosaic is a desktop app

Email yourself the link and open it on your computer.