Trenz Open Platform API

Product Category ID Reference

The category parameter in search endpoints takes a numeric category ID. Below is the TikTok Level-1 category list:

Category ID	Category
601450	Beauty & Personal Care
601152	Womenswear & Underwear
700645	Health
603014	Sports & Outdoor
601739	Phones & Electronics
600942	Home Appliances
824328	Menswear & Underwear
605248	Fashion Accessories
700437	Food & Beverages
600001	Household Products
604453	Furniture
600024	Kitchenware
600154	Home Textiles
824584	Luggage & Bags
604206	Toys & Hobbies
601352	Shoes
604579	Tools & Hardware
604968	Home Improvement
602118	Pet Supplies
601755	Computers & Office
602284	Baby & Maternity
605196	Automotive & Motorcycle
951432	Collectibles
801928	Books, Magazines & Audio/Video
953224	Jewelry & Accessories
856720	Pre-Owned Goods
802184	Kids' Fashion

These are Level-1 categories. Passing a Level-1 ID filters all products under that category.

Parameters

• seller_type: Seller type (1=Overseas Non-Brand, 2=Local, 3=Brand, 4=Non-Brand)

Product Category ID Reference

The category parameter is the seller's primary product category ID; it uses the same taxonomy as product search:

Category ID	Category
601450	Beauty & Personal Care
601152	Womenswear & Underwear
700645	Health
603014	Sports & Outdoor
601739	Phones & Electronics
600942	Home Appliances
824328	Menswear & Underwear
605248	Fashion Accessories
700437	Food & Beverages
600001	Household Products
604453	Furniture
600024	Kitchenware
600154	Home Textiles
824584	Luggage & Bags
604206	Toys & Hobbies
601352	Shoes
604579	Tools & Hardware
604968	Home Improvement
602118	Pet Supplies
601755	Computers & Office
602284	Baby & Maternity
605196	Automotive & Motorcycle
951432	Collectibles
801928	Books, Magazines & Audio/Video
953224	Jewelry & Accessories
856720	Pre-Owned Goods
802184	Kids' Fashion

These are Level-1 categories. Passing a Level-1 ID filters all sellers primarily in that category.

Parameters

• category: Creator category ID (a content-niche tag, a different taxonomy from product categories). See "Creator Category ID Reference" below for allowed values. You may also search without it and read the category_label field from the response for precise filtering.
• has_contact: Whether the creator has public contact info (true/false), filters creators with public email or social handles.

Creator Category ID Reference

Category ID	Category
creator_category_v20240616_8	Shopping & Retail
creator_category_v20240616_15	Media & Entertainment
creator_category_v20240616_10	Beauty & Fashion
creator_category_v20240616_14	Personal Blog
creator_category_v20240616_12	Clothing & Accessories
creator_category_v20240616_32	Public Figure
creator_category_v20240616_23	Art & Crafts
creator_category_v20240616_17	Sports & Fitness
creator_category_v20240616_24	Health & Wellness
creator_category_v20240616_13	Music & Dance
creator_category_v20240616_9	Home, Furniture & Appliances
creator_category_v20240616_19	Pets & Animals
creator_category_v20240616_18	Education
creator_category_v20240616_11	Food & Drink
creator_category_v20240616_31	Automotive & transportation
creator_category_v20240616_5	Electronics
creator_category_v20240616_29	Gaming
creator_category_v20240616_30	Professional Services
creator_category_v20240616_16	Baby
creator_category_v20240616_33	Food & Cooking
creator_category_v20240616_20	Travel & Tourism
creator_category_v20240616_27	Finance & Investing
creator_category_v20240616_2	Machinery & Equipment
creator_category_v20240616_21	Brand
creator_category_v20240616_25	Consultant & Service
creator_category_v20240616_4	Property
creator_category_v20240616_28	Government & Politics
creator_category_v20240616_6	Restaurants & Bars
creator_category_v20240616_26	IT & High Tech
creator_category_v20240616_22	Software & Apps
creator_category_v20240616_3	LIVE Creator Networks
creator_category_v20240616_7	Movie, TV & Studio
creator_category_v20240616_34	Others

