Grundlegender Leitfaden zur API-Integration

Aktualisiert vor 6 Tagen

Die Metricool API verbindet deine eigenen Tools und Skripte mit Metricool, sodass du Daten exportieren sowie Beiträge außerhalb der App erstellen, planen und verwalten kannst. Dieser Leitfaden führt dich vom Zugriff bis zu deinem ersten API-Aufruf.

Bevor du beginnst

Die API ist in den Tarifen Advanced und Custom verfügbar. Die Tarife Free und Starter beinhalten keinen API-Zugriff.

Gehe zu Kontoeinstellungen > API.
Kopiere dein API-Zugriffstoken.
Öffne die offizielle API-Dokumentation über das ℹ️-Infosymbol neben dem Token-Feld oder direkt unter https://app.metricool.com/resources/apidocs/index.html. Außerdem ist ein herunterladbarer PDF-Leitfaden verfügbar: API English PDF.

Jeden Aufruf authentifizieren

Alle Endpunkte erfordern eine Authentifizierung mit drei Werten: dein Token im Header X-Mc-Auth sowie userId und blogId als Anfrageparameter. Anfragen mit einem Body verwenden außerdem Content-Type: application/json.

X-Mc-Auth: YOUR_API_TOKEN
Content-Type: application/json

userId identifiziert dein Metricool-Konto und blogId die marke. Beide Werte kannst du aus der Browser-URL ablesen, wenn du eine marke in der App öffnest:

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

Um jede marke aufzulisten, die du verwaltest oder die mit dir geteilt wurde, rufe https://app.metricool.com/api/admin/simpleProfiles?userId=YOUR_USER_ID auf. Jeder Eintrag enthält die zugehörige blogId. Eine ausführliche Anleitung zur Konto-ID findest du unter So findest du deine Metricool-Benutzer-ID.

Beitrag erstellen und planen

Sende eine POST-Anfrage an den Scheduler-Endpunkt mit dem Veröffentlichungsdatum, dem Beitragstext und mindestens einem Netzwerk:

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

Der Anfrage-Body erfordert:

publicationDate: Das Datum muss in der Zukunft liegen und im ISO-8601-Format mit einer Zeitzone angegeben werden, zum Beispiel Europe/Madrid.
text: der Inhalt des Beitrags.
providers: mindestens ein Netzwerk, zum Beispiel { "network": "facebook" }.

Beispiel für den Anfrage-Body:

{
  "publicationDate": {
    "dateTime": "2025-07-23T10:00:00",
    "timezone": "Europe/Madrid"
  },
  "text": "Hello! This is a scheduled post test.",
  "providers": [
    { "network": "facebook" }
  ]
}

Zu den optionalen Einstellungen gehören draft (auf true setzen, um den Beitrag als Entwurf zu speichern, anstatt ihn zu planen), autoPublish, firstCommentText sowie netzwerkspezifische Blöcke wie facebookData, instagramData, twitterData, linkedinData, pinterestData, youtubeData, tiktokData, gmbData, threadsData und blueskyData für Optionen pro Netzwerk, etwa den Facebook-Beitragstyp oder die automatische Veröffentlichung auf Instagram. Die vollständige Parameterreferenz findest du in den .yaml- und .json-Swagger-Dateien, die in der API-Dokumentation verlinkt sind.

Was du mit geplanten Beiträgen tun kannst

Die Scheduler-Endpunkte unterstützen die folgenden Aktionen. Alle Pfade sind relativ zur Basis-URL https://app.metricool.com/api.

Aktion	Methode und Pfad
Geplanten Beitrag erstellen	`POST /v2/scheduler/posts`
Geplante Beiträge zwischen zwei Daten auflisten	`GET /v2/scheduler/posts`
Geplanten Beitrag nach ID abrufen	`GET /v2/scheduler/posts/{id}`
Geplanten Beitrag aktualisieren	`PUT /v2/scheduler/posts/{id}`
Ausgewählte Felder bearbeiten und aktualisieren	`PATCH /v2/scheduler/posts/{id}`
Geplanten Beitrag löschen	`DELETE /v2/scheduler/posts/{id}`
Mehrere Beiträge einer marke gesammelt zur Überprüfung senden	`PUT /v2/scheduler/posts`
Geplanten Beitrag genehmigen oder ablehnen	`PUT /v2/scheduler/posts/{id}/approvals`
Die markenkonfiguration zum Senden eines Beitrags zur Überprüfung abrufen	`GET /v2/scheduler/posts/approvals-config`
Die Instagram-Beitragseigenschaften einer marke abrufen	`GET /v2/scheduler/posts/instagram-properties`

