TikTok’s Business API exposes the creative performance data, audience demographics, and trend signals that most marketing teams never touch. These five jobs pull that data through Mavera’s surfaces (Video Analysis, Focus Groups, Personas, Mave Agent, Generate) to score video hooks, rank creatives by behavioral metrics, test concepts with generational personas, and measure how audio choice affects emotional response.Documentation Index
Fetch the complete documentation index at: https://docs.mavera.io/llms.txt
Use this file to discover all available pages before exploring further.
API Reference Card
| Detail | Value |
|---|---|
| Base URL | https://business-api.tiktok.com/open_api/v1.3/ |
| Auth | OAuth 2.0 — Access-Token: {token} header |
| Rate limits | 10–20 QPS depending on endpoint; 10,000 daily for reporting |
| Mavera base | https://app.mavera.io/api/v1 |
| Mavera auth | Authorization: Bearer mvra_live_... |
All examples use three environment variables:
TIKTOK_ACCESS_TOKEN, TIKTOK_ADVERTISER_ID, and MAVERA_API_KEY. TikTok tokens are long-lived but can be revoked. Store them in your secrets manager.Prerequisites
TikTok for Business account
Register at TikTok for Business. Create or link an ad account with active campaigns.
Marketing API access
Apply for API access at TikTok Marketing API. Obtain your App ID, Secret, and complete the OAuth flow.
Mavera API key
Get your key from Mavera dashboard.
Jobs
| # | Job | TikTok Data | Mavera Surface | Output |
|---|---|---|---|---|
| 1 | Ad Video Analysis Pipeline | Video ads from ad/get/ | Video Analysis | Hook scoring, emotional arc, cognitive load |
| 2 | Cross-Creative Leaderboard | Creatives + performance | Video Analysis | Predictive scoring vs actual CTR |
| 3 | Audience → Gen Z Focus Group | Audience demographics | Personas + Focus Groups | Generational concept testing |
| 4 | Trend → Content Pipeline | Trending hashtags | Mave Agent + Generate | Brand-aligned trend content |
| 5 | Sound/Music Impact Analysis | Same visual, different audio | Video Analysis | Emotional intensity comparison |
Rate Limits & Production Notes
| TikTok Endpoint | Limit | Strategy |
|---|---|---|
Ad Management (/ad/get/) | 10 QPS | Batch with page_size up to 1000 |
Reporting (/reports/) | 10–20 QPS; 10,000/day | Cache daily; run overnight jobs |
| Research API | 1,000/day | Prioritize; cache trend data for 6h |
File Info (/file/video/) | 20 QPS | Rate-limit downloads; use CDN caching |
GET /oauth2/token_info/. Handle pagination via page and page_size params. Monitor X-TT-RateLimit-Remaining headers. Compress video before Mavera upload. Cache TikTok data for daily analysis runs. Monitor Mavera credits at Dashboard.