Creator and streamer (live) categories share the same taxonomy; this table also applies to the category parameter of "Data/Lives".

Parameters

• is_commercial: Whether this is a commerce video (true/false)

Product Category ID Reference

The category parameter is the video's associated product category ID:

Category ID	Category
601450	Beauty & Personal Care
601152	Womenswear & Underwear
700645	Health
603014	Sports & Outdoor
601739	Phones & Electronics
600942	Home Appliances
824328	Menswear & Underwear
605248	Fashion Accessories
700437	Food & Beverages
600001	Household Products
604453	Furniture
600024	Kitchenware
600154	Home Textiles
824584	Luggage & Bags
604206	Toys & Hobbies
601352	Shoes
604579	Tools & Hardware
604968	Home Improvement
602118	Pet Supplies
601755	Computers & Office
602284	Baby & Maternity
605196	Automotive & Motorcycle
951432	Collectibles
801928	Books, Magazines & Audio/Video
953224	Jewelry & Accessories
856720	Pre-Owned Goods
802184	Kids' Fashion

These are Level-1 categories. Passing a Level-1 ID filters all videos in that category.

Parameters

• category: Streamer category ID; uses the same taxonomy as creator categories. See "Streamer Category ID Reference" below for allowed values. You may also search without it.
• is_living: Whether currently live-streaming (true/false)
• is_commercial: Whether this is a commerce live stream (true/false)

Streamer Category ID Reference

Category ID	Category
creator_category_v20240616_8	Shopping & Retail
creator_category_v20240616_15	Media & Entertainment
creator_category_v20240616_10	Beauty & Fashion
creator_category_v20240616_14	Personal Blog
creator_category_v20240616_12	Clothing & Accessories
creator_category_v20240616_32	Public Figure
creator_category_v20240616_23	Art & Crafts
creator_category_v20240616_17	Sports & Fitness
creator_category_v20240616_24	Health & Wellness
creator_category_v20240616_13	Music & Dance
creator_category_v20240616_9	Home, Furniture & Appliances
creator_category_v20240616_19	Pets & Animals
creator_category_v20240616_18	Education
creator_category_v20240616_11	Food & Drink
creator_category_v20240616_31	Automotive & transportation
creator_category_v20240616_5	Electronics
creator_category_v20240616_29	Gaming
creator_category_v20240616_30	Professional Services
creator_category_v20240616_16	Baby
creator_category_v20240616_33	Food & Cooking
creator_category_v20240616_20	Travel & Tourism
creator_category_v20240616_27	Finance & Investing
creator_category_v20240616_2	Machinery & Equipment
creator_category_v20240616_21	Brand
creator_category_v20240616_25	Consultant & Service
creator_category_v20240616_4	Property
creator_category_v20240616_28	Government & Politics
creator_category_v20240616_6	Restaurants & Bars
creator_category_v20240616_26	IT & High Tech
creator_category_v20240616_22	Software & Apps
creator_category_v20240616_3	LIVE Creator Networks
creator_category_v20240616_7	Movie, TV & Studio
creator_category_v20240616_34	Others

category (streamer category) and product_category (commerce product category) are two different taxonomies — do not mix them up.

Product Category ID Reference

The product_category parameter is the product category ID for commerce lives:

Category ID	Category
601450	Beauty & Personal Care
601152	Womenswear & Underwear
700645	Health
603014	Sports & Outdoor
601739	Phones & Electronics
600942	Home Appliances
824328	Menswear & Underwear
605248	Fashion Accessories
700437	Food & Beverages
600001	Household Products
604453	Furniture
600024	Kitchenware
600154	Home Textiles
824584	Luggage & Bags
604206	Toys & Hobbies
601352	Shoes
604579	Tools & Hardware
604968	Home Improvement
602118	Pet Supplies
601755	Computers & Office
602284	Baby & Maternity
605196	Automotive & Motorcycle
951432	Collectibles
801928	Books, Magazines & Audio/Video
953224	Jewelry & Accessories
856720	Pre-Owned Goods
802184	Kids' Fashion

