Bild Carousel V2

docs/automations/social-accounts-and-jobs.md

@@ -55,6 +55,14 @@
 - GreenLens should also remain **upload-only by default** unless Timo explicitly asks for a different behavior.
 - Do not treat a generic approval like "Go" as permission for automatic/direct TikTok publishing.
 
+## TikTok Analytics (Display API, read-only)
+- Both apps request the scopes `user.info.basic,user.info.stats,video.list,video.upload,video.publish`.
+- Admin-key-protected live analytics endpoints (no data is stored, every call reads fresh from TikTok):
+  - QRMaster: `GET /api/tiktok/analytics?key=<TIKTOK_ADMIN_KEY>&max_videos=50`
+  - GreenLens: `GET /api/tiktok/analytics` (guarded by the plant import admin key)
+- Response: account stats (followers, total likes, video count) plus per-video views/likes/comments/shares with computed `engagement_rate`, `posted_weekday_utc` and `posted_hour_utc`, and a summary block (totals, average/median views).
+- The new scopes must be enabled for the app in the TikTok Developer Portal, and accounts connected before the scope change must re-authorize via `/api/tiktok/connect` — otherwise TikTok returns a scope error.
+
 ## Refresh Behavior
 - Meta user/page tokens werden automatisch refreshed durch `python C:\Users\timo\Documents\meta_token_refresh.py`.
 - QRMaster Page-Auswahl erzwingt Page-ID `884792004727212`.