Lmscloud APIsb-augsburg.lmscloud.net ↗
Search the Stadtbücherei Augsburg catalog and get per-copy loan status, due dates, and reservation counts via two structured endpoints.
What is the Lmscloud API?
The Stadtbücherei Augsburg API provides 2 endpoints to query the public library catalog at sb-augsburg.lmscloud.net. Use search_catalog to run full-text searches by title, author, subject, or ISBN and get paginated results with availability summaries. Use get_book_availability to pull per-copy loan status, due dates, reservation counts, and publisher details for any catalog record identified by its biblionumber.
curl -X GET 'https://api.parse.bot/scraper/3145d95d-addb-43f1-a75c-7ac2ef341411/search_catalog?page=1&query=Harry+Potter' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace sb-augsburg-lmscloud-net-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: StadtbuechereiAugsburg SDK — bounded, re-runnable; every call capped."""
from parse_apis.sb_augsburg_lmscloud_net_api import StadtbuechereiAugsburg, BookNotFound
client = StadtbuechereiAugsburg()
# Search the catalog for books, check which are on loan
for book in client.book_summaries.search(query="Harry Potter", limit=3):
print(book.title, book.is_on_loan, book.availability_summary)
# Navigate from a search result to its full availability details
hit = client.book_summaries.search(query="Harry Potter", limit=1).first()
if hit:
try:
detail = hit.details()
print(detail.title, detail.items_on_loan, detail.total_items)
for item in detail.items:
print(item.status, item.due_date, item.library_branch)
except BookNotFound as e:
print("not found:", e.biblionumber)
print("exercised: book_summaries.search, BookSummary.details")
Full-text search across the library catalog. Returns book records with availability summaries indicating which items are on loan, available, or in processing. Results are paginated at 20 per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for paginated results (20 results per page). |
| queryrequired | string | Search query matching title, author, subject, or ISBN. |
{
"type": "object",
"fields": {
"page": "current page number",
"query": "the search query used",
"results": "array of book records with availability",
"total_pages": "total number of pages available",
"total_results": "total number of matching records"
},
"sample": {
"data": {
"page": 1,
"query": "Harry Potter",
"results": [
{
"year": "2025",
"title": "Confusion is next : Die Nullerjahre - das Jahrzehnt des Umbruchs",
"authors": [
"Balzer, Jens, 1969-"
],
"is_on_loan": true,
"biblionumber": "820762",
"is_available": false,
"material_type": "Text",
"availability_summary": "Nicht verfügbar:Zentrale: Ausgeliehen(1)."
}
],
"total_pages": 20,
"total_results": 382
},
"status": "success"
}
}About the Lmscloud API
Catalog Search
The search_catalog endpoint accepts a query string matched against titles, authors, subjects, and ISBNs in the Stadtbücherei Augsburg catalog. Results come back 20 per page; use the page parameter to step through paginated results. Each response includes total_results and total_pages so you can drive paginated loops without guesswork. Each record in the results array carries an availability summary indicating whether copies are on loan, available, or in processing.
Per-Copy Availability
Once you have a biblionumber from search results, pass it to get_book_availability for granular copy-level detail. The items array breaks down every physical copy: its current loan status and, where applicable, its due date. The response also surfaces items_on_loan, total_items, and reservations counts at the record level — useful for checking queue depth before placing a hold. Bibliographic metadata returned includes title, authors, publisher (with city and year), and isbn.
Data Scope
Coverage is limited to the Stadtbücherei Augsburg branch network. Holdings reflect the current catalog state including items in processing. The reservations field shows how many pending holds exist on a title, which can indicate wait times even when copies show as available.
The Lmscloud API is a managed, monitored endpoint for sb-augsburg.lmscloud.net — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when sb-augsburg.lmscloud.net changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official sb-augsburg.lmscloud.net API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Check real-time availability of a specific title before visiting the library branch.
- Build a reading list app that shows loan status and due dates for tracked books.
- Monitor queue depth via the
reservationsfield to estimate wait times for popular titles. - Search by ISBN to verify whether the library holds a specific edition.
- Aggregate catalog coverage across subjects or authors using paginated
search_catalogresults. - Alert users when a currently on-loan copy is approaching its due date.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Stadtbücherei Augsburg provide an official developer API?+
What does `get_book_availability` return for a title with multiple copies?+
items array with one entry per physical copy. Each entry includes that copy's current loan status and its due date if on loan. The response also includes top-level counts: total_items, items_on_loan, and reservations.Does the API cover branch-level location data for individual copies?+
items array exposes loan status and due dates per copy, but branch or shelf location fields are not included in the current response shape. You can fork this API on Parse and revise it to add branch location data if that field is available from the catalog.How does pagination work in `search_catalog`?+
total_results and total_pages so you can calculate how many pages exist for a given query and iterate using the page parameter.Does the API expose account-level data like a patron's current loans or fines?+
search_catalog and item-level availability via get_book_availability. You can fork this API on Parse and revise it to add patron-facing endpoints if that data becomes accessible.