Ayrshare-API-Übersicht - Ayrshare API Documentation

Die Social-Media-REST-API bietet Entwicklern programmatischen Zugriff auf mehrere soziale Netzwerke über eine einzige einheitliche Schnittstelle. Über die Social-API von Ayrshare können Sie Social-Media-Aktivitäten verwalten, darunter das Erstellen und Löschen von Beiträgen, das Abrufen von Analytics, die Interaktion mit Kommentaren und Bewertungen, die Verwaltung von Direktnachrichten, das Erstellen von Facebook-Anzeigen und die Durchführung weiterer Social-Media-Aktionen über verschiedene Plattformen hinweg. Die API unterstützt derzeit 13 wichtige soziale Netzwerke: Bluesky, Facebook, Google Business Profile, Instagram, LinkedIn, Pinterest, Reddit, Snapchat, Telegram, Threads, TikTok, X (früher Twitter) und YouTube. Durch die Integration dieser API können Entwickler Social-Media-Managementaufgaben gleichzeitig über alle diese Plattformen hinweg automatisieren. Anfragen und Antworten der API sind im JSON-Format, was das Parsen und Verarbeiten in den meisten Programmiersprachen erleichtert. Wenn Sie den Launch-, Business- oder Enterprise-Plan nutzen, siehe die Business-Plan-Übersicht, die Launch-Plan-Übersicht und den /profiles-API-Endpunkt.

Kernfunktionen

13 unterstützte soziale Netzwerke.
Sicherer API-Zugriff mit Ihrem eindeutigen API-Key.
Geplantes Posten in verbundene Social-Media-Plattformen.
Automatisiertes Posten basierend auf vordefinierten Zeitplänen.
Unterstützung für Bild- und Videoinhalte, einschließlich Reels, Stories und Spotlight.
Löschen von Beiträgen in verknüpften sozialen Netzwerken.
Umfassende Engagement-Analytics für Beiträge (Likes, Shares usw.).
Metriken zu sozialen Konten, einschließlich Follower-Zahl und demografischer Daten.
Kommentarverwaltung: Beitragskommentare anzeigen, hinzufügen und löschen.
Optionale Link-Verkürzung für alle oder bestimmte URLs in Beiträgen.
Unsplash-Integration: Fügen Sie bestimmte Bilder hinzu oder wählen Sie basierend auf Schlüsselwörtern zufällig aus.
Option zur automatischen Hashtag-Generierung anhand relevanter Schlüsselwörter.
Verfolgung des Beitragsverlaufs, einschließlich nicht von Ayrshare stammender Beiträge.
Bewertungsverwaltung: Antworten auf Bewertungen abrufen, beantworten und löschen.
RSS-Feed-Integration für automatisiertes Posten von Inhalten.
Medienbibliothek: Fotos und Videos für die Verwendung in Beiträgen hochladen und speichern.
Social-Post-Verifizierungssystem, um Ihre sozialen Konten sicher zu halten.

Business-Plan und Launch-Plan

Funktionen für Business-Plan und Launch-Plan zur Verwaltung mehrerer Nutzer und Kunden:

Ermöglichen Sie Nutzern, ihre eigenen Social-Media-Konten mit Ihrer Plattform zu verknüpfen.
Sicheres Single Sign-On mit OAuth für die schnelle Kontoverknüpfung.
Nutzerprofile programmatisch über die API erstellen und entfernen.
Zugriff auf erweiterte Nutzeranalytics.
Webhook-Unterstützung für Echtzeit-Updates.
Verwaltung von Direktnachrichten über die unterstützten Plattformen hinweg.
Erstellen Sie Facebook-Anzeigen aus bestehenden Beiträgen.

Kontaktieren Sie uns, um mehr über den Business-Plan zu erfahren.

Ads API

Die Ads API ermöglicht es Ihnen, Facebook-Anzeigen aus vorhandenen Beiträgen zu erstellen.

Beiträge boosten, um mehr Menschen zu erreichen.
Anzeigen verwalten und Performance verfolgen.
Werbeausgaben analysieren und Kampagnen optimieren.

Ads API

Entdecken Sie die Ads API

Messages API

Eine einheitliche Messaging API für Nutzergespräche über die wichtigsten Social-Media-Kanäle: Facebook, Instagram und X.

Text-, Bild- und Videonachrichten senden.
Vollständige Konversationsverläufe abrufen.
Automatisierte Nachrichten-Antworten einrichten.
Echtzeit-Updates über Webhooks für empfangene Nachrichten, Nachrichtenreaktionen und Lesebestätigungen empfangen.

