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/newsroom

Alle 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/newsroom

Endpunkte

GET/api/newsroom

Alle 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
  }
}

GET/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

GET/api/newsroom?category={category}

Posts nach Kategorie filtern. Unterstützt Paginierung.

curl https://www.pixzl.de/api/newsroom?category=Shopware&per_page=5

GET/api/newsroom?tag={tag}

Posts nach Tag filtern. Unterstützt Paginierung.

curl https://www.pixzl.de/api/newsroom?tag=Performance&per_page=5

GET/api/newsroom?search={keyword}

Volltextsuche in Titel, Excerpt, Tags und Inhalt.

curl https://www.pixzl.de/api/newsroom?search=SwiftUI

GET/api/newsroom?categories

Alle 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 }
  ]
}

GET/api/newsroom?tags

Alle Tags mit Anzahl der zugehörigen Posts.

curl https://www.pixzl.de/api/newsroom?tags

Fehler

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.