BibSonomy REST API

Name: BibSonomy REST API
Brand: BibSonomy REST API
Availability: InStock

✓ Official Vendor SpecProductivityNote Takingbasic46 EndpointsREST

For Agents

Manage BibSonomy bookmarks, BibTeX publications, tags, concepts, groups, and document attachments for academic reference sharing.

Install Jentic One Beta

Connect the BibSonomy REST API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the BibSonomy REST API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbibsonomy.org%2Fbibsonomy" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fbibsonomy.org%2Fbibsonomy" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with BibSonomy REST API.

Publish BibTeX publications and bookmarks to a BibSonomy user account

Tag publications with controlled vocabulary concepts for organised reading lists

Manage concepts (tag hierarchies) used to structure a personal library

GET STARTED

Start building with BibSonomy REST API

Explore with Jentic

View OpenAPI Document

BibSonomy is a social bookmarking and academic publication sharing system run by the University of Kassel and partners. The REST API gives programmatic access to users, posts (which can be either bookmarks or BibTeX publications), tags, concepts (controlled hierarchies of tags), groups, persons, and document attachments. Authentication uses HTTP Basic with the BibSonomy username and API key generated in the user settings. The 46 endpoints are organised around the user as the primary resource and let agents publish references, share reading lists, and collaborate inside research groups.

Use Cases

Patterns agents use BibSonomy REST API for, with concrete tasks.

★ Reference Manager Sync

Sync a researcher's BibTeX library between a desktop reference manager and BibSonomy so collaborators can read and cite the shared library through the web interface. POST /users/{username}/posts publishes a publication; GET /users/{username}/posts retrieves the full library; PUT updates an entry. Document attachments under /documents/ keep PDFs alongside the metadata.

POST a new BibTeX entry to /users/researcher42/posts with title, authors, year, and an attached PDF.

Research Group Reading List

Run a shared reading list inside a BibSonomy group so every member sees newly added papers and can comment via tags. GET /groups/{groupname} returns the group profile, and posts are surfaced through the group's user-tagged publications. The clipboard endpoint helps a curator stage papers before publishing them to the group.

List the members of group 'lab-deep-learning' and surface every paper they have tagged with 'transformers' in the last 30 days.

Tag-Based Discovery Feed

Build a discovery feed that surfaces new bookmarks and publications from across BibSonomy by tag, similar to a topic tracker. Iterate user posts with a tag filter and present new items to the reader. This is useful for staying on top of an evolving research area without subscribing to individual users.

Iterate /users/{username}/posts for a curated set of users and pull every post tagged 'graph-neural-networks' added in the last week.

AI Agent Reference Curator

An AI agent helping a PhD student curate references can publish new papers to BibSonomy and tag them appropriately, reading existing posts to avoid duplicates. Through Jentic, the agent searches by intent ('add a BibTeX entry to my library'), loads the schema, and executes — Jentic supplies the basic-auth credentials so the agent never sees the username and password pair.

Search Jentic for 'create a BibSonomy post', execute POST /users/researcher42/posts, and tag the resulting entry with 'literature-review'.

Key Endpoints

46 endpoints — bibsonomy is a social bookmarking and academic publication sharing system run by the university of kassel and partners.

METHOD

PATH

DESCRIPTION

GET

/users/{username}/posts

List posts for a user

POST

/users/{username}/posts

Create a post

PUT

/users/{username}/posts/{resourceHash}

Update a post

POST

/users/{username}/posts/{resourceHash}/documents/

Add a document to a post

GET

/users/{username}/concepts

List concepts for a user

GET

/groups

List all groups

GET

/users/{username}/posts

List posts for a user

POST

/users/{username}/posts

Create a post

PUT

/users/{username}/posts/{resourceHash}

Update a post

POST

/users/{username}/posts/{resourceHash}/documents/

Add a document to a post

GET

/users/{username}/concepts

List concepts for a user

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the BibSonomy REST API by hand means sending your username and API key as HTTP Basic auth on every call and building each user-scoped post path yourself. Through Jentic you install once, import BibSonomy from the API Directory, store the credentials once, and your agent calls it.

Permission scoping

BibSonomy puts the username in the URL path (/users/{username}/posts/...), so a rule can pin your agent to one user's library: it can read and create posts under that user and nothing else. You choose the operations it may call, so post updates or document uploads are not included unless you add them.

Credential isolation

Your BibSonomy username and API key are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'create a BibSonomy post' or 'list a user's references', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using BibSonomy REST API through Jentic.

What authentication does the BibSonomy API use?

BibSonomy uses HTTP Basic authentication with your BibSonomy username and API key (the API key is generated in user settings, separate from the web password). Through Jentic, the basic-auth pair is stored encrypted in the Jentic vault (MAXsystem) and injected at execution time so the agent never sees the API key.

Can I publish a BibTeX entry to my BibSonomy library?

Yes. POST /users/{username}/posts accepts a publication post body that includes the BibTeX fields (title, author, year, and so on) plus tags. The response includes a resourceHash that identifies the new post for later updates or document attachments.

How do I attach a PDF to a BibSonomy post?

After creating the post, POST the file to /users/{username}/posts/{resourceHash}/documents/. The document then appears alongside the post and can be renamed via PUT or removed via DELETE on the same path with the document's filename.

How do I create a BibSonomy post through Jentic?

Search Jentic for 'create a BibSonomy post', load /users/{username}/posts (POST), and execute with the BibTeX entry body. With the SDK: pip install jentic, then SearchRequest, LoadRequest, ExecutionRequest in an async flow — Jentic injects the basic-auth credentials.

Is the BibSonomy API free?

Yes — BibSonomy is run as a free academic service by the University of Kassel and partners. Use it within fair-use rate limits, which are not declared in the OpenAPI spec but enforced server-side.

BibSonomy REST API

Connect the BibSonomy REST API to your agent

Capabilities

Start building with BibSonomy REST API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs