Developers

API Docs

Use BillionViews to connect authorized TikTok accounts, create posts, and inspect status through a hosted API and web console.

Core flow

Create an account connection link in the console, have the authorized user approve TikTok access, upload media through the API, create a draft, start the TikTok upload, then poll status.

  1. Create an API key in the BillionViews console.
  2. Generate a TikTok OAuth connection URL for a customer account.
  3. Upload media with the signed upload target.
  4. Create a draft and start a TikTok upload request.
  5. Review post status, TikTok errors, logs, and lightweight analytics.

Example request

API keys are customer-scoped and should be kept server-side.

curl https://api.billionviews.app/api/v1/workspaces/ws_123/brand-accounts/acct_123/tiktok/drafts \
  -H "Authorization: Bearer bv_live_example" \
  -H "Content-Type: application/json" \
  -d '{
    "assetIds": ["asset_123"],
    "caption": "Behind the scenes"
  }'

Current endpoints

API keys can call the workspace-scoped posting endpoints. The web console wraps these endpoints with pages for accounts, posts, logs, API keys, settings, and summary analytics.

  • GET /api/v1/workspaces
  • GET /api/v1/workspaces/{workspaceId}/brand-accounts
  • POST /api/v1/workspaces/{workspaceId}/brand-accounts/{accountId}/tiktok/assets/upload-url
  • POST /api/v1/workspaces/{workspaceId}/brand-accounts/{accountId}/tiktok/assets/{assetId}/complete
  • POST /api/v1/workspaces/{workspaceId}/brand-accounts/{accountId}/tiktok/drafts
  • POST /api/v1/workspaces/{workspaceId}/brand-accounts/{accountId}/tiktok/drafts/{draftId}/upload
  • GET /api/v1/workspaces/{workspaceId}/brand-accounts/{accountId}/tiktok/uploads/latest
  • GET /api/v1/workspaces/{workspaceId}/audit-logs