v1

latestOpenAPI 3.0.3License MIT2026-07-17251135.8 KB
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.

  • 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

get/public/bookmarks

Query parameters

qstring

search query (terms are separated by space). There are special filters available:

  • lang:iso_language_code - e.g. lang:en for English, lang:es for Spanish and lang:de for German bookmarks
  • site:site_URL - e.g. site:codepedia.org bookmarks only from website www.codepedia.org
  • userId:UUID-user - to be used only when querying public bookmarks submitted by the user with userId
  • private:only - makes sense only when used for querying personal bookmarks
pageinteger

Pagination query param - it is used to skip results in combination with limit query param Defaults to 1 and in this case no results are skipped

limitinteger

Limits the number of returned results (used in combination with queryParam)

locationstring

location of the bookmark, usually an URL

Response

List of bookmarks

_idstring
namestring required
locationstring required
languagestring required
tagsstring[] required
descriptionstring
descriptionHtmlstring
updatedAtstring date-time
createdAtstring date-time
lastAccessedAtstring date-time
publishedOnstring date
publicboolean
userIdstring required
likeCountnumber
sourceCodeURLstring
ownerVisitCountnumber
youtubeVideoIdstring
stackoverflowQuestionIdstring