help · blog · about ·
A blue social bookmark and publication sharing system.

Semantics of the BibSonomy URL scheme

This document explains in detail the semantics of the BibSonomy URLs.

General pages
/
Home page of BibSonomy, shows the 50 last recently posted public entries.
/popular
Shows the 100 most often posted entries of the last 100000 public posts.
/help
This page.
/faq
A page containing frequently asked questions and their answers.
User pages
/user/jaeschke
Shows all posts (which you are allowed to see) of the user jaeschke.
/user/jaeschke/web
Shows all posts (which you are allowed to see) with the tag web of the user jaeschke.
/user/jaeschke/web+api
Shows all posts (which you are allowed to see) with the tag web and the tag api of the user jaeschke.
/myBibSonomy
Link to the list of your own bookmarks and bibliographic references.
/myBibTeX
Link to the BibTeX list of all your own bibliographic references.
/myRelations
Link to the list of your own relations.
/myPDF
Link to your own collection of full texts (PDF, PS or DJVU).
/myDuplicates
Link to your own duplicates.
Author pages

BibSonomy offers a way to retrieve publications by the names of their authors. There are several options to filter these search results. Currently, the filters include the year of publication, a special tag and the username of the person who stored the post.

/author/hotho
Shows all posts (which you are allowed to see) with the author hotho.
/author/stumme+hotho+schmitz
Shows all publications published by these authors.
/author/stumme+hotho+%21schmitz
Specifies names of an author who should not be part of the searched publications, e.g. show all publications being written by Stumme and Hotho, but not by Schmitz.
/author/hotho/clustering
Shows all posts (which you are allowed to see) with the tag clustering and the author hotho.
/author/stumme+sys:user:hotho
Shows all publications of the author Stumme in Hotho's collection.
/author/stumme+hotho+%21schmitz+sys:year:2002-2007+sys:user:hotho/folksonomy
This combination of search results returns all publications of the authors Stumme and Hotho but not Schmitz between the years 2002 and 2007 in user Hotho's collection marked with the tag folksonomy.
/author/stumme+sys:group:kde
Shows all publications of the author Stumme in the collections of all group members of the group kde.

A system tag can restrict your author search result to a special year or range of years. Four formats are available:

