---
title: "Returns list of public bookmarks filtered with query parameters. `page` and `limit` query parameters are used
for pagination - if missing default values are used."
method: GET
path: "/public/bookmarks"
tags: ["public-bookmarks"]
---

# Returns list of public bookmarks filtered with query parameters. `page` and `limit` query parameters are used
for pagination - if missing default values are used.

`GET /public/bookmarks`

* if `q` param is present they are filtered by the query text contained in it. (takes precedence over `location`)
* if `location` param is present returns a list with one **public** bookmark with that URL
* else **defaults** to the latest added 100 public bookmarks

> The list is empty if not public bookmarks returned for filter

## Query parameters

- `q` string
- `page` integer
- `limit` integer
- `location` string

## Response `200`

List of bookmarks

- Bookmark[]
  - `_id` string
  - `name` string, required
  - `location` string, required
  - `language` string, required
  - `tags` string[], required
  - `description` string
  - `descriptionHtml` string
  - `updatedAt` string, date-time
  - `createdAt` string, date-time
  - `lastAccessedAt` string, date-time
  - `publishedOn` string, date
  - `public` boolean
  - `userId` string, required
  - `likeCount` number
  - `sourceCodeURL` string
  - `ownerVisitCount` number
  - `youtubeVideoId` string
  - `stackoverflowQuestionId` string

---

[API](https://skmtc.dev/codeverdotdev/apis/codever-api.md) · [All operations](https://skmtc.dev/codeverdotdev/apis/codever-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/codeverdotdev/codever-api/revisions/479a3dd64e1f/schema)