These are Level-1 categories. Passing a Level-1 ID filters all lives in that category.

Parameters

Ad Type Reference

Allowed values for ad_type:

Value	Ad Type
1	TikTok Shop Ads
2	Independent Site Ads
3	App Ads
4	Game Ads
5	Brand Ads
6	Lead Ads
7	Engagement Ads

Product Category ID Reference

The category parameter is the ad's associated product category ID:

Category ID	Category
601450	Beauty & Personal Care
601152	Womenswear & Underwear
700645	Health
603014	Sports & Outdoor
601739	Phones & Electronics
600942	Home Appliances
824328	Menswear & Underwear
605248	Fashion Accessories
700437	Food & Beverages
600001	Household Products
604453	Furniture
600024	Kitchenware
600154	Home Textiles
824584	Luggage & Bags
604206	Toys & Hobbies
601352	Shoes
604579	Tools & Hardware
604968	Home Improvement
602118	Pet Supplies
601755	Computers & Office
602284	Baby & Maternity
605196	Automotive & Motorcycle
951432	Collectibles
801928	Books, Magazines & Audio/Video
953224	Jewelry & Accessories
856720	Pre-Owned Goods
802184	Kids' Fashion

These are Level-1 categories. Passing a Level-1 ID filters all ads in that category.

Parameters

• country: Country code. Allowed values: us, th, my, vn, mx, de, fr, it, es, jp, br, gb, ph, sg, id

Product Category ID Reference

The category parameter is the creative's associated product category ID:

Category ID	Category
601450	Beauty & Personal Care
601152	Womenswear & Underwear
700645	Health
603014	Sports & Outdoor
601739	Phones & Electronics
600942	Home Appliances
824328	Menswear & Underwear
605248	Fashion Accessories
700437	Food & Beverages
600001	Household Products
604453	Furniture
600024	Kitchenware
600154	Home Textiles
824584	Luggage & Bags
604206	Toys & Hobbies
601352	Shoes
604579	Tools & Hardware
604968	Home Improvement
602118	Pet Supplies
601755	Computers & Office
602284	Baby & Maternity
605196	Automotive & Motorcycle
951432	Collectibles
801928	Books, Magazines & Audio/Video
953224	Jewelry & Accessories
856720	Pre-Owned Goods
802184	Kids' Fashion

These are Level-1 categories. Passing a Level-1 ID filters all creatives in that category.

All *_url fields in this section require publicly accessible URLs. To upload local files, first call the 'Generate Presigned Upload URL' endpoint under 'File Upload'.

All *_url fields in this section require publicly accessible URLs. To upload local files, first call the 'Generate Presigned Upload URL' endpoint under 'File Upload'.

You must bind at least one social account before using any social media feature. TikTok QR-code login is currently supported. Once bound, call 'Social Account List' to view all connected accounts with their status and metrics.

One-step publishing via 'Upload and Publish Video', with support for immediate and scheduled publishing across multiple accounts.

Prerequisite: Bind a Social Account

You must bind at least one social account before publishing. Go to 'Social/1.Account Management' and use 'TikTok QR Code Login' + 'TikTok QR Code Status' for QR-based binding. Once bound, retrieve the id field from 'Social Account List' — this is the platform_account_id required by the publishing endpoint below.

---

Step 1: Upload File

1.1 Call 'Generate Presigned Upload URL' to get a temporary upload URL (this endpoint is under 'File Upload')

Code
curl -X POST "https://openapi.gateway.trenz.com/open/v1/social/upload/presigned-url" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"file_name": "my_video.mp4"}'

Response example:

Code
{
  "data": {
    "presigned_url": "https://data-datanebula-object.tos-ap-southeast-1.volces.com/upload/my_video.mp4_xxx?...",
    "object_key": "upload/my_video.mp4_xxx",
    "s3_bucket": "data-datanebula-object",
    "cdn_url": "https://oss-data.trenz.ai/upload%2Fmy_video.mp4_xxx?..."
  }
}