Diese API vereinfacht die Nutzerinteraktion, indem sie Messaging-Vorgänge über mehrere Social-Media-Kanäle zentralisiert. Erfahren Sie mehr…

Messages API

Entdecken Sie die einheitliche Messaging-API

Max Pack

Erweitern Sie Ihre Möglichkeiten mit dem Max-Pack-Add-on:

Max Pack

Schalten Sie mit unserem Max-Pack-Add-on erweiterte Funktionen frei, wie KI-gestützte Inhaltsgenerierung, verbesserte Analytics und erweiterte Plattformunterstützung.

Wenn Sie in Node.js entwickeln, sehen Sie sich dieses Video zum Verbinden und Veröffentlichen von Beiträgen auf X und Facebook an.

Wenn Sie Node.js verwenden, finden Sie hier den Beispielcode zur Social API, um Ihre eigene Integration aufzubauen.

Social-API-Demo

Entdecken Sie unseren Node.js-Democode als Ausgangspunkt für Ihre Social-API-Integration

Base-URL

Die Base-URL für die Ayrshare API ist für alle Endpunkte identisch. https://api.ayrshare.com/api

Autorisierung

Ayrshare authentifiziert API-Anfragen über einen Autorisierungstoken, der im HTTP-Header übergeben wird. Achten Sie darauf, Bearer zusammen mit dem API-Key zu senden. Den API-Key finden Sie im Ayrshare-Dashboard, indem Sie zu Ihrem Primary Profile wechseln. Als Business- oder Enterprise-Nutzer können Sie Nutzerprofile mit Profile Keys erstellen, um mehrere Kunden zu verwalten. Der Profile Key wird im Header Ihrer Anfragen verwendet. Der API-Key muss ebenfalls im Header Ihrer Anfragen für Nutzerprofile verwendet werden.

Premium-Pläne sollten nur den API-Key im Header ihrer Anfragen verwenden. Business- und Enterprise-Pläne sollten den Profile Key im Header ihrer Anfragen verwenden, wenn sie im Namen eines Nutzerprofils interagieren.

API-Key-Format

Authorization: Bearer API_KEY, wobei Sie API_KEY durch den API-Key Ihres Primary Profile ersetzen, den Sie im Ayrshare-Dashboard finden.

curl -H "Authorization: Bearer API_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

$headers = ["Authorization" => "Bearer API_KEY"];

headers := map[string]string{"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

headers = {"Authorization": "Bearer API_KEY"}

Ihren geheimen API-Key erhalten Sie im Ayrshare-Dashboard auf der Seite API Key im linken Navigationsbereich.Wenn Ihr API-Key beispielsweise 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA lautet:Ihr Header sollte enthalten:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EA

Profile-Key-Format

Ein Profile Key wird verwendet, um im Namen eines Nutzerprofils zu interagieren. Dies ist nur für Business- oder Enterprise-Pläne verfügbar. Profile-Key: PROFILE_KEY, wobei Sie PROFILE_KEY durch den Profile Key eines Nutzers ersetzen. Die Angabe eines Profile Key im Header ist erforderlich, um im Namen eines Nutzerprofils zu interagieren. Ein fehlender API-Key des Primary Profile oder die Verwendung des Profile Key anstelle des API-Keys im Header führt zu einem Fehler. So strukturieren Sie die Header für API-Anfragen:

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY"
}

Finden Sie den Profile Key im Ayrshare-Dashboard auf der Seite Profile Key im linken Navigationsbereich. Wechseln Sie auf der Nutzerprofil-Seite zum gewünschten Profil. Der Profile Key wird zudem in der Antwort des Endpunkts Nutzerprofil erstellen zurückgegeben.Sie können den Profile Key dann im Header Ihrer Anfragen verwenden:Wenn Ihr Profile Key beispielsweise AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA lautet:Ihr Header sollte sowohl den API- als auch den Profile Key enthalten:Authorization: Bearer 2MPXPKQ-S03M5LS-GR5RX5G-AZCK8EAProfile-Key: AX1XGG-9jK3M5LS-GR5RX5G-LLCK8EA

X/Twitter-BYO-Anmeldedaten

Ab dem 31. März 2026 erfordern alle X-/Twitter-Vorgänge über Ayrshare Ihre eigenen OAuth-1.0a-Anmeldedaten. Nachdem Sie Ihr X-Konto über OAuth verknüpft haben, übergeben Sie diese 2 Header zusammen mit Ihren Authorization- (und optional Profile-Key-) Headern bei jeder Anfrage, die sich an X/Twitter richtet:

