API Tutorial

So rufst du Threads-Analysen per API ab

Um Threads-Analysen per API zu erhalten, verbinde Threads über Modiva und rufe dann `analytics_unified` auf — es gibt Reichweite, Impressionen, Engagement und Follower-Metriken in einer normalisierten Form zurück, die du visualisieren oder auswerten kannst.

Jede Plattform meldet Metriken anders, daher bedeutet plattformübergreifendes Reporting meist eine Mapping-Schicht pro Netzwerk. Modivas `analytics_unified`-Tool gibt Threads-Metriken im selben Schema zurück wie jede andere Plattform, sodass eine Abfrage ein ganzes Dashboard antreibt.

Schritt für Schritt

Modiva-Konto und MCP-Schlüssel erstellen

Registriere dich kostenlos und generiere im Dashboard einen MCP-Schlüssel (`mk_live_…`). Derselbe Schlüssel authentifiziert sowohl den gehosteten MCP-Server (für KI-Agenten) als auch die REST-API (für dein Backend), sodass du nur eine Zugangsberechtigung verwaltest.

Dein Threads-Konto verbinden

Klicke im Dashboard auf Verbinden und wähle Threads. Modiva führt den OAuth-Flow aus und fordert die passenden Scopes für dich an, speichert die Access- + Refresh-Tokens dann in einem verschlüsselten Tresor und hält sie aktuell — du hantierst nie mit den rohen API-Zugangsdaten von Threads. Die Verbindung erhält eine stabile `connectionId`, auf die du in jedem Aufruf verweist.

analytics_unified für Threads-Metriken aufrufen

Rufe `analytics_unified` mit der Connection-ID, den gewünschten Metriken und einem Zeitraum auf. Modiva holt sie von Threads, normalisiert die Feldnamen und gibt eine konsistente JSON-Form zurück, bereit zum Visualisieren.

Jede Plattform in einen Bericht zusammenfassen

Übergib mehrere Connection-IDs, um Threads mit dem Rest deines Stacks in einer einzigen Antwort zu kombinieren. Über MCP kann ein Agent die Zahlen abrufen und den Wochenbericht für dich schreiben und dann `analytics_best_time_to_post` aufrufen, um den nächsten zu planen.

Beispielanfrage

Rufe das Tool analytics_unified über die REST-API von Modiva auf. Dasselbe Tool steht KI-Agenten über den MCP-Server unter https://mcp.modiva.ai/v1 zur Verfügung.

POST /v1/tools/invoke

curl -X POST https://api.modiva.ai/v1/tools/invoke \
  -H "Authorization: Bearer mk_live_…" \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "analytics_unified",
    "connectionId": "conn_…",
    "args": { "metrics": ["reach", "engagement"], "period": "last_30_days" }
  }'

Mit Threads ausprobieren

Kostenlos starten

FAQ

Sind Threads-Metriken mit anderen Plattformen vergleichbar?

Ja — Modiva normalisiert Threads-Analysen in ein gemeinsames Schema, sodass Reichweite und Engagement über jedes verbundene Netzwerk hinweg zusammenpassen.

Kann ein KI-Agent den Bericht erstellen?

Ja. Stelle `analytics_unified` über MCP bereit, und ein Agent kann die Threads-Zahlen abrufen und die Zusammenfassung eigenständig verfassen.

Weiterbauen mit Threads

Threads API-Integration Threads MCP-Server So postest du auf Threads per API So planst du Threads-Beiträge per API So liest und beantwortest du Threads-Kommentare per API So rufst du Instagram-Analysen per API ab So rufst du TikTok-Analysen per API ab