Newsroom API Dokumentation

Base URL

https://www.pixzl.de/newsroom/api

Alle Anfragen sind GET-Requests. Die API liefert JSON mit UTF-8 Encoding.

Authentifizierung

Die API ist ohne API Key nutzbar – mit folgenden Einschränkungen:

	Ohne Key	Mit Key
Rate Limit	30 Requests / Minute	Unbegrenzt
Metadaten	Titel, Excerpt, Tags, Bilder, URL	Alles
`content_html`	Nicht enthalten	Enthalten

Für einen API Key schreib uns eine kurze Nachricht über das Kontaktformular.

Key übergeben

# Per Header
curl -H "X-API-Key: DEIN_KEY" https://www.pixzl.de/newsroom/api

Endpunkte

GET /newsroom/api

Alle Blogposts, sortiert nach Datum (neueste zuerst).

Parameter

Parameter	Typ	Standard	Beschreibung
`page`	int	1	Seitennummer
`per_page`	int	10	Posts pro Seite (max. 50)

Beispiel

curl https://www.pixzl.de/newsroom/api?page=1&per_page=5

{
  "data": [
    {
      "slug": "was-kostet-eine-website-2026",
      "title": "Was kostet eine Website 2026?",
      "date": "2026-03-15",
      "modified": "2026-03-15",
      "excerpt": "Alle Kostenfaktoren im Überblick...",
      "tags": ["Webentwicklung", "Kosten"],
      "image": "/img/blog/was-kostet-website.webp",
      "image_portrait": "",
      "image_width": 1920,
      "image_height": 1080,
      "author": "Pixzl",
      "url": "https://www.pixzl.de/newsroom/was-kostet-eine-website-2026"
    }
  ],
  "meta": {
    "total": 7,
    "page": 1,
    "per_page": 5,
    "total_pages": 2
  }
}

GET /newsroom/api?slug={slug}

Einzelnen Blogpost abrufen. Gibt 404 zurück wenn der Slug nicht existiert.

Beispiel

curl https://www.pixzl.de/newsroom/api?slug=was-kostet-eine-website-2026

GET /newsroom/api?tag={tag}

Posts nach Tag filtern. Unterstützt Paginierung mit page und per_page.

Beispiel

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

GET /newsroom/api?search={keyword}

Volltextsuche in Titel, Excerpt und Inhalt. Unterstützt Paginierung.

Beispiel

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

GET /newsroom/api?tags

Alle Tags mit Anzahl der zugehörigen Posts.

Beispiel

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

{
  "data": {
    "Shopware": 3,
    "SwiftUI": 2,
    "Webentwicklung": 2,
    "WordPress": 1
  }
}

Fehler

Fehler werden als JSON mit passendem HTTP-Statuscode zurückgegeben:

Status	Bedeutung
`404`	Post nicht gefunden
`405`	HTTP-Methode nicht erlaubt (nur GET)
`429`	Rate Limit überschritten – warte 60 Sekunden

{ "error": "Rate limit exceeded" }

CORS

Browser-Requests sind auf www.pixzl.de beschränkt. Für serverseitige Requests (Node.js, Python, PHP, cURL) gibt es keine CORS-Einschränkung.

Nutzung

Die API ist kostenlos nutzbar. Wir bitten um faire Nutzung:

Ohne API Key sind maximal 30 Requests pro Minute erlaubt. Requests über dem Limit werden mit 429 Too Many Requests abgelehnt und für 60 Sekunden blockiert.
Cache Ergebnisse wenn möglich – Responses haben bereits Cache-Control: max-age=300, d.h. identische Anfragen können 5 Minuten lokal zwischengespeichert werden.
Nenne Pixzl als Quelle wenn du Inhalte veröffentlichst.
Automatisiertes Massen-Scraping ist nicht gestattet. Bei Missbrauch behalten wir uns vor, den Zugang dauerhaft zu sperren.

Für höhere Limits oder kommerzielle Nutzung: Sprich uns an.