Skip to main content

Overview

TokPortal provides a simple HTTP API to create and manage TikTok execution bundles handled by local managers.

  • Base URL: https://api.tokportal.com
  • Authentication: X-API-Key: <your_api_key> header
  • Format: JSON over HTTPS
  • Webhooks: none (use polling endpoints)

How it works​

On TokPortal, you create "bundles" which are missions executed by local managers. A bundle can include creating a new account, creating an account and posting videos, or posting videos on an existing account you own on TokPortal. The API lets you perform these actions and track progress.

High-level steps:

  1. Create a bundle with POST /bundles-create or POST /bundles-create-videos-only, choosing its bundle_type (account_only, account_and_videos, or videos_only), country, and important options like videos_quantity, niche_warming (account warming on a specific niche), or wants_moderation (community management).
  2. Configure resources:
    • Account configuration with POST /account-configure (e.g., desired username, profile_picture_url).
    • Video configuration with POST /video-configure-at-position for each position 1..N (e.g., caption, video_url, target_start). Media must be direct, public, non-expiring URLs.
    • You don’t need to configure every video to publish the bundle: the minimum is a configured account plus at least one configured video (for videos_only, one configured video is enough).
  3. Publish with POST /bundles-publish. The bundle becomes visible to managers of the selected country who take it in charge.
  4. Track progress and states using the state-* endpoints (account/video/bundle). You can request corrections with the request-corrections-* endpoints or enable auto-approval if preferred.

What you can do​

  • Order an account only, account + videos, or videos on an existing saved account.
  • Pre-create N video slots that you later configure and publish.
  • Track states for bundles, accounts and videos.
  • Pay using prepaid wallet credits (1 credit = $1). Charges happen only at bundle publish.

Two main flows​

  • Account + Videos (A+V): you get a brand-new account and N videos.

    • Create bundle with bundle_type = account_and_videos and an allowed quantity (5,10,25,50,100,500).
    • N video slots are pre-created with status pending and a per-video price.
    • Configure the account, configure each video, then publish the bundle (wallet is charged here).
    • Optionally publish individual videos at positions once the bundle is published/accepted.

  • Account Only (AO): order only a brand-new account.

    • Create bundle with bundle_type = account_only and set videos_quantity = 0.
    • Configure the account, then publish the bundle. No video slots are created.

  • Videos Only (VO): schedule videos on one of your saved accounts.

    • Create bundle with bundle_type = videos_only and existing_account_id you own.
    • Country is derived from the saved account. Account listing is auto-filled (price 0).
    • N video slots are pre-created with status pending and a per-video price.
    • Configure each video, then publish the bundle.

Countries​

  • Use platform country codes: USA, UK, FR, CA, IT, PH.
  • Availability may vary by time; the authoritative list is visible in your dashboard on app.tokportal.com (Bundles → Create).
  • For videos_only, country derives from the chosen saved account.

Media​

  • Provide direct, public, stable HTTPS URLs.
    • Video: video_url (e.g., .mp4)
    • Profile picture: profile_picture_url (e.g., .jpg, .png)
  • See 06-media-requirements.md for strict URL requirements.

Statuses (high level)​

  • Bundle: draft → pending_setup → published/accepted → in_review → finalized → completed
  • Account listing: pending → configured → in_review → finalized → completed
  • Video listing: pending → configured → published → in_review → finalized → completed

Scheduling window (videos)​

  • You must provide target_start.
  • The platform clamps target_start ≥ current_date + 3 days.
  • target_end is automatically set to target_start + 3 days.

Pricing Summary​

  • Account price: 19
  • Community moderation option: +19
  • Niche warming option: +5
  • Per-video price by package size: 5→2.25, 10→1.95, 25→1.60, 50→1.25, 100→0.95, 500→0.75
  • Edits option: 2 per edit (if enabled and credits available)

See the dedicated sections for more examples: Getting Started, Bundles, Videos, and Wallet.