MokoConsulting/MokoSuiteCross
1
0
Fork 0
Code Issues 25 Pull Requests 1 Releases 2 Wiki Activity

TikTok: video and photo carousel posting #164

New Issue
Open
opened 2026-06-23 13:39:52 +00:00 by jmiller · 0 comments
jmiller commented 2026-06-23 13:39:52 +00:00
Owner
Copy Link
Copy Source

Summary

The TikTok Content Posting API is publicly available and supports video uploads and photo carousels (up to 35 images). Our existing TikTok plugin only does basic text posts.

API Capabilities

Video Upload

  • MP4 up to 1GB
  • Two methods: FILE_UPLOAD (local) or PULL_FROM_URL (remote URL)
  • Two posting modes: DIRECT_POST (publish immediately) or MEDIA_UPLOAD (sends to user's TikTok inbox for in-app editing)

Photo Carousels

  • Up to 35 images (JPEG/PNG/WebP, max 20MB each)
  • media_type=PHOTO

Important Limitations

  • Audit required: Apps must pass TikTok's audit for public visibility
  • Unverified apps: All API-uploaded content is private-only
  • Rate limits: 6 requests/minute, 25 videos/account/day

Implementation

Update TiktokService::publish():

  • Detect media type (video vs images)
  • Use PULL_FROM_URL for video (article featured video URL)
  • Use photo carousel for multiple images
  • Default to DIRECT_POST mode

Acceptance Criteria

  • Video upload via PULL_FROM_URL
  • Photo carousel support (multiple images)
  • Posting mode config (direct vs inbox)
  • Audit requirement warning in plugin config
  • Documentation about TikTok API audit process

Note

The audit requirement is a significant onboarding hurdle. Users must register a TikTok developer app and pass review before public posting works. Document this clearly.

## Summary The TikTok Content Posting API is publicly available and supports video uploads and photo carousels (up to 35 images). Our existing TikTok plugin only does basic text posts. ## API Capabilities ### Video Upload - MP4 up to 1GB - Two methods: `FILE_UPLOAD` (local) or `PULL_FROM_URL` (remote URL) - Two posting modes: `DIRECT_POST` (publish immediately) or `MEDIA_UPLOAD` (sends to user's TikTok inbox for in-app editing) ### Photo Carousels - Up to 35 images (JPEG/PNG/WebP, max 20MB each) - `media_type=PHOTO` ## Important Limitations - **Audit required**: Apps must pass TikTok's audit for public visibility - **Unverified apps**: All API-uploaded content is **private-only** - Rate limits: 6 requests/minute, 25 videos/account/day ## Implementation Update `TiktokService::publish()`: - Detect media type (video vs images) - Use `PULL_FROM_URL` for video (article featured video URL) - Use photo carousel for multiple images - Default to `DIRECT_POST` mode ## Acceptance Criteria - [ ] Video upload via `PULL_FROM_URL` - [ ] Photo carousel support (multiple images) - [ ] Posting mode config (direct vs inbox) - [ ] Audit requirement warning in plugin config - [ ] Documentation about TikTok API audit process ## Note The audit requirement is a significant onboarding hurdle. Users must register a TikTok developer app and pass review before public posting works. Document this clearly.
Sign in to join this conversation.
Labels
No items
No labels
Priority Medium
Type Feature
Milestone
No items
No Milestone
Assignees
Clear assignees
jmiller (Jonathan Miller)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: MokoConsulting/MokoSuiteCross#164
Delete Branch "%!s()"

Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?