Zum Hauptinhalt springen
Der Post-Endpunkt ermöglicht es Ihnen, Beiträge in den sozialen Netzwerken zu veröffentlichen: Bluesky, Facebook, Google Business Profile, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Telegram, TikTok, X/Twitter und YouTube. Es gibt zahlreiche Optionen, um Ihren Beitrag anzupassen, z. B. das Planen von Beiträgen, Auto-Hashtags, Auto-Posts-Zeitplan und mehr. Häufig wird dies von Agenturen genutzt, wenn mehrere Beteiligte einen Beitrag vor der Veröffentlichung freigeben müssen. Beginnen Sie mit dem Veröffentlichen von Beiträgen über den /post-POST-Endpunkt.

Freigabe-Workflow

Wenn Ihr Veröffentlichungs-Workflow eine Freigabe vor dem Versand eines Beitrags erfordert, setzen Sie das Feld requiresApproval auf true. Dies entspricht einem Pausieren des Beitrags, bis der Parameter approved auf true gesetzt wird.

Beispiel für den Freigabe-Workflow

Der Beitrag hat den Status „awaiting approval”, bis der Parameter approved über den /post-PATCH-Endpunkt auf true gesetzt wird.
1

Mit Parametern veröffentlichen

Veröffentlichen Sie Ihren Beitrag über den /post-Endpunkt mit dem Feld requiresApproval auf true. Sie können auch Standardparameter wie scheduleDate angeben.
2

Status ist awaiting approval

Der Beitrag hat den Status „awaiting approval” und wird zurückgehalten, bis eine Freigabe erteilt wird.
3

Beitrag freigeben

Aktualisieren Sie den Beitrag mit der /post-PATCH-Operation und setzen Sie das Feld approved auf true. Der Beitrag wird nun zum geplanten Zeitpunkt gesendet.
4

Notizen verwenden

Optional: Setzen Sie notes am Beitrag als Referenz, z. B. wer den Beitrag freigeben muss.
Publish the Post with Approval
Wenn scheduleDate angegeben ist und das Datum in der Vergangenheit liegt, wird der Beitrag unmittelbar nach der Freigabe veröffentlicht.

Freigabe-Workflow-Video

Ein Beispiel für den Freigabe-Workflow sehen Sie im folgenden Video.

Auto-Hashtags

Fügen Sie die relevantesten Hashtags zu Ihrem Beitrag hinzu. autoHashtag ist ein Objekt oder ein Boolean – siehe unten – mit den folgenden Parametern:
  • max: (optional) Ganzzahl der hinzuzufügenden Hashtags, Bereich 1–10. Standard: 2.
  • position: (optional) String „auto” oder „end”. „auto” fügt die Hashtags innerhalb des Beitrags oder am Ende ein. „end” fügt Hashtags nur am Ende ein.
Ein kostenpflichtiger Plan ist erforderlich.
Wenn Sie keine der oben genannten Optionen senden möchten, übergeben Sie den Boolean-Wert true anstelle eines Objekts.

Auto-Repost

Repostet Ihre Inhalte automatisch mehrfach in regelmäßigen Abständen und schafft so Evergreen-Content, der frisch bleibt und für Ihr Publikum sichtbar ist. Ein kostenpflichtiger Plan ist erforderlich. Parameter:
  • repeat: (erforderlich) Die Anzahl der Male, die der Inhalt erneut gepostet wird. Muss zwischen 1 und 10 liegen.
  • days: (erforderlich) Die Anzahl der Tage zwischen den einzelnen Reposts. Muss mindestens 2 Tage betragen.
  • startDate: (optional) Wann der Repost-Zeitplan beginnen soll, im ISO-8601-UTC-Format. Wenn nicht angegeben, wird der erste Beitrag sofort veröffentlicht. Sie sollten den Parameter startDate anstelle des Top-Level-Parameters scheduleDate verwenden.
Auto Repost
Die Antwort enthält alle zukünftig geplanten Reposts sowie eine autoRepostId für jeden Repost.
Auto Repost Response
Beim Erstellen eines Auto-Reposts wird eine autoRepostId zugewiesen, um diese Serie von Beiträgen zu verfolgen. Sie können alle Auto-Reposts eines Beitrags über den History-Aufruf mit der autoRepostId abrufen. Wenn Sie einen Repost löschen müssen, verwenden Sie den DELETE-Aufruf mit der Post-ID.
Wichtig: Beim Einsatz von Auto-Repost stellen Sie sicher, dass Sie die Posting-Frequenz-Richtlinien der jeweiligen sozialen Netzwerke einhalten, um Kontoeinschränkungen zu vermeiden.Hinweis: Die Funktion autoRepost kann nicht zusammen mit scheduleDate verwendet werden. Wenn Sie beide Parameter angeben, hat scheduleDate Vorrang und autoRepost wird ignoriert. Verwenden Sie stattdessen den Parameter startDate.

