Skip to main content

FAQ

How do I schedule a video on an existing account?​

  • Create a videos_only bundle using bundles-create-videos-only with your existing_account_id.
  • Configure each video with POST /video-configure-at-position and set target_start (UTC ISO-8601). The platform clamps the start to at least D+3 and sets the end to start+3 days.
  • Publish the bundle with POST /bundles-publish. Our managers handle execution in the target country.

Can I upload carousels with the API?​

  • Not yet. The API currently supports only video_type="video" for publishing. Carousel support is not available at the moment.

Do I need to pass the country for videos_only?​

  • No. The country is derived from the saved account. If your saved account was created in FR, the bundle country will be FR.

Where do I see my stable TikTok URL and credentials?​

  • Use Saved Accounts endpoints (IDs belong to you):
    • GET /saved-accounts (list)
    • GET /saved-account?id=<uuid>
    • GET /saved-account-by-username?username=<name>
    • GET /saved-account-by-bundle?bundle_id=<uuid>
  • These return tiktok_url, tokmail_email, and tiktok_password.

When am I charged?​

  • At bundle publish time only. 1 credit = $1. You can top-up from the developer portal.
  • Provide direct, public, long-lived URLs. Expired/broken links will fail processing and are not refunded. See 06-media-requirements.md.

How do I ensure idempotency?​

  • Provide external_ref when creating bundles or configuring videos (where available). Wallet operations are idempotent server-side.

Rate limits?​

  • Default: 60 requests/minute per API key / endpoint / IP. Per-endpoint overrides may apply (e.g., 20/min for create, 120/min for state). Overages return 429 with Retry-After. See the "Idempotency and Rate Limits" page for details.

Why do I get "invalid_api_key" sometimes?​

  • Ensure your header is not wrapped with extra quotes. Use:
    • Correct: -H "X-API-Key: $API_KEY"
    • Incorrect: -H "X-API-Key: '$API_KEY'"

Does account_only create video slots?​

  • No. account_only requires videos_quantity = 0 and creates no video slots.