Record the returned object_key and s3_bucket — they are needed in the following steps.

1.2 Upload the file to presigned_url via PUT

Code
curl -X PUT "{presigned_url}" \
  -H "Content-Type: video/mp4" \
  --data-binary @my_video.mp4

presigned_url is valid for 1 hour. File size limits depend on the target platform (TikTok max 4GB, YouTube max 256GB, Instagram Reels max 1GB).

---

Step 2: Validate Video Info (Recommended)

After upload, call 'Validate Video Info' to check that the video matches the target platform's spec (resolution, duration, bitrate, etc.) and avoid publishing failures:

Code
curl -X POST "https://openapi.gateway.trenz.com/open/v1/social/videos/check-info" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bucket_name": "data-datanebula-object", "bucket_key": "upload/my_video.mp4_xxx"}'

This endpoint checks encoding, resolution, duration, etc. against the requirements of TikTok, YouTube, Instagram and other platforms.

---

Step 3: Call 'Upload and Publish Video'

Code
curl -X POST "https://openapi.gateway.trenz.com/open/v1/social/publish/upload-and-publish" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "video_title": "My Video",
    "video_description": "Check this out!",
    "bucket_name": "data-datanebula-object",
    "bucket_key": "upload/my_video.mp4_xxx",
    "publications": [
      {
        "platform_account_id": 4687,
        "title": "Check out this video!",
        "platform_config": "{\"privacy\":\"PUBLIC_TO_EVERYONE\"}"
      }
    ]
  }'

bucket_name = the s3_bucket returned in Step 1, bucket_key = the object_key returned in Step 1. Supports publishing to multiple accounts in parallel via the publications array. The returned session_token is used to poll publishing progress.

Scheduled Publishing

Set scheduled_at (Unix seconds) in each publications entry to schedule publishing. Each account can have its own schedule:

Code
{
  "video_title": "My Video",
  "bucket_name": "data-datanebula-object",
  "bucket_key": "upload/my_video.mp4_xxx",
  "publications": [
    {
      "platform_account_id": 4687,
      "title": "Publish now",
      "platform_config": "{\"privacy\":\"PUBLIC_TO_EVERYONE\"}"
    },
    {
      "platform_account_id": 5678,
      "title": "Publish tomorrow",
      "scheduled_at": 1774100400,
      "platform_config": "{\"share_to_feed\":true}"
    }
  ]
}

scheduled_at must fall within 5 minutes to 90 days from now. Omit or set to 0 for immediate publishing; values under 5 minutes are auto-demoted to immediate. Scheduled publications can be rescheduled via the 'Reschedule' endpoint.

---

Step 4: Poll 'Publish Session Status'

Code
curl -X POST "https://openapi.gateway.trenz.com/open/v1/social/publish/session" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"session_token": "127169e7-35e3-40..."}'

Recommended poll interval: 3–5 seconds. Repeat until status is completed or failed.

Cancel Publishing (Optional)

• 'Cancel Publish Session' cancels an in-progress session: POST /open/v1/social/publish/session/cancel
• 'Cancel Individual Publish' cancels a submitted publication: POST /open/v1/social/publish/cancel

AI conversational agent endpoint (streaming Server-Sent Events response).

Read-only sessions & reports: list sessions, get session messages, get session reports, get a single report. Free endpoints.

Query account status, tier and credits balance.

Async Task Workflow

1. Submit the task (e.g. POST /open/v1/ai/videos/content-analysis) → returns task_id
2. Poll status: GET /open/v1/tasks/{task_id}
   • status="running" → keep polling (recommended interval 3-5 sec)
   • status="success" → the result field contains the full result
   • status="failed" → the error_message field contains the error details
3. Successful task results are persisted and can be retrieved again at any time

All AI analysis and AI generation endpoints are async. They return task_id immediately without blocking.