Skip to main content

Saved Accounts

Saved accounts are durable TikTok accounts created/managed through TokPortal. These endpoints let you retrieve your own saved accounts (ownership validated via API key).

Endpoints:

  • List: GET /saved-accounts?limit=<n>&offset=<n>
  • By ID: GET /saved-account?id=<uuid>
  • By username: GET /saved-account-by-username?username=<name>
  • By bundle: GET /saved-account-by-bundle?bundle_id=<uuid>

Returned fields include (non-exhaustive):

  • id, account_listing_requested_username, account_listing_visible_name, account_listing_biography, account_listing_profile_picture_url, account_listing_country
  • tiktok_url (stable), tokmail_email, tiktok_password, created_at

See also: Finding your IDs (My bundles) for quickly copying saved account IDs in the UI.

Sensitive/deprecated fields are excluded (e.g. account_listing_social_credentials). Use fields query parameter to whitelist specific fields (comma-separated) when available.

Notes:

  • For videos_only bundles, you must provide an existing_account_id that belongs to you and has a valid tiktok_url.