First Comment

Fügt automatisch nach der Veröffentlichung des Beitrags einen ersten Kommentar (mit Medien) hinzu. Bei TikTok wird der Kommentar verzögert, bis die Videoverarbeitung abgeschlossen ist (siehe First-Comment-Verarbeitungszeit). Ein erster Kommentar unter Ihrem eigenen Social-Media-Beitrag kann Engagement anregen und die Tonalität der nachfolgenden Diskussion setzen.

First-Comment-Verarbeitungszeit

Bei den meisten sozialen Netzwerken ist die API-Antwort verzögert, da unser System (1) warten muss, bis der ursprüngliche Beitrag vollständig veröffentlicht ist, und dann (2) den Kommentar zu diesem veröffentlichten Beitrag hinzufügen muss. Dieser sequenzielle Vorgang führt zu einer Verzögerung von etwa 20 Sekunden. TikTok wird anders behandelt. TikTok verarbeitet Videos asynchron, sodass die id des Beitrags "pending" ist, bis das Webhook post.publish.publicly_available von TikTok die tatsächliche Video-ID auflöst (siehe TikTok-Verarbeitung). Die /post-Antwort gibt daher den TikTok-First-Comment sofort mit status: "pending" zurück, und der Kommentar wird automatisch gepostet, sobald TikTok die Verarbeitung abgeschlossen hat und das tikTokPublished-Scheduled-Action-Webhook ausgelöst wird. TikTok garantiert keine Verarbeitungszeit, daher gibt es keine feste Verzögerung. Wichtiger TikTok-Hinweis: Damit First Comments auf TikTok ordnungsgemäß funktionieren, muss der Parameter visibility des Beitrags auf public gesetzt sein. Ein nicht-öffentliches Video erhält das Webhook publicly_available nicht, sodass sein First Comment nicht gepostet werden kann; in diesem Fall gibt Ayrshare einen Kommentar-Fehler zurück, anstatt ihn im Zustand pending zu belassen.

Idempotente Beiträge

Idempotenz ist eine optionale Funktion, die sicherstellt, dass eine Anfrage nur einmal ausgeführt wird, auch wenn sie versehentlich mehrfach gesendet wird. Beim Posten von Inhalten über die API können Sie im Anfragetext einen optionalen Parameter idempotencyKey angeben, um den Vorgang eindeutig zu identifizieren. So können Sie die Post-Anfrage sicher erneut ausführen, ohne das Risiko, Duplikate zu erzeugen. Um Idempotenz zu nutzen, fügen Sie den Parameter idempotencyKey zum JSON-Body der /post-POST-Anfrage hinzu:
Idempotency Key
Der Wert von idempotencyKey sollte ein pro Benutzerprofil eindeutiger String sein. Wird für ein bestimmtes Benutzerprofil eine Anfrage mit demselben idempotencyKey gestellt, wird unabhängig vom Status des Beitrags (success, error, pending oder deleted) ein Fehler zurückgegeben, der auf einen doppelten Schlüssel hinweist.
Die API muss die POST-Anfrage zunächst annehmen und verarbeiten, um den Idempotenz-Schlüssel zu speichern und auf Duplikate zu prüfen. Wenn jedoch mehrere POST-Anfragen mit demselben idempotencyKey gleichzeitig gesendet oder auf denselben Post-Zeitpunkt geplant werden, erkennt die API möglicherweise die doppelten Schlüssel nicht. Das liegt daran, dass die API diese gleichzeitigen oder gleichzeitig geplanten Anfragen parallel verarbeitet, bevor sie den Idempotenz-Schlüssel einer einzelnen Anfrage registrieren kann. Es gibt daher keine Garantie, dass doppelte Idempotenz-Schlüssel in solchen Szenarien gleichzeitiger Einreichung oder Ausführung geplanter Beiträge erkannt werden.
Idempotenz hilft, die versehentliche Erstellung doppelter Beiträge beim Wiederholen fehlgeschlagener Anfragen oder bei Netzwerkproblemen zu vermeiden. Es wird jedoch weiterhin empfohlen, in Ihrer Anwendung angemessene Fehlerbehandlungs- und Retry-Mechanismen zu implementieren, um potenzielle Fehler elegant zu handhaben.

Bild- und Video-Anforderungen