Header	Beschreibung
`X-Twitter-OAuth1-Api-Key`	Ihr OAuth-1.0a-API-Key (Consumer Key)
`X-Twitter-OAuth1-Api-Secret`	Ihr OAuth-1.0a-API-Key-Secret (Consumer Secret)

Diese Header sind nach dem 31. März 2026 erforderlich. Anfragen an X-/Twitter-Endpunkte ohne gültige BYO-Anmeldedaten werden abgelehnt.

Ein Schlüsselpaar, für jede Anfrage verwendet. Sie erstellen eine X-Developer-App pro Ayrshare-Konto und verwenden dieselben Werte für X-Twitter-OAuth1-Api-Key und X-Twitter-OAuth1-Api-Secret bei jeder Anfrage, die sich an X richtet – unabhängig davon, für welches Sub-Profil (Profile-Key) die Anfrage bestimmt ist. Sie erzeugen oder rotieren keine Schlüssel pro Kunde oder Endnutzer.

Siehe den X BYO Key Setup-Leitfaden für Schritt-für-Schritt-Anleitungen, Codebeispiele und Fehlerbehebung. Dieselben zwei Header gelten auch beim Ansteuern von X/Twitter über den MCP-Server — siehe Verbinden & Einrichten.

Content-Type

Der Content-Type sollte immer auf Content-Type: "application/json" gesetzt sein, sofern der Endpunkt nichts anderes angibt.

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json"
}

Komprimierung

Ayrshare unterstützt Komprimierung für alle API-Anfragen. Um die Komprimierung zu aktivieren, setzen Sie den Header Accept-Encoding auf deflate, gzip, br.

  Accept-Encoding: "deflate, gzip, br"

Dies wird für den Abruf größerer Antworten wie über den /history-Endpunkt empfohlen.

Nur Antworten über 1024 Bytes (1 KB) werden komprimiert.
Reihenfolge der verwendeten Komprimierung: zuerst Brotli (br), dann gzip, dann deflate. Brotli ist der effizienteste Komprimierungsalgorithmus.
Der Antwort-Header enthält die verwendete Content-Encoding. Zum Beispiel: content-encoding: br, wenn Brotli verwendet wurde.
Mehr über Komprimierung und ihre Vorteile erfahren Sie im Ayrshare-Blog.

Vergessen Sie nicht, die Antwort mit der Content-Encoding ordnungsgemäß zu dekomprimieren.

curl -H "Authorization: Bearer API_KEY" \ 
     -H "Profile-Key: PROFILE_KEY" \ # Optional
     -H "Content-Type: application/json" \
     -H "Accept-Encoding: deflate, gzip, br" \ 
     -X GET https://api.ayrshare.com/api

