310 Douyin Data APIs Now Available on SandBase
SandBase now offers 310 Douyin data operations covering search, creator analytics, video data, hot trends, and influencer marketing, all callable via /v1/run.
TL;DR — 310 Douyin data operations are now available through SandBase’s agent ecosystem. Ten functional channels: trending indices (72 ops), web scraping (45), app-level data (40), billboards (32), Xingtu influencer marketplace (58 combined), creator analytics (37), DOU+ promotion (16), and search (10). Most operations cost $0.001/call. Your agent calls them the same way it calls an LLM — one contract, one key, sync response.
What is available
310 structured API operations for Douyin, organized into 10 channels:
| Channel | Operations | What it covers | Price range |
|---|---|---|---|
douyin/index/* | 72 | Trending indices, core metrics, data dashboards | $0.001-$0.02 |
douyin/web/* | 45 | Public web data, knowledge videos, live rooms | $0.001-$0.01 |
douyin/app-v3/* | 40 | App-level video data, user profiles, batch queries | $0.001-$0.25 |
douyin/billboard/* | 32 | Hot account lists, trending content rankings | $0.001 |
douyin/xingtu-v2/* | 30 | Xingtu influencer marketplace v2 (fields, rankings, analytics) | $0.001-$0.02 |
douyin/xingtu/* | 28 | Xingtu influencer marketplace v1 (KOL indices, campaigns) | $0.001-$0.02 |
douyin/creator/* | 23 | Creator content categories, audience data, performance | $0.001 |
douyin/douplus/* | 16 | DOU+ promotion data, promotable items, campaign analytics | $0.001 |
douyin/creator-v2/* | 14 | Creator data v2, item lists, exports | $0.001-$0.01 |
douyin/search/* | 10 | Video search, hashtag search, user search | $0.001-$0.01 |
Price distribution
79% of operations (246 out of 310) cost $0.001 per call. The breakdown:
| Price | Operations | % of total |
|---|---|---|
| $0.001 | 246 | 79.4% |
| $0.02 | 23 | 7.4% |
| $0.01 | 12 | 3.9% |
| $0.002-$0.005 | 16 | 5.2% |
| $0.05-$0.25 | 9 | 2.9% |
| Free ($0) | 1 | 0.3% |
The $0.25 tier covers premium batch operations like multi-video fetches with full metadata. Standard queries (profiles, single videos, trending lists) are all in the $0.001 range.
How it works
Every Douyin operation is callable through the same /v1/run endpoint your agent already uses for LLMs and other capabilities:
curl -X POST https://api.sandbase.ai/v1/run \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "douyin/search/challenge-search-v1",
"keyword": "AI创作",
"count": 20
}'
Response comes back synchronously as a JSON object — same as any other SandBase operation. No separate auth flow, no SDK to install, no webhook to configure.
The contract normalization
Underneath, these 310 operations have different HTTP methods (GET vs POST), different parameter positions (query string vs body vs path), and different body shapes (objects, arrays, optional strings). SandBase’s adapter layer handles all of that.
What your agent sees:
- One endpoint:
/v1/run - One auth: your API key
- One request format:
{"model": "<operation-name>", ...params} - One response format: JSON object, every time
What the adapter handles:
- GET operations with query parameters → mapped from your JSON body
- POST operations with nested JSON → passed through with type preservation
- Path parameters → extracted and injected safely
- Required/optional field validation → fail-closed before hitting upstream
First workflows to build
Competitor intelligence (daily, $0.90/month)
Track 10 competitor accounts:
Every morning:
1. douyin/app-v3/user-profile × 10 → follower changes
2. douyin/creator/item-list × 10 → new video detection
3. douyin/app-v3/video-detail × N → engagement on new videos
4. LLM analysis → briefing
Cost: ~30 calls/day × $0.001 = $0.03/day = $0.90/month.
Content trend detection (hourly, $14.40/month)
Monitor trending topics in your vertical:
Every 15 minutes:
1. douyin/billboard/hot-account-list → who's trending
2. douyin/index/topic-query × 3 → topic volume changes
3. douyin/search/challenge-search-v1 → hashtag activity
4. LLM classification → alert if relevant
Cost: ~5 calls/cycle × 96 cycles/day × $0.001 = $0.48/day = $14.40/month.
KOL evaluation (on-demand, $0.06/KOL)
Score influencers before brand deals:
Per KOL:
1. douyin/app-v3/user-profile → follower count, bio
2. douyin/xingtu-v2/kol-xingtu-index → platform score
3. douyin/creator/creator-content-category → content classification
4. douyin/index/daren-great-item-mile-info → core performance metrics
5. douyin/creator/item-list → recent 20 videos for engagement rate
Cost: ~5-6 calls × $0.001-$0.02 = $0.02-$0.06 per KOL. Evaluate 100 KOLs for $2-$6.
What SandBase adds beyond the raw endpoints
These 310 operations exist in the SandBase ecosystem, which means they get the same runtime capabilities as every other integrated service:
- Session context: Douyin data calls happen within an agent session alongside LLM calls, sandbox execution, and other tools. The agent reasons over Douyin data in the same turn it fetches it.
- Composability: Chain a Douyin search → filter by engagement → fetch details → LLM scoring → output report, all in one workflow definition.
- Observability: Every Douyin API call appears in your trace with latency, cost, and the parameters used. Debug why your agent made a decision.
- Skill packaging: Wrap “daily competitor briefing” as a reusable skill. Other agents invoke it without reimplementing the Douyin integration.
- Smart routing: If a specific upstream endpoint is slow or degraded, the system observes and reports — your agent gets clear error signals, not silent hangs.
Limitations
Being direct about what this does not cover:
- No Douyin posting or account management — this is read-only data access, not an integration with Douyin’s content management APIs
- No guaranteed SLA on upstream response times — typical latency is 1-5 seconds, but upstream fluctuations can occur
- No official Douyin authorization — this accesses public data through third-party infrastructure, not through Douyin’s official Open Platform
- Rate limiting exists — high-volume concurrent calls may be throttled; design agents for reasonable cadence
- Data freshness varies by endpoint — trending data is near-real-time; creator analytics may lag by hours
FAQ
How many Douyin operations does SandBase offer?
310 as of July 2026, across 10 functional channels covering search, creator analytics, trending indices, billboards, influencer marketplace (Xingtu), DOU+ promotion data, and app/web-level video data.
What does a typical Douyin API call cost?
79% of operations cost $0.001/call. The most expensive tier ($0.25) covers batch video fetches with full metadata. A daily monitoring agent tracking 10 accounts costs about $0.90/month.
Can I use this for competitor monitoring?
Yes. Combine user profile, video list, and video detail endpoints to track posting frequency, engagement trends, and content strategy changes. At $0.001/call this costs ~$0.03/day for 10 accounts.
Is this the same as Douyin’s official API?
No. Douyin’s official Open Platform requires OAuth user authorization, app review (2-8 weeks), and limits access to data the authorized user owns. SandBase’s Douyin operations access public data through third-party infrastructure — broader scope but without Douyin’s official endorsement.
What format do responses come back in?
Standard JSON objects. Field names are consistent across calls to the same endpoint. Schemas are predictable enough to build typed parsers for batch processing.
For context on how Douyin APIs compare with other social data approaches, see our social media data API guide.
Getting started
If you already have a SandBase API key, you can call any Douyin operation right now:
# Check what's trending
curl -X POST https://api.sandbase.ai/v1/run \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "douyin/billboard/hot-account-list"}'
The full list of 310 operations is available in the model catalog.
Have a complementary data source for the Douyin ecosystem? Reach out — the ecosystem is always growing.