/author/stumme+sys:year:2007
Returns all publications of the author Stumme of the year 2007.
/author/stumme+sys:year:2003-2007
Returns all publications of the author Stumme between 2003-2007.
/author/stumme+sys:year:-2005
Returns all publications of the author Stumme until the year 2005.
/author/stumme+sys:year:1997-
Returns all publications of the author Stumme since 1997.
Tag pages
/tag/web
Shows all public posts with the tag web.
/tag/web+api
Shows all public posts with the tag web and the tag api.
URL or BibTeX pages
/url/d1bb7b3f6cafafa7b418f9f356ff2e83
Shows all public bookmark posts of the URL with the MD5 hash d1bb7b3f6cafafa7b418f9f356ff2e83 (which belongs to http://www.bibsonomy.org).
/url/d1bb7b3f6cafafa7b418f9f356ff2e83/jaeschke
Shows the bookmark posts (if you are allowed to see it) of the user jaeschke with the MD5 hash d1bb7b3f6cafafa7b418f9f356ff2e83 (which belongs to http://www.bibsonomy.org).
/bibtex/1d28c9f535d0f24eadb9d342168836199
Shows all public publication posts with the hashkey 1d28c9f535d0f24eadb9d342168836199 (which belongs to http://www.bibsonomy.org). The used hash is the Inter-Hash.
/bibtex/25854a71547051543dd3d3d5e2e2f2b67/steff83
Shows the publication post (if you are allowed to see it) of the user steff83 with the hashkey 25854a71547051543dd3d3d5e2e2f2b67 (which belongs to http://www.bibsonomy.org). The used hash is the Intra-Hash.

BibSonomy provides a Tag JSON Feed belonging to a BibTeX post:

/json/tags/bibtex/1d28c9f535d0f24eadb9d342168836199
Provides A JSON output containing all tags related to the publication with the Inter-Hash 1d28c9f535d0f24eadb9d342168836199

BibSonomy offers the possibility to retrieve a publication by its BibTeX key:

/bibtexkey/Wille82
Returns publications which have the BibTeX key Wille82.
/bibtexkey/wille82+sys:user:Stumme
Returns publications which have the BibTeX key Wille82 from the collection of the user Stumme.
/bibtexkey/hjss06bibsonomy+sys%3Auser%3Ajaeschke
Shows all posts (which you are allowed to see) with the specified BibTeX-Key hjss06bibsonomy of the user jaeschke. If you have more than one entry with the same BibTeX key, then a list of all hits will be given.
/bibtexkey/journals/jacm/HopcroftU69/dblp
You can use BibTeX semantics to refer to entries that we mirror from DBLP, once you know how DBLP generates its BibTeX keys.
Content negotiation pages
Content negotiation helps to show a source with the same URL in different ways, according to the settings of the user agent.
Adding the keyword uri to your url enables content negotiation. This is available for the following pages:
  • URL and BibTeX pages
  • author pages
  • BibTeX-Key pages
/uri/url/d1bb7b3f6cafafa7b418f9f356ff2e83
Shows all bookmarks with the specified hash.
/uri/bibtex/2b8b87c78e9e27a44aacde0402c642bff
Shows all BibTeX entries with the specified hash.
/uri/bibtexkey/hjss06bibsonomy/jaeschke
Shows all BibTeX entries with the specified key of the user jaeschke .
/uri/author/hotho
Shows all BibTeX entries of the author hotho.
The current supported output formats are HTML, XML, RSS, RDF, and BibTeX. The user agent specifies a preferred output format in the HTML accept header defining the priority order with the help of q-values. For example, the header definition
Accept:text/xml;q=1,text/html;q=0.9,text/plain;q=0.8,image/png;q=1,*/*;q=0.5
would trigger the following priority:
  • text/xml
  • image/png
  • text/html
  • text/plain
  • */*
Search pages
/search/web
Shows all public posts which contain in the fulltext (not in the tags!) the word web. In case of a bookmark, the fulltext contains the URL, the title and the description. In case of a publication, the title, the description and all BibTeX fields are included.
/search/web+api
Shows all public posts which contain in the fulltext (not in the tags!) the word web and the word api. In case of a bookmark, the fulltext contains the URL, the title and the description. In case of a publication, the title, the description and all BibTeX fields are included.
/search/web+-api
Shows all public posts which contain in the fulltext (not in the tags!) the word web but not the word api. In case of a bookmark, the fulltext contains the URL, the title and the description. In case of a publication, the title, the description and all BibTeX fields are included.
/search/web+user:jaeschke
Shows all public posts of the user jaeschke which contain in the fulltext (not in the tags!) the word web. In case of a bookmark, the fulltext contains the URL, the title and the description. In case of a publication, the title, the description and all BibTeX fields are included.
/search/web+api+user:jaeschke
Shows all public posts of the user jaeschke which contain in the fulltext (not in the tags!) the word web and the word api. In case of a bookmark, the fulltext contains the URL, the title and the description. In case of a publication the title, the description and all BibTeX fields are included.
/search/web+-api+user:jaeschke
Shows all public posts of the user jaeschke which contain in the fulltext (not in the tags!) the word web but not the word api. In case of a bookmark, the fulltext contains the URL, the title and the description. In case of a publication, the title, the description and all BibTeX fields are included.
/mySearch
This site offers a fast search in your collection.
Friends pages
/friends
Shows all posts which are set viewable for friends of all users which declared you as their friend. Additionally you can
  • add a friend to your friends list,
  • remove a friend from your friends list.
/friend/jaeschke
Shows all posts which are set viewable for friends of the user jaeschke. You can only see them if jaeschke declared you a friend.
/friend/jaeschke/web
Shows all posts with the tag web which are set viewable for friends of the user jaeschke. You can only see them if jaeschke declared you a friend.
/friend/jaeschke/web+api
Shows all posts with the tag web and the tag api which are set viewable for friends of the user jaeschke. You can only see them if jaeschke declared you a friend.
Relation and concept pages
/relations/schmitz
Shows all relations of the user schmitz.
/concept/user/schmitz/event
Shows all bookmarks and publications of the user schmitz which have event or one of the relation's subtags as tags.
Viewable pages
/viewable/public
Shows all your posts which you set viewable for public.
/viewable/public/web
Shows all your posts with the tag web which you set viewable for public.
/viewable/public/web+api
Shows all your posts with the tag web and the tag api which you set viewable for public.
/viewable/private
Shows all your posts which you set viewable for private.
/viewable/private/web
Shows all your posts with the tag web which you set viewable for private.
/viewable/private/web+api
Shows all your posts with the tag web and the tag api which you set viewable for private.
/viewable/friends
Shows all your posts which you set viewable for friends.
/viewable/friends/web
Shows all your posts with the tag web which you set viewable for friends.
/viewable/friends/web+api
Shows all your posts with the tag web and the tag api which you set viewable for friends.
/viewable/kde
Shows all posts (if you are allowed to see them) which were set viewable for the group kde.
/viewable/kde/web
Shows all posts (if you are allowed to see them) with the tag web which were set viewable for the group kde.
/viewable/kde/web+api
Shows all posts (if you are allowed to see them) with the tag web and the tag api which were set viewable for the group kde.
Export pages
/basket
Here you can manage publication posts you picked with the "pick" button.
/export/
Shows a variety of formats which you can select to export publication metadata.

The following URLs are shortcuts which can also be clicked on the export page.

RSS Feeds

/publrss/
Presents an RSS feed of the main publication page.
/burst/
BibSonomy BuRST feed for the main publication page.
/aparss/
RSS feed in APA 5th style.

Reference metadata and formatting

/bib/
BibTeX format of all publications of the main publication page.
/bib/user/beate
BibTeX format of all publications of the publication page of the user beate.
/endnote/
EndNote format of the publications of the main page.

HTML formatting

/publ/
A simple layout where entries are shown as a list in a table.
/publ/?notags=1
Suppresses the BibSonomy tags in the HTML output.

Semantic web formatting

/swrc/
RDF output according to SWRC ontology.
JabRef layouts
/layout/simplehtml/
HTML layout without any header or footer: useful for integrating publication lists into other HTML pages.
/layout/html/
A simple layout where entries are shown as a list in a table.
/layout/tablerefs/
HTML output with each entry shown as a list in a table and an additional JavaScript search function.
/layout/tablerefsabsbib/
Similar to TableRefs. Also includes the BibTeX source and the abstract of the publication.
/layout/docbook/
This is an XML output according to the DocBook schema.
/layout/endnote/
Output in RIS which is used by EndNote, a bibliography management tool.
/layout/dblp/
DBLP exports your records to a DBLP conformable XML structure.
/layout/text/
BibTeX output.
Administrative pages
/settings
On this page you can
  • add a user to your group (if you have one),
  • import your del.icio.us data,
  • change your password,
  • change your account settings (email, name of your homepage).
/post_bookmark
On this page you can enter a URL to post a bookmark.
/post_bibtex
On this page you can
  • enter type, title, author, publisher and year to post a publication,
  • insert a selected BibTeX snippet into a text box to post one or more BibTeX entries,
  • upload a BibTeX file to post one or more BibTeX entries.
Groups
/groups
Shows all groups of the system.
/group/kde
Shows all posts (which you are allowed to see) of members of the group kde.
/group/kde/web
Shows all posts (which you are allowed to see) with the tag web of members of the group kde.
/group/kde/web+api
Shows all posts (which you are allowed to see) with the tag web and the tag api of the members of the group kde.
/relevantfor/group/kde
Shows all posts relevant for the members of the group.
/followers
Shows the recent posts of all users you are following and applies a ranking algorithm to show the most relevant ones for you on top of the list.