Auto-sync: 2026-04-26 04:02

wiki/entities/Upload-Post.md

@@ -0,0 +1,44 @@
+---
+title: "Upload-Post API"
+type: entity
+tags: ["api", "tiktok", "instagram", "publishing", "analytics", "social-media"]
+sources: ["marketing-carousel-growth-engine"]
+last_updated: 2026-04-26
+---
+
+## Definition
+
+多平台内容发布与数据分析 API，支持同时发布到 TikTok 和 Instagram，并提供详细的后续数据分析。在 [[marketing-carousel-growth-engine]] 中用于轮播图的发布与效果追踪。
+
+## Key Details
+
+- **Base URL**: `https://api.upload-post.com`
+- **Website**: https://upload-post.com
+- **Docs**: https://docs.upload-post.com
+- **Free Plan**: 无需信用卡
+- **Credentials**: `UPLOADPOST_TOKEN` + `UPLOADPOST_USER`
+
+## API Endpoints
+
+### Publishing
+- `POST /api/upload_photos` — 发布 6 张 JPG 轮播图到 TikTok + Instagram
+  - 参数：`photos[]`（图片）、`platform[]=tiktok`、`platform[]=instagram`
+  - `auto_add_music=true`（TikTok 自动添加热门音乐）
+  - `privacy_level=PUBLIC_TO_EVERYONE`
+  - 返回 `request_id` 用于后续追踪
+
+### Analytics
+- `GET /api/analytics/{user}?platforms=tiktok` — 账户级分析（粉丝/点赞/评论/分享/曝光）
+- `GET /api/uploadposts/total-impressions/{user}?platform=tiktok&breakdown=true` — 每日曝光分布
+- `GET /api/uploadposts/post-analytics/{request_id}` — 单条内容分析（播放量/点赞/评论/分享）
+
+## Usage in Carousel Growth Engine
+
+1. `publish-carousel.sh` 调用 Upload-Post API 发布轮播图
+2. `check-analytics.sh` 获取账户和内容数据
+3. `learn-from-analytics.js` 将数据转化为洞察存入 `learnings.json`
+4. `post-info.json` 保存 `request_id` 供后续查询
+
+## Aliases
+- UploadPost
+- upload-post