headers: {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

$headers = [
  "Authorization" => "Bearer API_KEY",
  "Profile-Key" => "PROFILE_KEY", # Optional
  "Content-Type" => "application/json",
  "Accept-Encoding" => "deflate, gzip, br"
];

headers := map[string]string{
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", # Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

headers = {
  "Authorization": "Bearer API_KEY",
  "Profile-Key": "PROFILE_KEY", // Optional
  "Content-Type": "application/json",
  "Accept-Encoding": "deflate, gzip, br"
}

ID-Typen

Es werden mehrere Arten von IDs zurückgegeben, die in verschiedenen Endpunkten verwendet werden können:

Ayrshare-Post-ID

Diese ID wird von Ayrshare generiert und vom /post-Endpunkt im Feld id zurückgegeben. Diese ID vereinfacht es, Analytics zum Beitrag über soziale Netzwerke hinweg abzurufen, Kommentare zum Beitrag hinzuzufügen, den Beitrag zu löschen usw. Diese ID werden Sie am häufigsten verwenden. Jedes soziale Netzwerk vergibt eigene eindeutige IDs für Beiträge und Kommentare. Diese IDs werden im Feld postIds der /post- oder /comments-Endpunkte zurückgegeben. Sie können diese IDs oder IDs, die Sie direkt aus den sozialen Netzwerken beziehen, verwenden, um Daten abzurufen, z. B. mit der Analytics-Social-Post-ID.

Ayrshare-Comment-ID

Diese ID wird von Ayrshare generiert und vom /comments-Endpunkt im Feld id zurückgegeben. Diese ID vereinfacht es, Analytics zum Kommentar über soziale Netzwerke hinweg abzurufen, Antworten auf den Kommentar hinzuzufügen, den Kommentar zu löschen usw. Diese ID werden Sie am häufigsten verwenden. Dies wird häufig verwendet, wenn Sie Details zu einem bestimmten, über Ayrshare veröffentlichten Kommentar erhalten möchten. Jedes soziale Netzwerk vergibt eigene eindeutige IDs für Kommentare. Diese IDs werden im Feld commentId des Endpunkts GET /comments zurückgegeben. Dies wird häufig verwendet, wenn Sie Details zu einem bestimmten, außerhalb von Ayrshare veröffentlichten Kommentar erhalten möchten.

Fehlercodes

Fehler werden mit Standard-HTTP-Statuscodes zurückgegeben. Weitere Informationen:

HTTP-Statuscodes

Mehr über HTTP-Statuscodes erfahren

Detaillierte Fehler sind in der REST-API-Antwort spezifisch für jede Art von Aufruf enthalten. Weitere Informationen:

Ayrshare-Fehlercodes

Mehr über Ayrshare-spezifische Fehlercodes erfahren

Zeitstempel-Format

Ayrshare verwendet Zulu Time, auch bekannt als UTC (Coordinated Universal Time), oder ein ISO-8601-formatiertes Datumsstring für präzise und eindeutige Zeitangaben über verschiedene Zeitzonen hinweg. 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. Sie können das UTC-Format in die Programmiersprache Ihrer Wahl in die lokale Zeit umwandeln. Zum Beispiel in JavaScript:

const convertToLocalTime = (isoString) => {
  // Create a new Date object from the ISO string
  const date = new Date(isoString);

  // Extract local time components
  const localDate = date.toLocaleDateString();
  const localTime = date.toLocaleTimeString();

  // Combine the local date and time
  const localDateTime = `${localDate} ${localTime}`;

  return localDateTime;
};

Postman

Sie können Postman verwenden, um Ihre REST-API-Aufrufe zu testen.

Postman

Erfahren Sie, wie Sie Postman mit unserer API verwenden

Zufällige Beiträge, Bilder und Videos

Sehen Sie sich den Schnellstart-Leitfaden an, um zu erfahren, wie Sie zufällige Beiträge, Bilder oder Videos zum Testen senden.

Pakete

Wir haben sowohl Node.js- und Python-Pakete als auch Bubble.io-, Airtable- und Make-Leitfäden verfügbar, um die REST-Aufrufe zu erleichtern.

Node NPM-Paket

Integrieren mit unserem NodeJS-Paket

Python PyPI-Paket

Integrieren mit unserem Python-Paket

Airtable-Leitfaden

Erfahren Sie, wie Sie Ayrshare mit Airtable nutzen

Bubble-Plugin und Leitfaden

Erfahren Sie, wie Sie Ayrshare mit Bubble.io nutzen

Make-Leitfaden

Erfahren Sie, wie Sie Ayrshare mit Make nutzen

Notion-Leitfaden

Erfahren Sie, wie Sie Ayrshare mit Notion nutzen

FlutterFlow-Leitfaden

Erfahren Sie, wie Sie Ayrshare mit FlutterFlow nutzen

Retool-Leitfaden

Erfahren Sie, wie Sie Ayrshare mit Retool nutzen

​Kernfunktionen

​Business-Plan und Launch-Plan

​Ads API

Ads API

​Messages API

Messages API

​Max Pack

Max Pack

​So verwenden Sie die Social API

​Social-API-Demo

Social-API-Demo

​Base-URL

​Autorisierung

​API-Key-Format

​Profile-Key-Format

​X/Twitter-BYO-Anmeldedaten

​Content-Type

​Komprimierung

​ID-Typen

​Ayrshare-Post-ID

​Social-Post-ID

​Ayrshare-Comment-ID

​Social-Comment-ID

​Fehlercodes

HTTP-Statuscodes

Ayrshare-Fehlercodes

​Zeitstempel-Format

​Postman

Postman

​Zufällige Beiträge, Bilder und Videos

​Pakete

Node NPM-Paket

Python PyPI-Paket

Airtable-Leitfaden

Bubble-Plugin und Leitfaden

Make-Leitfaden

Notion-Leitfaden

FlutterFlow-Leitfaden

Retool-Leitfaden

Kernfunktionen

Business-Plan und Launch-Plan

Ads API

Messages API

Max Pack

So verwenden Sie die Social API

Social-API-Demo

Base-URL

Autorisierung

API-Key-Format

Profile-Key-Format

X/Twitter-BYO-Anmeldedaten

Content-Type

Komprimierung

ID-Typen

Ayrshare-Post-ID

Social-Post-ID

Ayrshare-Comment-ID

Social-Comment-ID

Fehlercodes

Zeitstempel-Format

Postman

Zufällige Beiträge, Bilder und Videos

Pakete