45 lines
1.6 KiB
Markdown
45 lines
1.6 KiB
Markdown
---
|
||
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
|