Dokumentation
Newsroom API
Öffentliche REST API für den Pixzl Newsroom. Alle Blogposts, Tags und Suchergebnisse als JSON.
Base URL
https://www.pixzl.de/api/newsroomAlle Anfragen sind GET-Requests. Die API liefert JSON mit UTF-8 Encoding.
Authentifizierung
Die API ist ohne API Key nutzbar:
| Ohne Key | Mit Key | |
|---|---|---|
| Rate Limit | 30 / Minute | Unbegrenzt |
| content_html | Nicht enthalten | Enthalten |
curl -H "X-API-Key: DEIN_KEY" https://www.pixzl.de/api/newsroomEndpunkte
/api/newsroomAlle Blogposts, sortiert nach Datum (neueste zuerst).
| Parameter | Typ | Standard | Beschreibung |
|---|---|---|---|
page | int | 1 | Seitennummer |
per_page | int | 10 | Posts pro Seite (max. 50) |
curl https://www.pixzl.de/api/newsroom?page=1&per_page=5{
"data": [
{
"slug": "headless-cms-nextjs-vs-wordpress",
"title": "Headless CMS mit Next.js...",
"date": "2026-04-06",
"excerpt": "...",
"category": "Marketing",
"tags": ["Webentwicklung", "Next.js"],
"image": "/img/blog/...",
"url": "https://www.pixzl.de/newsroom/..."
}
],
"meta": {
"total": 16,
"page": 1,
"per_page": 5,
"total_pages": 4
}
}/api/newsroom?slug={slug}Einzelnen Blogpost abrufen. Gibt 404 zurück wenn der Slug nicht existiert.
curl https://www.pixzl.de/api/newsroom?slug=headless-cms-nextjs-vs-wordpress/api/newsroom?category={category}Posts nach Kategorie filtern. Unterstützt Paginierung.
curl https://www.pixzl.de/api/newsroom?category=Shopware&per_page=5/api/newsroom?tag={tag}Posts nach Tag filtern. Unterstützt Paginierung.
curl https://www.pixzl.de/api/newsroom?tag=Performance&per_page=5/api/newsroom?search={keyword}Volltextsuche in Titel, Excerpt, Tags und Inhalt.
curl https://www.pixzl.de/api/newsroom?search=SwiftUI/api/newsroom?categoriesAlle Kategorien mit Anzahl der zugehörigen Posts.
curl https://www.pixzl.de/api/newsroom?categories{
"data": [
{ "name": "App-Entwicklung", "count": 5 },
{ "name": "Marketing", "count": 4 },
{ "name": "Shopware", "count": 3 }
]
}/api/newsroom?tagsAlle Tags mit Anzahl der zugehörigen Posts.
curl https://www.pixzl.de/api/newsroom?tagsFehler
| Status | Bedeutung |
|---|---|
404 | Post nicht gefunden |
429 | Rate Limit überschritten |
{ "error": "Rate limit exceeded" }CORS
Browser-Requests sind auf www.pixzl.de beschränkt. Für serverseitige Requests (Node.js, Python, cURL) gibt es keine Einschränkung.
Nutzung
Die API ist kostenlos nutzbar. Wir bitten um faire Nutzung:
- Ohne API Key sind maximal 30 Requests pro Minute erlaubt.
- Cache Ergebnisse wenn möglich — Responses haben
Cache-Control: max-age=300. - Nenne Pixzl als Quelle wenn du Inhalte veröffentlichst.
- Automatisiertes Massen-Scraping ist nicht gestattet.