Lessing-Gymnasium Karlsruhe APIlessing-gymnasium-karlsruhe.de ↗
Access news articles, events, and full-text search from Lessing-Gymnasium Karlsruhe via 4 structured endpoints. Returns titles, dates, authors, and body content.
What is the Lessing-Gymnasium Karlsruhe API?
The Lessing-Gymnasium Karlsruhe API provides structured access to the school website through 4 endpoints covering news articles, individual article content, site-wide search, and upcoming events. The list_news endpoint returns paginated article summaries — including title, author, date, hit count, and intro text — while get_article fetches full body content by URL slug. Search supports boolean operators, and list_events surfaces calendar entries with dates and descriptions.
curl -X GET 'https://api.parse.bot/scraper/657a04d6-c16b-446f-b895-ed2ca81858a2/list_news?page=1&limit=20' \ -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 lessing-gymnasium-karlsruhe-de-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: Lessing-Gymnasium Karlsruhe SDK — school news, events, and search."""
from parse_apis.lessing_gymnasium_karlsruhe_de_api import LessingGymnasium, ArticleNotFound
client = LessingGymnasium()
# List recent news articles from the school blog
for article in client.article_summaries.list(limit=3):
print(article.title, article.author, article.date)
# Drill into one article for full content
summary = client.article_summaries.list(limit=1).first()
if summary:
detail = summary.details()
print(detail.title, detail.hits, detail.body_text[:80])
# Search across all site content
for result in client.search_results.search(query="sport", limit=5):
print(result.title, result.type, result.category)
# Fetch a specific article by slug with error handling
try:
article = client.articles.get(slug="1007-24h-lauf-2026-2")
print(article.title, article.author)
except ArticleNotFound as exc:
print(f"Article not found: {exc}")
# List upcoming school events
for event in client.events.list(limit=5):
print(event.title, event.description)
print("exercised: article_summaries.list / details / search_results.search / articles.get / events.list")
List news articles from the Lessing-Gymnasium blog. Returns paginated results with article summaries including title, author, date, hits, and intro text. Results are auto-iterated across pages of 20 articles each.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination (1-based). |
| limit | integer | Maximum number of articles to return per page. |
{
"type": "object",
"fields": {
"page": "integer",
"articles": "array of article summaries with title, slug, url, author, date, hits, intro",
"total_pages": "integer"
},
"sample": {
"page": 1,
"articles": [
{
"url": "https://lessing-gymnasium-karlsruhe.de/cm3/index.php/neues/1007-24h-lauf-2026-2",
"date": "2026-06-22T13:10:40+00:00",
"hits": 1566,
"slug": "1007-24h-lauf-2026-2",
"intro": "Vom 11. bis zum 12. Juli findet der diesjährige 24h-Lauf für Kinderrechte statt.",
"title": "24h-Lauf",
"author": "Dr. Daniel Roth"
}
],
"total_pages": 37
}
}About the Lessing-Gymnasium Karlsruhe API
News Articles
The list_news endpoint returns paginated article summaries from the school's blog. Each result includes title, slug, url, author, date, hits, and intro text. Results are paginated at 20 articles per page; use the page parameter (1-based) to iterate and total_pages to determine how many pages exist. The limit parameter controls how many articles are returned per request.
Full Article Content
To retrieve the complete text of any article, pass its slug to get_article. The slug format matches what list_news returns (e.g. 1007-24h-lauf-2026-2). The response includes both body_html and body_text, along with author, date, hits, and the canonical url. This makes it straightforward to process article content in either raw or plain-text form.
Search and Events
The search endpoint runs full-text queries across all site content and returns an array of results, each with title, url, type, author, and category. Boolean operators — AND, OR, NOT — are supported directly in the query string, enabling more targeted lookups. The list_events endpoint requires no parameters and returns upcoming school calendar entries with title, url, pub_date, and description. The total field shows how many events are currently listed.
The Lessing-Gymnasium Karlsruhe API is a managed, monitored endpoint for lessing-gymnasium-karlsruhe.de — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when lessing-gymnasium-karlsruhe.de 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 lessing-gymnasium-karlsruhe.de 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?+
- Monitor school news by polling
list_newsand tracking new articles by date or hit count. - Build a custom school newsletter by extracting
body_textfromget_articlefor recent slugs. - Search for specific topics (e.g. sports events or exam schedules) using boolean queries via
search. - Display upcoming school events in a third-party calendar app using
list_eventsoutput. - Aggregate article metadata — author, date, hits — to analyze content popularity over time.
- Index all site content by iterating through
list_newspages and fetching each article by slug.
| 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 Lessing-Gymnasium Karlsruhe offer an official developer API?+
What does `get_article` return beyond the article text?+
get_article returns title, author, date, hits, slug, url, body_html, and body_text. Both HTML and plain-text versions of the article body are included, so you can render formatted content or process clean text depending on your use case.How does pagination work in `list_news`?+
total_pages field so you can determine the full range. Use the page parameter (starting at 1) to step through results, and limit to adjust how many articles are returned per request.Does the API expose individual event detail pages, not just the events list?+
list_events returns each event's title, url, pub_date, and description, but there is no dedicated endpoint to fetch the full content of a single event page. You can fork this API on Parse and revise it to add an individual event detail endpoint.Does the search endpoint support filtering by content type or category?+
search endpoint returns a type and category field per result, but the query input only accepts a plain or boolean text string — there is no filter parameter to restrict results to a specific content type. You can fork this API on Parse and revise it to add category or type filtering.