Öffentliche TikTok-, Instagram- und YouTube-Daten in Creator-Research- und Listening-Skills nutzen – zuerst per MCP, per HTTP für die Produktion.

Kurz gesagt: Dieses Cookbook richtet sich an Leser in der Umsetzungsphase, die TikTok-, Instagram- und YouTube-Datensätze für Creator-Recherche oder Social Listening brauchen, ohne drei Integrationen zu bauen.

UnifAPI stellt öffentliche TikTok-, Instagram- und YouTube-Daten über eine gemeinsame MCP- und HTTP-Oberfläche bereit, bepreist mit $0.001-Credits. Dieser Leitfaden ordnet die gemeinsamen Primitive, Pagination und Kostenrechnung ein, damit ein Agent Creator-Recherche- und Social-Listening-Skills ohne eigene GUI ausführen kann.

Die meisten verbrauchernahen Workflows mit öffentlichen Daten — Brand Monitoring, Creator-Recherche, Produkt-Launch-Analyse, Trend-Erkennung — landen bei denselben drei Plattformen: TikTok für Kurzvideo, Instagram für visuelles Social, YouTube für Long-Form. Einen stabilen Feed aus allen dreien zu bauen, bedeutete historisch drei Anbieterverträge und drei verschiedene Envelopes. Mit UnifAPI ist es ein MCP-Server und eine Form über alle hinweg.

Welche Endpunkte Sie wirklich brauchen

Für die meisten Agent-Workflows genügen drei Primitive pro Plattform: Suche nach Keyword oder Hashtag, Abruf eines einzelnen Posts oder Videos per ID und Auflistung der jüngsten Posts eines Creators. Alles Weitere — Kommentare, verwandte Posts, Follower-Kontext — ist unterstützendes Detail, das der Agent ausfächern kann, sobald das Primärset vorliegt.

Bei UnifAPI bilden diese sich ab auf: TikTok — /tiktok/search, /tiktok/videos/{id}, /tiktok/users/{id}/videos. YouTube — /youtube/search, /youtube/videos/{video_id}, /youtube/channels/{channel_id}/videos. Instagram — /instagram/search, /instagram/posts/{shortcode}, /instagram/users/{username}/posts. Die Benennung richtet sich bewusst plattformübergreifend aus, sodass der Agent-Prompt, der eine gelernt hat, alle drei gelernt hat.

Die einheitliche Request-Form

Jeder HTTP-Endpunkt akzeptiert denselben Authorization: Bearer <key>-Header und gibt denselben äußeren Envelope zurück: { request_id, data, pagination?, billing }. Die Felder innerhalb von data sind plattformspezifisch (ein TikTok-Video hat eine Hashtag-Liste, ein YouTube-Video hat Channel-Metadaten), aber die Form drumherum ist konsistent.

Diese Einheitlichkeit zählt mehr, als es klingt. Sie bedeutet, dass die Tool-Use-Schleife Ihres Agents eine Retry-Policy, einen Pagination-Handler, einen Fehler-Envelope hat — nicht drei. Das plattformspezifische Wissen bleibt im data-Feld, wo das Modell es sehen kann.

Pagination über drei Plattformen

Jede Plattform paginiert anders — TikTok nutzt ein Cursor-Token, YouTube nutzt pageToken, Instagram nutzt end_cursor. UnifAPI normalisiert diese Signale auf ein einzelnes { cursor, has_more }-Objekt. Ihre Agent-Schleife liest den Cursor, gibt ihn beim nächsten Aufruf als cursor-Query-Parameter zurück und stoppt, wenn has_more auf false umspringt.

Die Standard-Seitengröße beträgt 20 Datensätze auf jeder Plattform. Das Maximum ist 50. Für die meisten Agent-Durchläufe genügt eine Seite — das Modell braucht selten mehr als die Top 20 Treffer, um eine Entscheidung zu treffen.

Kosten pro Agent-Durchlauf schätzen

Die Kosten sind Datensätze × $0.001. Ein „Überwache diese Woche TikTok-Erwähnungen unserer Marke"-Durchlauf, der 20 Suchergebnisse abruft und dann zum Abruf von 5 einzelnen Videos für Transkripte ausfächert, sind 25 Datensätze — $0.025. Ein „Creator-Recherche zu diesem Account"-Durchlauf, der 50 jüngste Posts und 10 Video-Details abruft, sind 60 Datensätze — $0.06.

Eine grobe Faustregel, die sich bewährt hat: Budgetieren Sie $0.05 pro Agent-Durchlauf für typische Recherche-Workflows, $0.20 für Deep Dives. Allein der einmalige Bonus von 2.000 Credits bei der ersten Aufladung deckt etwa vierzig leichte Durchläufe.

Alles zusammensetzen

Ein End-to-End-Agent „finde, was diese Woche über uns angesagt ist, über alle drei hinweg" sieht so aus: Parallel-Aufruf von /tiktok/search, /instagram/search, /youtube/search mit dem Marken-Keyword; die Top 10 von jeder einsammeln; für die Top 3 jeder Plattform zu /tiktok/videos/{id}, /instagram/posts/{shortcode} oder /youtube/videos/{video_id} für das vollständige Transkript oder die Caption ausfächern; das Ganze mit einem Zusammenfassungs-Prompt an das Modell übergeben.

Gesamtkosten: 30 Such-Datensätze + 9 Detailabrufe = 45 Credits, $0.045 — jeder der drei Instagram-Beitragsabrufe wird mit dem im OpenAPI-Vertrag veröffentlichten Minimum von 3 Credits pro Aufruf berechnet. Gesamtzahl der Integrationen: eine. Das ist der Pitch — beginnen Sie bei einem Skill, verbinden Sie den MCP-Server unter https://mcp.unifapi.com und melden Sie sich nur an, wenn OAuth für Tool-Aufrufe und Workspace-Credits benötigt wird.

Was Sie als Nächstes lesen sollten

Einen KOL-Pricing-Agent mit MCP betreiben – nutzt diese Plattformen als Creator-Pricing-Anreicherung.

Einheitlicher Response-Envelope – erklärt, wie Multi-Plattform-Antworten vergleichbar bleiben.

API-Katalog – listet die Live-Plattform-Operationen auf.