Übersicht der Comments-API - Ayrshare API Documentation

Mit den Comments-Endpunkten können Ihre Nutzer Kommentare zu ihren Beiträgen posten, beantworten, abrufen und löschen. Es gibt vier Typen von Kommentar-IDs: Ayrshare Post ID, Social Post ID, Ayrshare Comment ID und Social Comment ID. Jede dieser IDs wird für unterschiedliche Zwecke verwendet.

Kommentar-ID-Typen

Kommentare mit Ayrshare Post ID

Der typische Ablauf: Wenn Sie einen Beitrag über Ayrshare veröffentlichen, erhalten Sie die Ayrshare Post ID. Sie können diese Ayrshare Post ID anschließend verwenden, um Kommentare zu diesem Beitrag zu verwalten. Unterstützte Plattformen: Bluesky, Facebook Pages, Instagram, LinkedIn, Reddit, Threads, TikTok, Twitter und YouTube. Beispiel:

Einen Beitrag veröffentlichen

Verwenden Sie den Endpunkt /post, um über Ayrshare einen Beitrag zu veröffentlichen. Dieser kann in einem einzigen Aufruf an mehrere soziale Netzwerke gesendet werden.In der Antwort finden Sie die Ayrshare Post ID auf oberster Ebene.

{
    "status": "success",
    "errors": [],
    "postIds": [
    {
        "status": "success",
        "id": "106638148652329_591370753547555",
        "postUrl": "https://www.facebook.com/106638148652329/posts/591370753547555",
        "platform": "facebook"
    }
    ],
    "id": "E4UdUr1yRbvI7qqCSlaq", // Ayrshare Post ID
    "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc055",
    "post": "What an amazing day",
    "validate": true
}

Einen Kommentar posten

Verwenden Sie den Endpunkt /comments, um mit der Ayrshare Post ID einen Kommentar zu posten. Der Kommentar wird automatisch in jedem sozialen Netzwerk gepostet, in dem der ursprüngliche Beitrag veröffentlicht wurde. Wenn Sie den Beitrag beispielsweise auf Facebook und Instagram veröffentlicht haben, erscheint der Kommentar auf beiden Plattformen.

POST https://api.ayrshare.com/api/comments/:id

Kommentare abrufen

Verwenden Sie den Endpunkt /comments, um die Kommentare zum Beitrag anhand der Ayrshare Post ID abzurufen. So erhalten Sie alle Kommentare aus jedem sozialen Netzwerk, in dem der Beitrag veröffentlicht wurde. Wenn Sie beispielsweise auf Facebook und Instagram gepostet haben, erhalten Sie Kommentare von beiden Plattformen.

GET https://api.ayrshare.com/api/comments/:id

Manchmal möchten Sie Kommentare zu einem Beitrag verwalten, der nicht über Ayrshare veröffentlicht wurde. In diesem Fall können Sie die Social Post ID verwenden, also die vom sozialen Netzwerk vergebene Beitrags-ID.

Wenn der Beitrag über Ayrshare veröffentlicht wurde, verwenden Sie die Ayrshare Post ID.

Beispiel:

Post-Historie abrufen

Rufen Sie zunächst über den Get All Post History Endpunkt die Instagram-Beiträge ab, die außerhalb von Ayrshare veröffentlicht wurden.Der Endpunkt gibt eine Liste von Beiträgen mit der sozialen id des Beitrags zurück.

{
    "status": "success",
    "posts": [
        {
            "mediaUrl": "https://scontent.cdninstagram.com/v/t51.2885-15/7531.jpg",
            "permalink": "https://www.instagram.com/p/B5OBT3ygpfg/",
            "commentsCount": 0,
            "created": "2022-05-20T17:26:03Z",
            "likeCount": 0,
            "mediaProductType": "FEED",
            "mediaType": "IMAGE",
            "username": "thegoodone",
            "id": "17833140557332933", // Instagram Social Post ID
            "thumbnailUrl": "https://scontent-lga3-2.cdninstagram.com/v/t51..jpg",
            "post": "The #Mandalorian is on tonight instead of Friday",
            "postUrl": "https://www.instagram.com/p/B5OBT3ygpfg/"
        },
    ]
}

