TikTok Data Skill

Der deterministische Lesepfad für öffentliche TikTok-Daten über UnifAPI. Dies ist ein Data Skill: Er führt für sich genommen keine Marketingaufgabe aus — er benennt die konkreten tiktok/...-Operationen, Response-Shapes und Stolperfallen, sodass jeder creator- oder trendorientierte Workflow (Shortlisting, Audience-Fit, Demand-Radar, Local Buzz) aus einem bekannten Rezept liest, statt die Oberfläche jedes Mal neu zu entdecken.

Schreibgeschützt — Augen, keine Hände. Er recherchiert öffentliche TikTok-Daten und liefert belegte Records zurück; er postet, kommentiert oder folgt nie, und UnifAPI hält nie TikTok-Zugangsdaten.

Nutzen Sie den unifapi-Skill für Live-Belege

Verbinden Sie sich einmal über den gemeinsamen unifapi-Skill (OAuth MCP), und rufen Sie dann die untenstehenden Operationen auf. TikTok-Nutzer und -Videos sind durch eine numerische id geschlüsselt — lösen Sie ein @handle oder eine Video-URL zuerst zu ihrer id auf (siehe Gotchas). Behalten Sie alle billing- Metadaten, damit der Output die Record-Kosten ausweisen kann.

Response-Vertrag

Single-Entity-Endpunkte geben das Objekt in data zurück:

{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

List-Endpunkte geben ein Array in data plus pagination zurück:

{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

Wenn pagination.has_more true ist, übergeben Sie pagination.next_cursor als cursor der nächsten Anfrage (limit setzt die Seitengröße). Bewahren Sie billing immer auf.

Kernoperationen

Brauchen Sie ein hier nicht aufgeführtes Feld? Nutzen Sie das get_operation des unifapi-Skills, um das exakte Schema vor dem Aufruf zu lesen — aber wählen Sie die Operation aus dieser Tabelle, entdecken Sie nicht blind.

Workflow

Die deterministischen Rezepte. Wählen Sie das, das zur Aufgabe passt; jedes benennt genau, was aufzurufen ist.

1. Nach Thema entdecken. Rufen Sie tiktok/search/videos?q=..., tiktok/search/users?q=... oder tiktok/search/hashtags?q=... für die Nische auf; nutzen Sie tiktok/search?q=... für ein gemischtes Ergebnis.
2. Einen Creator auflösen. Rufen Sie tiktok/users/resolve?username=... auf, um die numerische id zu erhalten, dann tiktok/users/{id} für follower_count, like_count und video_count.
3. Engagement lesen. Rufen Sie tiktok/users/{id}/videos auf; jedes Video trägt view_count, like_count, comment_count und share_count — berechnen Sie das Engagement pro Video. Paginieren Sie über next_cursor.
4. Ein Video und seine Reaktion lesen. Rufen Sie tiktok/videos/{id} auf (lösen Sie eine URL zuerst mit tiktok/videos/resolve?url=... auf), dann tiktok/videos/{id}/comments für das Sentiment.
5. Trends verfolgen. Rufen Sie tiktok/hashtags/{id} für video_count/view_count und tiktok/hashtags/{id}/videos (oder tiktok/music/{id}/videos) für das auf, was sich auf einem Tag oder Sound verbreitet.
6. Ein Netzwerk abbilden. Rufen Sie tiktok/users/{id}/followers, .../following oder .../likes für Reichweiten- und Affinitätsarbeit auf.
7. Alles belegen. Jede Zahl bindet zurück an das Video oder Profil, aus dem sie stammt; berichten Sie billing.records_charged (oder schätzen Sie, wenn Billing-Metadaten fehlen).

Shape-Notizen

• User — username, display_name, follower_count, following_count, like_count, video_count, is_verified, is_private, region.
• Video — video_description, view_count, like_count, comment_count, share_count, duration, author, music, hashtags, create_time.
• Hashtag — name, video_count, view_count, is_commerce.
• Music — title, author, is_original.

Gotchas

• TikTok-Nutzer und -Videos sind durch eine numerische id geschlüsselt. Lösen Sie ein @handle mit tiktok/users/resolve?username=... und eine Video-URL mit tiktok/videos/resolve?url=... vor jedem tiktok/users/{id}/...- oder tiktok/videos/{id}/...-Aufruf auf.
• tiktok/videos/batch ist ein POST (ids im Body), kein GET — nutzen Sie es, um viele Video-ids auf einmal zu hydrieren.
• Ein privater Creator (is_private) begrenzt, was Sie lesen können — weisen Sie darauf hin.
• Ein niedriger Kontostand kann List-Seiten stillschweigend abschneiden: prüfen Sie billing.truncated_due_to_balance — wenn true, ist die Seite unvollständig, also laden Sie auf, bevor Sie einer Zählung vertrauen.

Output

Geben Sie die Records zurück, die der aufrufende Workflow benötigt, jeden belegt auf sein Video oder Profil, plus eine einzeilige Kostennotiz (records_charged). Wenn dieser Skill direkt verwendet wird, ist eine kompakte Creator-Zusammenfassung der Standard:

**@handle** — {followers} followers, {videos} videos. Recent videos: avg {views} views / {likes} likes / {comments} comments. Rising tags: {#hashtags}. Evidence: {video URLs}. Records: ~{N}.

Verwandte Skills

• creator-shortlist, audience-fit-check (Influencer Marketing) — TikTok-Creator auf Basis dieses Lesepfads shortlisten und prüfen.
• social-listening-brief (Social Listening), treatment-demand-radar, menu-demand-radar, restaurant-local-buzz (Verticals) — Trend- und Nachfragearbeit, die TikTok zuerst liest.
• unifapi — der gemeinsame Daten-Skill: MCP verbinden und exakte Schemas mit get_operation nachschlagen.