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

Wie bekomme ich meine blogId?

Du hast zwei Möglichkeiten:

1. Ü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

2. Ü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"
}

Wie finde ich den API-Endpoint, den ich brauche?

Einige Endpoints der Metricool-API sind nicht direkt im PDF gelistet, aber du kannst sie ganz einfach selbst finden, indem du diese Schritte befolgst.

So findest du einen Endpoint – Schritt für Schritt

1. Öffne den Bereich von Metricool, in dem die Daten angezeigt werden, die du per API abrufen möchtest (z. B. YouTube-Analytics, Instagram-Posts usw.).
2. Öffne die Entwicklertools deines Browsers:

• In den meisten Browsern: Rechtsklick → „Untersuchen“ → Tab Netzwerk oder Network.
• Lade die Seite ggf. neu.

3. Filtere nach fetch/XHR, um die Backend-Calls von Metricool zu sehen.
4. Suche nach dem Endpoint, der die angezeigten Daten enthält.

Zum Beispiel: Auf der YouTube-Analytics-Seite findest du etwas wie youtube/videosStats.

5. Du kannst diese URL kopieren und für deine API-Requests anpassen.

Dieser Prozess ist ab Seite 8 in der PDF-Dokumentation erklärt. Du kannst sie hier herunterladen: 👉 Metricool API Dokumentation (PDF)

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.

⚠️ 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.

✅ Lösung:

1. Sicherstellen, dass der Link öffentlich und dauerhaft gültig ist.
2. Prüfen, ob mediaId im Post-Body enthalten ist.
3. Vor dem Aufruf von https://app.metricool.com/api/v2/scheduler/posts die URL normalisieren:

https://app.metricool.com/api/actions/normalize/image/url?url=<URL_DEINER_DATEI>

4. Dann die zurückgegebene mediaId verwenden:

"media": {
"mediaId": "MEDIA_ID"
}

Aktualisiert am: 06/08/2025