Medien zu einem geplanten Beitrag hinzufügen

Medien-Links müssen öffentlich sein und dürfen nicht ablaufen: Private oder temporäre URLs werden übersprungen, und der Beitrag wird ohne Medien geplant. Um Medien anzuhängen, musst du sie vorbereiten, bevor du den Scheduler-Endpunkt aufrufst:

Medien-URL normalisieren mit einer GET-Anfrage, damit die Datei bei Bedarf auf Metricool-Servern gehostet wird:
https://app.metricool.com/api/actions/normalize/image/url?url=<URL_OF_YOUR_MEDIA>
Im Beitrag auf die Medien verweisen über die zugehörige mediaId:
"media": { "mediaId": "ID_OF_MEDIA" }

Ohne die Medien-ID in der Anfrage wird der Beitrag ohne Medien geplant. Ein vollständiges Beispiel findest du unter Häufige Fragen und Fehler bei der Verwendung der API.

Einschränkungen bei der Veröffentlichung

Jedes soziale Netzwerk schränkt über seine eigene API ein, was Drittanbieter-Tools veröffentlichen können. Daher ist nicht jede Planer-Funktion über die Metricool API verfügbar. Eine nach Netzwerk aufgeschlüsselte Liste nicht unterstützter Aktionen für Veröffentlichung, Inbox und Reporting findest du unter API-Einschränkungen pro sozialem Netzwerk.

Die netzwerkspezifischen Felder im Anfrage-Body unterscheiden sich ebenfalls je nach Netzwerk. Prüfe in der API-Dokumentation die .yaml- und .json-Swagger-Dateien auf die für jedes Netzwerk verfügbaren Felder, bevor du die Anfrage erstellst.

API-Implementierung

Um Daten aus Metricool zu exportieren und über unsere API an andere Plattformen wie Excel, Google Sheets, MySQL und weitere zu übertragen, befolge diese allgemeinen Schritte:

Zugriffstoken abrufen unter Kontoeinstellungen > API, wie oben beschrieben.
HTTP-Client einrichten: Verwende ein Integrationstool wie Postman oder eine Programmiersprache (zum Beispiel Python mit requests) und konfiguriere den Header X-Mc-Auth mit deinem Token.
GET-Anfrage senden an den Endpunkt für die gewünschten Daten (Beiträge, Kennzahlen, Berichte). Alle Aufrufe erfordern userId und blogId. Verwende die Browser-Inspektion, um die von Metricool ausgeführten Aufrufe und ihre Parameter anzuzeigen, wie unter So erhältst du einen Endpunkt in Metricool für API-Aufrufe beschrieben.
Daten formatieren: Antworten liegen normalerweise als JSON vor. Ordne die Felder daher der Struktur zu, die deine Zielplattform erwartet.
Daten auf die Zielplattform exportieren.

Jede Zielplattform hat ihre eigene Integrationsmethode, aber der allgemeine Ablauf folgt diesem Schema.

Dokumentation

Hier findest du Links zur Dokumentation der APIs der am häufigsten verwendeten Plattformen für die Datenverwaltung:

Nutzung überwachen und Token erneuern

Unter Kontoeinstellungen > API siehst du deine aktuelle API-Nutzung und den Verlauf der verwendeten Endpunkte. Nutzungsstatistiken kannst du auch über die API mit GET /v2/settings/users/{userId}/api-usage-stats abrufen. Der Endpunkt verwendet die Parameter from, to und aggregation und gibt die pro Endpunkt ausgeführten Aufrufe zurück.

Wenn du dein Token ersetzen musst, kannst du es unter Kontoeinstellungen > API neu generieren. Durch die Neugenerierung wird das vorherige Token sofort ungültig, und jede Integration, die es verwendet, funktioniert nicht mehr, bis du es aktualisierst. Siehe API-Verbindungstoken neu generieren.

Ähnliche Artikel

War das hilfreich?