Inhalte mithilfe der API zu einer Autoliste hinzufügen

Aktualisiert vor 4 Wochen

Du kannst über die API Inhalte zu einer bestehenden Autoliste hinzufügen. Dazu sind zwei Aufrufe erforderlich: Erstelle zuerst einen leeren Platz in der Liste und fülle ihn anschließend mit dem Text und den Medien deines Beitrags. Das funktioniert mit jedem HTTP-Client, einschließlich Postman, Make, n8n oder Zapier.

Voraussetzungen

Für beide Aufrufe benötigst du dein userToken, deine userId, deine blogId und die interne ID der Autoliste.

Wert	Wo du ihn findest
`userToken`	Kontoeinstellungen > Bereich API > REST-API-Zugriffstoken. Sende es im Anfrage-Header `X-Mc-Auth`.
`userId`	Deine Metricool-Benutzer-ID. Siehe So findest du deine Metricool-Butzer-ID.
`blogId`	Die Kennung der marke/des Profils, die in der Browser-URL sichtbar ist, wenn du diese marke in Metricool verwendest.
`listid`	Die interne ID der Autoliste. Sie stimmt nicht immer mit der ID in der Planer-URL (`/planner/autolist/{X}`) überein. Bestätige sie anhand der Antwort des Aufrufs aus Schritt 1, statt sie einfach vorauszusetzen.

Inhalte zur Autoliste hinzufügen

Einen leeren Platz erstellen

Durch das Erstellen eines Platzes wird eine Position in der Autoliste reserviert. Die Antwort enthält das vollständige Autolisten-Array einschließlich der id des neuen Elements. Diesen Wert verwendest du im nächsten Schritt als postid.

GET https://app.metricool.com/api/lists/posts/create?listid={listId}&position={position}&userId={userId}&blogId={blogId}

Feld	Beschreibung
`listid`	Die interne ID der Autoliste.
`position`	Gibt an, an welcher Stelle der neue Beitrag eingefügt werden soll. Mit `0` wird er an den Anfang der Liste eingefügt.

Jeder Aufruf dieses Endpunkts fügt der Autoliste eine neue leere Zeile hinzu, selbst wenn du den nächsten Schritt nicht abschließt. Durch wiederholte Aufrufe sammeln sich leere Zeilen an. Entferne sie mit „Alle löschen“ im Metricool-Planer aus der Autoliste.

Den Platz mit Inhalten füllen

Sende diesen Aufruf als form-data, nicht als JSON.

POST https://app.metricool.com/api/lists/posts/updatepostlist?userId={userId}&blogId={blogId}

Feld	Wert
`listid`	Die interne ID der Autoliste.
`text`	Der Textinhalt des Beitrags.
`postid`	Die im vorherigen Schritt zurückgegebene `id`.
`pictures`	Bild- oder Videodatei für den Beitrag. Wenn kein Bild vorhanden ist, sende `[]`. Ein leerer Wert speichert zwar den Text, der restliche Teil der Anfrage schlägt jedoch stillschweigend fehl.

Fehlerbehebung

500 InternalError: "Request method 'POST' is not supported"

Du hast /api/lists/posts/create mit POST aufgerufen. Dieser Endpunkt akzeptiert nur GET. Ändere die Anfragemethode zu GET und behalte dieselben Abfrageparameter bei.

Die Anfrage ist erfolgreich, aber der Beitrag sieht nicht richtig aus

Wenn pictures leer statt als [] gesendet wurde, ist der Aufruf erfolgreich und speichert den text, aber der restliche Aktualisierungsvorgang schlägt stillschweigend fehl. Sende die Anfrage erneut und setze pictures auf [], wenn kein Bild vorhanden ist.

Weiterführende Informationen: So erhältst du einen Endpunkt in Metricool, um API-Aufrufe durchzuführen und Häufige Fragen und Fehler bei der Verwendung der API.

War das hilfreich?