Das Posten von Bildern und Videos hat für jedes Netzwerk unterschiedliche Anforderungen, aber keine Sorge. Unser System prüft Ihren Beitrag vor dem Senden, sodass Sie eine Fehlerantwort erhalten, falls etwas nicht stimmt. Details zu Bild- und Video-Richtlinien finden Sie unter dem folgenden Link.

Bild- und Video-Richtlinien

Gültige URL

Stellen Sie sicher, dass Ihre Medien-URL(s) gültig sind und direkt auf die Medien zugreifen. Ein erster Test ist der Aufruf der URL in einem Browser. Wenn sich das Bild im Browser nicht laden oder herunterladen lässt, wird es wahrscheinlich fehlschlagen. Zum Beispiel funktioniert eine DropBox-URL, die die DropBox-Web-App öffnet, nicht.
Wenn Sie eine Google-Drive-Share-URL oder eine Dropbox-Share-URL haben, können Sie die URL einfach im Parameter mediaUrls beim Veröffentlichen eines Beitrags oder Kommentars verwenden. Ayrshare wandelt die Share-URL automatisch in einen Download-Link um.
Wir verifizieren die Medien-URL, indem wir eine HEAD-Anfrage durchführen. Stellen Sie sicher, dass der Hosting-Anbieter die HEAD-Anfrage nicht blockiert, sonst schlägt der Beitrag mit einem 403-Fehler fehl. Hier ein Beispiel für eine HEAD-Anfrage an die Medien-URL:
Fetch HEAD Request

Automatisierter Medienschutz

Ayrshare enthält einen integrierten Medienschutz, der bestimmte Probleme bei der Medienübermittlung während des Postens erkennen und beheben kann. Wenn ein Beitrag erfolgreich ist, aber ein Inhaltsproblem erkannt und behoben wurde, enthält jeder betroffene Eintrag in postIds[] ein optionales contentIssues-Objekt, mit dem Sie das zugrunde liegende Problem identifizieren und beheben können:
Wenn Sie originMediaHostFailed in Ihren Antworten sehen, überprüfen Sie Ihre Medien-Hosting-Konfiguration. Häufige Ursachen und Lösungen finden Sie unter Meta Media Crawler blockiert.

Leerzeichen und Sonderzeichen

Wir empfehlen, in Ihren Medien-URLs Folgendes zu vermeiden:
  • Leerzeichen in der URL.
  • URL-kodierte Leerzeichen in der URL.
  • Sonderzeichen in der URL, auch wenn sie URL-kodiert sind, etwa Akzente wie é.
Zum Beispiel:
Diese URL schlägt aufgrund des Leerzeichens test .webp fehl. Wir empfehlen außerdem, keine URL-kodierten Leerzeichen wie %20 in der URL zu verwenden – dies kann bei manchen sozialen Netzwerken ebenfalls Probleme verursachen. Und dieses Unsplash-Bild:
Dieses Unsplash-Bild schlägt fehl, weil es nicht direkt auf das Bild zugreift, sondern eine Web-App anzeigt.

Dateinamen und URLs bereinigen

Sie können Ihre Dateinamen mit einem regulären Ausdruck wie /[^a-z0-9\/\.]/gi bereinigen.
oder eine URL bereinigen:

Weitere Informationen

  • Wenn Sie selbst hosten, stellen Sie sicher, dass die URL extern erreichbar ist und keine besonderen Berechtigungen erfordert.
  • Siehe unten, wie mit Videos mit unbekannten Endungen umgegangen wird, oft signierte URLs wie bei AWS S3.
  • Wenn Sie eine signierte URL wie S3 verwenden, empfehlen wir, die URL-Ablaufzeit auf mindestens 7 Tage zu setzen. So kann unser Team Sie bei Fragen zur Veröffentlichung des Beitrags unterstützen.
  • Prüfen Sie mit unseren Medien-Verifikationstools, ob die Medien-URL existiert.

Download-Geschwindigkeit

Stellen Sie sicher, dass Ihr Medien-Hosting eine schnelle Verbindung hat, insbesondere die Download-Geschwindigkeit. Sie können die Leistung Ihres Medien-Hostings unter pingdom testen. Wir empfehlen mindestens eine B-Bewertung.

Videoendung

Wenn Ihre URL nicht mit einer bekannten Videoendung wie mp4 endet, können Sie im Beitrag das Feld isVideo: true verwenden, um festzulegen, dass es sich bei der mediaUrl um ein Video handelt. Ayrshare versucht, den Dateityp zu ermitteln, z. B. MOV. Wir empfehlen jedoch, Ihre Videodatei explizit mit einer bekannten Endung wie mp4 zu versehen, da dies bei den sozialen Netzwerken eine höhere Erfolgsquote hat.

