Dieser Artikel ist auch verfügbar in:

Häufige Fragen und typische Fehler bei der Nutzung der API

Häufige Fragen zur Nutzung der API mit externen Tools

Du nutzt Tools wie n8n, Make, Zapier oder Postman, um Beiträge zu planen oder Prozesse mit der Metricool-API zu automatisieren? Hier findest du Antworten auf häufig gestellte Fragen und typische Fehler.

❓ Häufig gestellte Fragen

Wo muss ich den Authentifizierungstoken einfügen?

In allen Fällen muss dein Metricool-Token im Header wie folgt eingefügt werden:

X-Mc-Auth: DEIN API-TOKEN

Außerdem ist dieser Header Pflicht:

Content-Type: application/json

⚠️ Stelle sicher, dass deine Anfrage immer die Parameter blogId und userId enthält.

📋 Übersicht nach Tool

Tool	Wo wird der Token (`X-Mc-Auth`) eingefügt?	`Content-Type` erforderlich?	Nützliche Hinweise
n8n	In den Zugangsdaten: Header Auth	✅ `application/json`	Nutze „Generic Credential Type“ + „Header Auth“. Wiederverwendbar.
Make	Im HTTP-Modul: Bereich Headers	✅ `application/json`	Verwende benutzerdefinierte oder offizielle Module.
Zapier	In „Webhooks by Zapier“: Bereich Headers	✅ `application/json`	Im erweiterten Webhook-Bereich hinzufügen.
Postman	Im Tab Headers der Anfrage	✅ `application/json`	Ideal zum Testen von Anfragen.

Wie bekomme ich meine `blogId`?

Du hast zwei Möglichkeiten:

Über die URL von Metricool

Wenn du eine Marke in deinem Konto öffnest, siehst du eine URL wie diese.

Kopiere die Zahl, die nach blogId steht – sie identifiziert deine Marke.

(Die Zahl nach userId identifiziert dein Konto.)

https://app.metricool.com/evolution/web?blogId=00000&userId=0000000

Über die API:

Sende eine Anfrage an diesen Endpoint. Du bekommst eine Liste aller Marken, die du verwaltest oder mit dir geteilt wurden – inklusive ihrer blogId:

https://app.metricool.com/api/admin/simpleProfiles?userId=DEINE_USER_ID

Welches Format muss `publicationDate` haben?

Verwende das ISO-8601-Format inklusive Zeitzone. Beispiel:

"publicationDate": {
"dateTime": "2025-07-23T10:00:00",
"timezone": "Europe/Berlin"
}

Kann ich Bilder oder Videos per API hochladen?

Ja. Lade die Datei zuerst über den entsprechenden Endpoint hoch, erhalte die mediaId und verweise dann darauf im Posting-Body.

Achte darauf, dass die Links öffentlich und dauerhaft gültig sind.

Wir empfehlen, die URL vorher über den normalize-Endpoint zu prüfen, um sicherzustellen, dass die Datei auf unseren Servern gehostet wird.

Kann ich auch andere Tools verwenden?

Ja. Jedes Tool, das HTTP-Requests mit benutzerdefinierten Headern erlaubt, kann mit der API von Metricool verwendet werden.

💡 Tipp: Nutze dynamische Endpoints, um deine API-Anfragen zu erstellen. Sieh dir hier die technische Dokumentation und Anleitung an.

⚠️ Häufige Fehler (und wie du sie behebst)

Zugriff verweigert (oder ähnliche Fehlermeldung)

Das bedeutet, dass dein Token nicht korrekt gesendet wurde oder keine Berechtigung für die Marke hat.

✅ Lösung:

Stelle sicher, dass du den korrekten Token aus deinem Metricool-Konto verwendest.
Überprüfe, dass der Header richtig gesetzt ist.
Kontrolliere, ob blogId und userId zu deinem Konto gehören.

🔎 n8n-Beispiel:

Der Beitrag wurde geplant, enthält aber kein Bild/Video

Das passiert, wenn die Mediendatei nicht korrekt vorbereitet wurde.