Cloudflare-hosted • TikTok posting API • agent-first

Let your agents actually publish to TikTok.

ClawToTikTok gives OpenClaw and other agent tools one clean API for uploading media, posting videos or photo slideshows, polling publish status, and reading per-post metrics. No bloated scheduler. No fake “social suite” baggage.

OpenClaw flow
1. POST /v1/uploads
2. PUT /v1/uploads/:assetId/content
3. POST /v1/posts
4. POST /v1/posts/:jobId/refresh
5. GET  /v1/analytics/posts

Headers:
  x-api-key: CLAWTOTIKTOK_API_KEY
  x-idempotency-key: stable-post-id
Review-ready UX
  • Explicit privacy selection from TikTok creator settings
  • Visible consent before direct publish
  • Draft upload fallback for inbox-based review
  • Account dashboard with logs, billing, and recent metrics
Video Direct post or draft upload with one uploaded asset.
Photos Slideshows backed by verified R2-hosted URLs on your media domain.
Metrics Views, likes, comments, and shares pulled back into your workspace.

Built for creator tools, not generic social dashboards

The first release is intentionally narrow: connect a TikTok account, upload media, publish from an agent, and keep enough account, billing, and status UI to satisfy both customers and TikTok app review.

Workspace-scoped API keys

Each customer gets a workspace, billing state, API key lifecycle, and isolated TikTok accounts so agencies and AI tools can keep client activity separated.

Cloudflare-first media path

Agents upload to the API, media lands in R2, and TikTok fetches it from a verified custom domain. That keeps slideshow support realistic instead of hand-wavy.

Status and post-level analytics

Every publish returns a job id. Poll it, refresh it, and query the workspace feed to map publish jobs back to real TikTok post ids and metrics.

API surface

The public API is small on purpose, which makes it easy for agents to reason about and easy for humans to audit.

Uploads

Create upload slots, then stream file bytes to the reserved upload endpoint.

POST /v1/uploads
PUT  /v1/uploads/:assetId/content

Publishing

Post one video or a batch of photos, choose direct or draft mode, and include the privacy choice that TikTok requires.

POST /v1/posts
GET  /v1/posts/:jobId
POST /v1/posts/:jobId/refresh

Account

Dashboard endpoints cover sign-in, billing, TikTok account linking, and API key lifecycle.

GET  /v1/account/me
POST /v1/account/billing/checkout
POST /v1/account/keys/rotate