Nur Bild oder Video

Einige soziale Netzwerke unterstützen das Senden von Medien ohne Beitragstext. Wenn Sie keinen Beitragstext einfügen möchten, senden Sie einen leeren String: post: "" Die folgenden sozialen Netzwerke unterstützen Beiträge ohne Text/leer: Facebook, Instagram, LinkedIn, Threads, TikTok und X/Twitter.

Bilder und Videos testen

Erwägen Sie, zufälligen Text und zufällige Bilder oder Videos zu generieren, um Ihre Tests zu beschleunigen. Sie müssen sich nicht für jeden Testbeitrag etwas Neues ausdenken!

Zeilenumbrüche

Wenn Sie Zeilenumbrüche (neue Zeilen) in einem Beitrag verwenden möchten, verwenden Sie den unsichtbaren Zeilenumbruch \u2063\n. Zum Beispiel This is a new\u2063\nline..Wir empfehlen außerdem, es in Postman zu testen, um zu sehen, wie der neue Zeilenumbruch in Ihrer bevorzugten Sprache übersetzt wird. Zum Beispiel verwendet PHP oft nur ein \n.Einige soziale Netzwerke unterstützen Zeilenumbrüche im Beitragstext derzeit nicht.

Multi-Plattform-Beiträge und Medien

Diese Funktion erlaubt es Ihnen, Inhalte und Medien Ihres Beitrags in einem einzigen API-Aufruf für verschiedene soziale Netzwerke anzupassen. Sie können eindeutigen Text und/oder Bilder für jede Plattform angeben, indem Sie für die Felder post und mediaUrls Objekte verwenden.
  1. Verwenden Sie eine Objektstruktur für die Felder post und/oder mediaUrls.
  2. Geben Sie plattform-spezifische Inhalte mit den Plattformnamen als Schlüsseln an.
  3. Fügen Sie einen default-Schlüssel für Inhalte hinzu, die auf Plattformen verwendet werden sollen, die nicht explizit angegeben sind.
Im obigen Beispiel:
  • Instagram verwendet seinen spezifischen Text und die Bild-URL.
  • Facebook verwendet seinen spezifischen Text und die Standard-Bild-URL.
  • LinkedIn verwendet den Standardtext und seine spezifische Bild-URL.
Wenn Sie mehrere Bilder auf verschiedene Plattformen posten müssen, erstellen Sie separate Beiträge für jede Plattform, anstatt diese Multi-Plattform-Struktur zu verwenden.

Profile Keys

Posten Sie im Namen eines Nutzers, indem Sie den Profile Key des Nutzers als Body-Parameter angeben und die zusätzlichen Daten in der Antwort erhalten. Business- oder Enterprise-Plan erforderlich.

Profiles

Rich-Text-Beiträge

Sie können Rich Text wie „𝓗𝓮𝓵𝓵𝓸, how about a little 𝗯𝗼𝗹𝗱 𝘁𝗲𝘅𝘁 and 𝘪𝘵𝘢𝘭𝘪𝘤𝘴 𝘵𝘦𝘹𝘵 and an x₂?” hinzufügen. Sie können Rich Text in Netzwerken wie Twitter, Facebook, LinkedIn, Telegram und Instagram verwenden. Bei Reddit verwenden Sie bitte Reddit-flavored Markdown-Formatierung. HTML-Elemente werden verwendet, um die Art des Rich Text anzugeben, der in Unicode übersetzt wird. Zum Beispiel:

HTML-Elemente

HTMLBeispiel
<b>Nice One!</b>Nice One!
<strong>Hello, world!</strong>Hello, world!
<em>World</em>World
normal <i>italics <b>bold italics</b></i>normal italics bold italics
`<b>Hello</b>, world!`Hello, world!
`<b>Hello</b>, world!`Hello, world!
<samp>123</samp>𝟷𝟸𝟹
<var>Hello</var>𝓗𝓮𝓵𝓵𝓸
x<sub>2</sub>x₂
x<sup>2</sup>

CSS-Codes

CodeBeispielErgebnis
\u00B0It’s 25\u00B0C today!It’s 25°C today!
\u2063\nThis is a new\u2063\nline.This is a new
line.

Beiträge planen

Geplante Beiträge erstellen

