Warning (2) : Undefined property: stdClass::$primary_color [in /var/www/html/templates/layout/bold.php, line 58] #600AB6; --company-primary-light-color:
Warning (2) : Undefined property: stdClass::$primary_light_color [in /var/www/html/templates/layout/bold.php, line 58]
#f1faff;">

API Documentation

  • Home
  • Developer
  • API Documentation

TikTok Business API v1.0

REST API

Welcome to TikTok Business API

Our RESTful API provides comprehensive TikTok ad account management services for white label providers. Connect TikTok Business Centers, manage ad accounts, handle top-ups and refunds, and integrate seamlessly with your platform to automate TikTok advertising operations.

Base URL
https://api.ttlab.business/v1
Authentication
Bearer Token Required
Getting Started

New to our API? Get your API keys and start integrating in minutes.

API Endpoints

Authentication

Secure API access with token-based authentication

POST /api/auth

Authenticate and get access token (No parameters required)

Response Example:
{
    "access_token": "string",    "token_type": "bearer",    "expires_in": "integer"}

Business Centers (BC)

Retrieve TikTok Business Centers

GET /api/tiktok/business-centers

Get list of all Business Centers (No parameters required)

Response Example:
{
    "bc_id": "string",    "bc_name": "string",    "role": "string",    "status": "string",    "ad_accounts_count": "integer",    "created_time": "timestamp"}

Ad Accounts Management

Create and manage TikTok ad accounts

POST /api/ad-accounts/create

Create a new agency ad account. BC will be invited as admin.

Parameters:
Parameter Type Required
bc_id string - BC that will be invited to be admin on new agency ad account. Example: "747474747474" Required
advertiser_info object - Account information Required
advertiser_info.name string - Ad account name. Example: "test_ad_account_workshop" Required
advertiser_info.currency string - Currency code. Example: "USD" Required
advertiser_info.timezone string - Timezone. Example: "Africa/Casablanca" Required
customer_info object - Customer information Required
customer_info.company string - Customer company name Required
customer_info.industry integer - Industry code. Example: 290410 Required
customer_info.registered_area string - Country code. Example: "MA" Required
Response Example:
{
    "success": "boolean",    "account_id": "string",    "account_name": "string",    "bc_id": "string",    "currency": "string",    "timezone": "string",    "status": "string",    "created_at": "timestamp"}
GET /api/ad-accounts

Get list of all ad accounts grouped by Business Center (No parameters required)

Response Example:
{
    "business_centers": "array - List of BCs with their ad accounts",    "bc_id": "string",    "bc_name": "string",    "accounts": "array - Ad accounts under this BC",    "total_accounts": "integer"}

Top-Up & Refund

Manage ad account balance with top-ups and refunds

POST /api/ad-accounts/{account_id}/top-up

Add funds to ad account balance

Parameters:
Parameter Type Required
account_id string - Ad account ID Required
cash_amount decimal - Amount to add Required
Response Example:
{
    "success": "boolean",    "transaction_id": "string",    "account_id": "string",    "type": "topup",    "cash_amount": "decimal",    "balance_before": "decimal",    "balance_after": "decimal",    "currency": "string",    "status": "completed",    "created_at": "timestamp"}
POST /api/ad-accounts/{account_id}/refund

Refund funds from ad account balance

Parameters:
Parameter Type Required
account_id string - Ad account ID Required
cash_amount decimal - Amount to refund Required
Response Example:
{
    "success": "boolean",    "transaction_id": "string",    "account_id": "string",    "type": "refund",    "cash_amount": "decimal",    "balance_before": "decimal",    "balance_after": "decimal",    "currency": "string",    "status": "completed",    "created_at": "timestamp"}