Posts

Erstellen, auflisten und loeschen Sie Social-Media-Posts ueber die API.

Post erstellen

POST /public/v1/posts

Erstellen Sie einen neuen Post als Entwurf, planen Sie ihn fuer spaeter oder veroeffentlichen Sie ihn sofort.

Anfrage

curl -X POST \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "schedule",
    "date": "2026-05-01T14:00:00Z",
    "posts": [
      {
        "channel": { "id": "channel-uuid" },
        "value": [
          {
            "content": "Schauen Sie sich unsere neueste Produkteinfuehrung an!",
            "id": "unique-uuid",
            "image": []
          }
        ]
      }
    ]
  }' \
  https://api.postzee.app/public/v1/posts

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`type`	string	Ja	`"now"` (sofort veroeffentlichen), `"schedule"` oder `"draft"`
`date`	string	Nur bei Schedule	UTC-Datum im ISO-8601-Format (z.B. `"2026-05-01T14:00:00Z"`)
`posts`	array	Ja	Array von Post-Objekten (eines pro Kanal)
`posts[].channel.id`	string	Ja	Kanal-ID vom Kanaele-Endpunkt
`posts[].value[].content`	string	Ja	Textinhalt des Posts
`posts[].value[].id`	string	Ja	Eindeutiger Bezeichner (UUID) fuer diesen Inhaltsblock
`posts[].value[].image`	array	Nein	Array von Medienobjekten zum Anfuegen
`posts[].settings`	object	Nein	Plattformspezifische Einstellungen (siehe unten)
`tags`	array	Nein	Inhalts-Tags (`[{ "value": "id", "label": "name" }]`)
`shortLink`	boolean	Nein	URL-Kuerzung und Klick-Tracking aktivieren

Plattformspezifische Einstellungen

Fuegen Sie diese in posts[].settings fuer plattformspezifische Funktionen ein: TikTok:

{
  "tiktok": {
    "title": "Video title",
    "privacy_level": "PUBLIC_TO_EVERYONE",
    "duet": true,
    "stitch": true,
    "comment": true
  }
}

YouTube:

{
  "youtube": {
    "title": "Video title",
    "type": "public",
    "tags": [{ "value": "tag1", "label": "Tag 1" }]
  }
}

Instagram:

{
  "instagram": {
    "post_type": "post",
    "collaborators": [{ "label": "@username" }]
  }
}

LinkedIn:

{
  "linkedin": {
    "post_as_images_carousel": true
  }
}

Antwort

Gibt ein Array mit einem Eintrag pro erstelltem Post zurueck:

[
  {
    "postId": "post-uuid",
    "channel": { "id": "channel-uuid" }
  }
]

Posts auflisten

GET /public/v1/posts

Rufen Sie Posts innerhalb eines Datumsbereichs ab.

Anfrage

curl -H "Authorization: YOUR_API_KEY" \
  "https://api.postzee.app/public/v1/posts?startDate=2026-04-01T00:00:00Z&endDate=2026-04-30T23:59:59Z"

Abfrageparameter

Parameter	Typ	Erforderlich	Beschreibung
`startDate`	string	Ja	Startdatum (ISO 8601)
`endDate`	string	Ja	Enddatum (ISO 8601)
`customer`	string	Nein	Nach Kunden-ID filtern

Antwort

{
  "posts": [
    {
      "id": "post-uuid",
      "content": "Post-Textinhalt...",
      "state": "PUBLISHED",
      "releaseId": "17895695668004550",
      "releaseURL": "https://www.instagram.com/p/Cabc123/",
      "publishDate": "2026-04-15T14:00:00Z",
      "channel": {
        "id": "channel-uuid",
        "platform": "instagram",
        "name": "My Instagram",
        "picture": "https://..."
      }
    }
  ]
}

Post-Status abrufen

GET /public/v1/posts/:id

