Product Seeding Workflows for TikTok

E-commerce teams can use TokPortal to coordinate product demo, unboxing, and UGC-style TikTok workflows. The current public video configuration API supports captions, publish dates, media URLs, TikTok sound URLs, carousels, and moderation/warming options.

TokPortal does not currently document a public API field for native TikTok Shop product tagging. If your workflow requires product tags, manage that separately from the current TokPortal public API.

Create a product-focused bundle

curl -X POST https://app.tokportal.com/api/ext/bundles \
  -H "X-API-Key: $TOKPORTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "bundle_type": "account_and_videos",
    "platform": "tiktok",
    "country": "US",
    "videos_quantity": 8,
    "title": "Skincare demo - US",
    "wants_niche_warming": true,
    "niche_warming_instructions": "Beauty, skincare, product review, and unboxing content.",
    "wants_moderation": true,
    "moderation_notice": "Check for required disclosure language and avoid unsupported claims.",
    "external_ref": "skincare-demo-us"
  }'

Reference: Create Bundle

Configure product content

curl -X PUT https://app.tokportal.com/api/ext/bundles/bnd_abc123/videos/batch \
  -H "X-API-Key: $TOKPORTAL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "videos": [
      {
        "position": 1,
        "video_type": "video",
        "description": "Unboxing the new serum. Results vary. #skincare #unboxing",
        "target_publish_date": "2026-06-05",
        "video_url": "https://cdn.example.com/skincare/unboxing-01.mp4",
        "external_ref": "serum-unboxing-us-01"
      },
      {
        "position": 2,
        "video_type": "video",
        "description": "How it fits into a morning routine #grwm",
        "target_publish_date": "2026-06-07",
        "video_url": "https://cdn.example.com/skincare/routine-01.mp4",
        "external_ref": "serum-routine-us-01"
      }
    ]
  }'

Reference: Configure Videos

Scale across buyer markets

Create one bulk batch per country:

for country in US UK FR DE; do
  curl -X POST https://app.tokportal.com/api/ext/bundles/bulk \
    -H "X-API-Key: $TOKPORTAL_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{
      \"accounts_count\": 2,
      \"upload_accounts_count\": 1,
      \"platforms\": [\"tiktok\"],
      \"country\": \"$country\",
      \"videos_per_account\": 6,
      \"wants_niche_warming\": true,
      \"wants_moderation\": true,
      \"niche_warming_instructions\": \"Beauty, product reviews, and shopping-adjacent content.\",
      \"external_ref\": \"skincare-demo-$country\"
    }"
done

Reference: Create Bulk

Content that fits the current API

• Product demos using video_url
• Unboxings and first impressions
• Before/after-style content only where substantiated and compliant
• UGC reposts where you have usage rights
• Localized captions per country

Measure results

curl -X GET "https://app.tokportal.com/api/ext/accounts/acc_abc123/analytics" \
  -H "X-API-Key: $TOKPORTAL_API_KEY"

For post-level rows:

curl -X GET "https://app.tokportal.com/api/ext/accounts/acc_abc123/analytics/videos" \
  -H "X-API-Key: $TOKPORTAL_API_KEY"

Reference: Analytics

Related docs: Media Upload, CSV Import, Webhooks, UGC Distribution.