Skip to main content

UGC Distribution at Scale

Brands collect UGC from creators, then amplify it through organic, geo-targeted accounts. Creators make the content; TokPortal distributes it across markets. No VPNs, no bots — real devices in 16+ countries.

The Workflow​

  1. Collect UGC — Creators submit videos via your portal, Dropbox, or API
  2. Upload to TokPortal — Add videos to bundles via the media upload API
  3. Distribute by country — Create accounts in target markets (US, UK, Brazil, etc.)
  4. Track performance — Pull analytics per account and video

Create Geo-Targeted Bundles for UGC​

Create one bundle per market. Each bundle gets an account + video slots for your UGC:

# US market
curl -X POST https://api.tokportal.com/v1/bundles \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bundle_type": "account_and_videos",
    "platform": "tiktok",
    "country": "USA",
    "videos_quantity": 12,
    "title": "UGC Wave 1 - US",
    "wants_niche_warming": true,
    "niche_warming_instructions": "Lifestyle and product review niche. Follow similar brands, engage with unboxing content."
  }'

# UK market
curl -X POST https://api.tokportal.com/v1/bundles \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "bundle_type": "account_and_videos",
    "platform": "tiktok",
    "country": "GBR",
    "videos_quantity": 12,
    "title": "UGC Wave 1 - UK"
  }'

See Create Bundle for full parameters.

Scale Across Multiple Markets​

Use bulk creation to provision accounts per country. Loop through your target markets:

# Example: create 2 accounts (TikTok + Instagram) per country
for country in USA GBR BRA DEU FRA; do
  curl -X POST https://api.tokportal.com/v1/bundles/bulk \
    -H "Authorization: Bearer $TOKEN" \
    -H "Content-Type: application/json" \
    -d "{
      \"accounts_count\": 1,
      \"upload_accounts_count\": 1,
      \"platforms\": [\"tiktok\", \"instagram\"],
      \"country\": \"$country\",
      \"videos_quantity\": 10,
      \"metadata\": { \"campaign\": \"UGC-Spring2026\" }
    }"
done

You get 2 accounts per country (TikTok + Instagram). Upload the same UGC set to each; TokPortal handles localization and posting.

Track UGC Performance by Market​

After publishing, pull per-account and per-video analytics:

curl -X GET "https://api.tokportal.com/v1/accounts/{account_id}/analytics" \
  -H "Authorization: Bearer $TOKEN"

Response includes total_views, average_engagement_rate, and per-video breakdown. Compare US vs UK vs Brazil to see which markets perform best.

Best Practices​

  • Batch by campaign — Use title or external_ref to group bundles (e.g. UGC-Spring2026-US)
  • Localize captions — Upload localized descriptions per country when configuring videos
  • Stagger posting — Avoid publishing the same UGC everywhere on the same day; spread over 1–2 weeks

What's Next​

Ready to scale UGC distribution? Get API access at the developer portal or schedule a call with the team.