Rufen Sie den Veroeffentlichungsstatus eines einzelnen Posts ab. Da die Veroeffentlichung asynchron erfolgt, koennen Sie damit einen Post nach dem Erstellen pollen: Sobald state den Wert PUBLISHED hat, enthaelt die Antwort die Plattform-Post-ID (releaseId) und den oeffentlichen Permalink (releaseURL).

Anfrage

curl -H "Authorization: YOUR_API_KEY" \
  https://api.postzee.app/public/v1/posts/post-uuid-here

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`id`	string (path)	Ja	Die von Post erstellen zurueckgegebene Post-ID

Antwort

{
  "id": "post-uuid",
  "state": "PUBLISHED",
  "published": true,
  "releaseId": "17895695668004550",
  "releaseURL": "https://www.instagram.com/p/Cabc123/",
  "publishDate": "2026-04-15T14:00:00Z",
  "createdAt": "2026-04-15T13:58:00Z",
  "channel": {
    "id": "channel-uuid",
    "platform": "instagram",
    "name": "My Instagram"
  }
}

Feld	Beschreibung
`state`	`QUEUE` (wartet auf Veroeffentlichung), `PUBLISHED`, `ERROR` oder `DRAFT`
`published`	`true`, wenn `state` den Wert `PUBLISHED` hat
`releaseId`	Die native Plattform-Post-ID (z.B. die Instagram-Media-ID). `null` bis veroeffentlicht
`releaseURL`	Der oeffentliche Permalink zum Post. `null` bis veroeffentlicht

Die Veroeffentlichung erfolgt im Hintergrund, daher ist der Status unmittelbar nach Post erstellen QUEUE und releaseId ist null. Pollen Sie diesen Endpunkt (oder verwenden Sie einen Webhook), bis state den Wert PUBLISHED hat, um die releaseId auszulesen.

Post loeschen

DELETE /public/v1/posts/:id

Loeschen Sie einen Post anhand seiner ID.

Anfrage

curl -X DELETE \
  -H "Authorization: YOUR_API_KEY" \
  https://api.postzee.app/public/v1/posts/post-uuid-here

Parameter

Parameter	Typ	Erforderlich	Beschreibung
`id`	string (path)	Ja	Die zu loeschende Post-ID

Antwort

Gibt bei Erfolg 200 OK zurueck.

Das Loeschen eines veroeffentlichten Posts entfernt ihn aus Postzee, aber nicht von der Social-Media-Plattform. Um veroeffentlichte Inhalte zu entfernen, muessen Sie diese direkt auf der Plattform loeschen.

Beste Zeit finden

GET /public/v1/find-slot/:id

Finden Sie den am wenigsten belegten Zeitslot fuer die Veroeffentlichung.

Anfrage

curl -H "Authorization: YOUR_API_KEY" \
  https://api.postzee.app/public/v1/find-slot/channel-uuid

Antwort

{
  "date": "2026-05-01T10:00:00Z"
}

Gibt einen vorgeschlagenen UTC-Zeitpunkt zurueck, zu dem Ihr Kalender am wenigsten belegt ist.

Übersicht

Endpunkte

Post erstellen

Anfrage

Parameter

Plattformspezifische Einstellungen

Antwort

Posts auflisten

Anfrage

Abfrageparameter

Antwort

Post-Status abrufen

Anfrage

Parameter

Antwort

Post loeschen

Anfrage

Parameter

Antwort

Beste Zeit finden

Anfrage

Antwort

​Post erstellen

​Anfrage

​Parameter

​Plattformspezifische Einstellungen

​Antwort

​Posts auflisten

​Anfrage

​Abfrageparameter

​Antwort

​Post-Status abrufen

​Anfrage

​Parameter

​Antwort

​Post loeschen

​Anfrage

​Parameter

​Antwort

​Beste Zeit finden

​Anfrage

​Antwort

Post erstellen

Anfrage

Parameter

Plattformspezifische Einstellungen

Antwort

Posts auflisten

Anfrage

Abfrageparameter

Antwort

Post-Status abrufen

Anfrage

Parameter

Antwort

Post loeschen

Anfrage

Parameter

Antwort

Beste Zeit finden

Anfrage

Antwort