Die soziale Post-id wird außerdem im Feld postIds des Post-Endpunkts zurückgegeben.

Kommentare zu einem Beitrag abrufen

Verwenden Sie die zurückgegebene id, um alle Kommentare zu einem bestimmten Instagram-Beitrag abzurufen: soziale id, searchPlatformId auf true und platform auf instagram gesetzt.

GET https://api.ayrshare.com/api/comments/17833140557332933?platform=instagram&searchPlatformId=true

Kommentar-ID zum Abrufen der Kommentar-Details verwenden

Das im vorherigen Schritt zurückgegebene JSON enthält für jeden Kommentar eine commentId, das ist die Social Comment ID.

{
    "instagram": [
        {
            "comment": "What an amazing comment",
            "commentId": "17969247335804735", // Social Comment ID
            "created": "2024-11-26T11:49:00Z",
            "from": {
            "id": "103038435208332",
            "username": "john_smith"
            },
            "hidden": false,
            "likeCount": 3,
            "platform": "instagram",
            "postId": "18231730279304333",
            "username": "john_smith"
        }
    ]
}

Kommentare mit Ayrshare Comment ID

Verwalten Sie Kommentare zu einem Beitrag, der über Ayrshare veröffentlicht wurde, mit der Ayrshare Comment ID. Die Ayrshare Comment ID ist die von Ayrshare vergebene Kommentar-ID und ist im Feld commentId der Antwort beim Posten eines Kommentars zu finden. Dies wird häufig verwendet, wenn Sie Details zu einem bestimmten über Ayrshare veröffentlichten Kommentar abrufen möchten. Verwalten Sie Kommentare zu einem Beitrag, der nicht über Ayrshare veröffentlicht wurde, mit der Social Comment ID. Die Social Comment ID ist die Kommentar-ID des sozialen Netzwerks (nicht die Ayrshare-ID) und ist im Feld commentId der Antwort beim Abrufen von Kommentaren zu finden.

GET https://api.ayrshare.com/api/comments/17969247335804735?platform=instagram&searchPlatformId=true&commentId=true

Dies wird häufig verwendet, wenn Sie Details zu einem bestimmten außerhalb von Ayrshare veröffentlichten Kommentar abrufen möchten, etwa LinkedIn-Antworten auf Kommentare.

Kommentare deaktivieren

Sie können Kommentare beim Veröffentlichen eines Beitrags mit dem Feld disableComments im /post-Endpunkt deaktivieren. Kommentare werden nur für Instagram, LinkedIn und TikTok deaktiviert. Sie können Kommentare auch für einen bereits veröffentlichten Beitrag über den Endpunkt Update Post und das Feld disableComments aktivieren oder deaktivieren.

Plattform-Einschränkungen

TikTok – DELETE /comments nur für eigene Kommentare. DELETE /comments funktioniert bei TikTok nur für Kommentare, die vom authentifizierten TikTok-Konto selbst verfasst wurden (Ihre eigenen Antworten). Der Versuch, einen Kommentar eines anderen Nutzers zu löschen, liefert Ayrshare code: 328. Für die Moderation von Drittkommentaren auf Ihren eigenen TikTok-Videos kontaktieren Sie den Support, damit wir bestätigen können, was für Ihren verknüpften Kontotyp verfügbar ist.

​Kommentar-ID-Typen

​Kommentare mit Ayrshare Post ID

​Kommentare mit Social Post ID

​Kommentare mit Ayrshare Comment ID

​Kommentare mit Social Comment ID

​Kommentare deaktivieren

​Plattform-Einschränkungen

Kommentar-ID-Typen

Kommentare mit Ayrshare Post ID

Kommentare mit Social Post ID

Kommentare mit Ayrshare Comment ID

Kommentare mit Social Comment ID

Kommentare deaktivieren

Plattform-Einschränkungen