Trenz Open Platform API

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.

Parameters

• category: Creator category ID. Creator categories differ from product categories — they are content-niche tags. No list is provided yet; we recommend first searching without this parameter and then using the category_label field from the response for further filtering.
• has_contact: Whether the creator has public contact info (true/false), filters creators with public email or social handles.

Parameters

• category: Streamer category ID; uses the same taxonomy as creator categories. No list is provided yet; we recommend first searching without this parameter.
• is_living: Whether currently live-streaming (true/false)
• is_commercial: Whether this is a commerce live stream (true/false)

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.

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

• 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.

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'.

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

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.