presseecho API

Entwickler

API-Dokumentation

Pressemitteilungen programmatisch erstellen, mit Bildern versehen und zur Prüfung einreichen — über die versionierte REST-API des Publisher-Hubs.

Grundlagen

Die API v1 ist ein RESTful Web Service mit JSON-Responses. Basis-URL: https://pressekonto.com/api/v1. Eine über die API angelegte Mitteilung ist immer ein Entwurf; veröffentlicht wird sie erst nach dem Einreichen über die Submit-Route und der anschließenden Inhaltsprüfung — sie erscheint dann wie jede andere Mitteilung auf beiden Portalen.

Authentifizierung

Alle Anfragen benötigen einen persönlichen API-Token als Bearer-Header: Authorization: Bearer <token>. Jeder Token trägt Berechtigungen (z. B. press-releases:write), die den Zugriff auf die jeweiligen Endpunkte steuern. Tokens erstellen und widerrufen Sie selbst in Ihrem Publisher-Konto unter „API-Tokens" — Voraussetzung ist eine aktive Buchung (Tarif oder Einzel-Pressemitteilung). Bestandskunden der Altportale: Ihre bisherigen API-Schlüssel wurden übernommen und funktionieren weiter — sowohl als Bearer-Token als auch in der alten Form (X-ApiKey-Header) und auf den dokumentierten /service/…-Pfaden. Für neue Integrationen empfehlen wir die aktuellen /api/v1/…-Endpunkte mit Bearer-Token.

Endpunkte

Pressemitteilungen

GET

/press-releases

Eigene Mitteilungen auflisten (paginiert, filterbar über ?status= und ?per_page=, max. 100). · Berechtigung: press-releases:read

POST

/press-releases

Neue Mitteilung anlegen — immer als Entwurf (Status draft). · Berechtigung: press-releases:write

GET

/press-releases/{id}

Eine Mitteilung inkl. Firma, Rubrik und Bildern abrufen. · Berechtigung: press-releases:read

PATCH

/press-releases/{id}

Mitteilung ändern — nur im Status draft oder rejected. · Berechtigung: press-releases:write

POST

/press-releases/{id}/submit

Zur Inhaltsprüfung einreichen — der einzige Weg Richtung Veröffentlichung. · Berechtigung: press-releases:write

DELETE

/press-releases/{id}

Mitteilung löschen — veröffentlichte Mitteilungen sind ausgenommen. · Berechtigung: press-releases:write

Bilder

GET

/press-releases/{id}/images

Bilder einer Mitteilung auflisten. · Berechtigung: press-releases:read

POST

/press-releases/{id}/images

Bild hochladen (multipart/form-data) — nur bei draft/rejected. · Berechtigung: press-release-images:write

DELETE

/press-release-images/{imageId}

Bild entfernen — nur bei draft/rejected. · Berechtigung: press-release-images:write

Stammdaten

GET

/companies

Eigene Firmenprofile (Newsrooms) auflisten. · Berechtigung: companies:read

GET

/companies/{id}

Ein Firmenprofil abrufen. · Berechtigung: companies:read

GET

/categories

Aktive Rubriken inkl. Übersetzungen — liefert die category_id für neue Mitteilungen. · Berechtigung: press-releases:read

Felder einer Pressemitteilung

Feld	Typ	Pflicht	Beschreibung
portal	string	—	Ziel-Portal (presseecho oder businessportal24). Ohne Angabe entscheidet die aufgerufene Domain, sonst das Portal des Firmenprofils; ein gesetzter Wert hat Vorrang.
company_id	integer	ja	ID eines eigenen Firmenprofils — bestimmt den Newsroom.
category_id	integer	ja	Rubrik (siehe GET /categories).
language	string	ja	Sprachcode, zwei Zeichen: de oder en.
title	string	ja	Überschrift, max. 255 Zeichen.
text	string	ja	Inhalt. Erlaubtes HTML: p, br, h2, h3, strong, em, ul, ol, li, blockquote, a — alles andere wird entfernt.
backlink_url	string	—	Link zur Quelle/Website, max. 255 Zeichen.
keywords	string	—	Schlagworte, kommagetrennt, max. 255 Zeichen.
teaser_begin / teaser_end	integer	—	Zeichen-Offsets für den Teaser-Ausschnitt.
no_export	boolean	—	Mitteilung von Feeds/Exporten ausnehmen.

Felder eines Bild-Uploads

Feld	Typ	Pflicht	Beschreibung
image	file	ja	JPG, PNG oder WebP, max. :mb MB, höchstens 8.000 Pixel je Seite. Ein Titelbild je Mitteilung.
title	string	—	Bildtitel, max. 120 Zeichen.
description	string	—	Bildunterschrift, max. 500 Zeichen.
copyright	string	—	Bildnachweis, wie er unter dem Bild erscheint („Foto: …“), max. 255 Zeichen.
is_preview	boolean	—	Als Vorschaubild setzen (ersetzt ein vorhandenes).

Schneller Einstieg

Der typische Ablauf: Entwurf anlegen, Bild hochladen, zur Prüfung einreichen.

# 1. Entwurf anlegen
curl -X POST https://pressekonto.com/api/v1/press-releases \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "company_id": 1,
    "category_id": 2,
    "language": "de",
    "title": "Neue Produktankündigung",
    "text": "<p>Unser neues Produkt …</p>"
  }'

# 2. Bild hochladen (multipart)
curl -X POST https://pressekonto.com/api/v1/press-releases/123/images \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "image=@pressefoto.jpg" \
  -F "ai_declaration=original" \
  -F "copyright=Mustermann GmbH" \
  -F "is_preview=1"

# 3. Zur Inhaltsprüfung einreichen
curl -X POST https://pressekonto.com/api/v1/press-releases/123/submit \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "ai_text_declaration": "none" }'

Pflicht seit Juli 2026: Der Submit-Aufruf erklärt verbindlich den KI-Grad des Textes (ai_text_declaration: none, assisted, mostly_ai, fully_ai — Transparenzpflicht nach Art. 50 KI-VO) und schließt die Kenntnisnahme der dauerhaften Archivierung ein (AGB § 13). Jedes Bild trägt seine eigene Kennzeichnung (ai_declaration: original, ai_generated, ai_edited).

Maschinenlesbare Referenz: OpenAPI-Spezifikation (YAML).

HTTP-Statuscodes

Code	Bedeutung
200 / 201 / 204	Erfolg — Abruf, Ressource erstellt bzw. gelöscht.
401	Kein oder ungültiger API-Token.
402	Einreichen erfordert eine aktive Buchung (Tarif oder Einzel-PM).
403	Token-Berechtigung fehlt oder die Ressource gehört nicht zu Ihrem Konto.
409	Statuskonflikt — z. B. Bearbeiten einer bereits veröffentlichten Mitteilung.
422	Validierungsfehler oder Kontingent-/Richtlinienverstoß (Details im Body).
429	Rate-Limit erreicht: 60 Anfragen pro Minute je Token (Header X-RateLimit-*).

API-Token erstellen

Tokens verwalten Sie selbst im Publisher-Konto. Bei Fragen zur Anbindung hilft der Support: info@businessportal24.com

Zum Publisher-Konto Preise ansehen