---
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