Sie können zukünftige Beiträge planen, indem Sie den Parameter scheduleDate mit der Datum/Zeit in Zulu/UTC angeben. Zulu-Zeit, auch bekannt als Coordinated Universal Time (UTC), ist der weltweit standardisierte Zeitrahmen. Verwenden Sie zum Beispiel das Format YYYY-MM-DDThh:mm:ssZ und senden Sie 2026-07-08T12:30:00Z. Weitere Beispiele finden Sie unter utctime.
Unter https://www.utctime.net/ erfahren Sie, wie Sie Ihre lokale Zeit in Zulu/UTC-Zeit umrechnen. Liegt das geplante Datum in der Vergangenheit, wird der Beitrag sofort gesendet.
Wenn ein mediaUrl mit einem geplanten Beitrag enthalten ist, muss das Medium zum geplanten Veröffentlichungszeitpunkt verfügbar sein. Wenn der Beitrag beispielsweise für den 5. März 2026 geplant ist, muss das Medium am 5. März 2026 verfügbar sein.
Fehlerbehandlung bei geplanten vs. sofortigen BeiträgenEs gibt einen wichtigen Unterschied bei der Behandlung von Validierungsfehlern zwischen sofortigen und geplanten Beiträgen:
  • Sofortige Beiträge
    • Beim sofortigen Veröffentlichen (ohne scheduleDate) werden – wenn eine Plattform die Validierungsprüfungen nicht besteht – die anderen Plattformen weiterhin verarbeitet. Wenn ein Beitrag beispielsweise Twitters Zeichenlimit überschreitet, aber für Facebook und Instagram gültig ist, schlägt der Beitrag auf Twitter fehl, wird aber trotzdem auf Facebook und Instagram veröffentlicht.
  • Geplante Beiträge
    • Beim Planen von Beiträgen für die zukünftige Veröffentlichung (mit scheduleDate) müssen alle Plattformen die initialen Validierungsprüfungen bestehen, bevor der Beitrag geplant wird. Schlägt eine Plattform diese Vorabvalidierung fehl, wird der gesamte Planungsvorgang abgelehnt und es wird sofort ein Fehler zurückgegeben.
    • Einige plattform-spezifische Fehler können jedoch erst zum tatsächlichen Post-Zeitpunkt erkannt werden. In diesen Fällen versucht der geplante Beitrag, auf allen Plattformen zu veröffentlichen, und einzelne Plattform-Fehler werden in den Endergebnissen gemeldet, ohne die anderen Plattformen zu beeinflussen.

Status eines geplanten Beitrags prüfen

Sie können den Status eines geplanten Beitrags auf mehrere Arten prüfen:
  • Richten Sie das Webhook Scheduled Action ein, um den Status des geplanten Beitrags automatisch zu empfangen. Dies ist im Business-Plan verfügbar und ist die empfohlene Methode.
  • Rufen Sie den Status eines geplanten Beitrags mit dem GET-Aufruf und der Post-ID ab.
  • Prüfen Sie den Status im Ayrshare-Dashboard. Wechseln Sie zunächst zum Nutzerprofil, unter dem der Beitrag veröffentlicht wurde, und gehen Sie dann zur Seite „Posts” und suchen Sie mit der Ayrshare-Post-ID.

Geplante Beiträge pausieren

Sie können geplante Beiträge, die noch nicht veröffentlicht wurden, pausieren. Das Pausieren eines geplanten Beitrags verhindert seine Veröffentlichung, bis er wieder fortgesetzt wird. Verwenden Sie den PATCH-Aufruf, um den geplanten Beitrag zu pausieren oder fortzusetzen. Beachten Sie: Wird ein Beitrag fortgesetzt und das scheduleDate liegt in der Vergangenheit, wird der Beitrag sofort veröffentlicht. Ziehen Sie in Erwägung, das scheduleDate vor dem Fortsetzen zu aktualisieren. Links in einem Beitrag können mit dem Ayrshare-Link-Shortener verkürzt werden. Sie können die automatische Link-Verkürzung mit dem Parameter shortenLinks beim Senden eines Beitrags aktivieren. Max Pack erforderlich.

Unsplash-Bilder

Die folgenden Felder sind für den Body-Parameter unsplash verfügbar:
  • Zufälliges Bild: random liefert ein zufälliges Unsplash-Bild.
  • Suchbasiertes Bild: Wert String Suchbegriff; z. B. money wählt ein zufälliges Bild basierend auf money aus.
  • Bild-IDs: Wert Array von IDs; z. B. [“HubtZZb2fCM”] des Bildes https://unsplash.com/photos/HubtZZb2fCM
Wenn Sie eine Unsplash-URL in mediaUrls posten, achten Sie darauf, die Bildadresse zu kopieren und nicht nur die URL. Weitere Informationen finden Sie in diesem Beispiel.