TikTok Room ID Resolver
https://api.sandbase.ai/v1/api/tiktok/web/live-room-idResolves a TikTok stream room ID from a given room URL. Supports both standard profile stream URLs and shortened links to obtain the unique room identifier.
- Price
- $0.0015USD / callFirst 100 calls per day free (shared per organization)
- Method
- POST
- Response
- JSON
- Parameters
- 1 required · 0 optional
Try the model
Playground
Your output will appear here
Complete the inputs, then click Run.
Model card
Specifications
Pricing
- Base price
- $0.0015 / run
- Daily free calls
- First 100 calls per day free (shared per organization)
Request & response
- Method
- POST
- Request body
- application/json
- Response
- application/json
- Execution
- sync
Parameters
- live_room_url
- string · required
Access
- Provider
- TikTok
- API
- Platform API
- Base URL
- https://api.sandbase.ai
- Endpoint
- /v1/api/tiktok/web/live-room-id
- Authentication
- Bearer API key
API README
TikTok Room ID Resolver API
Extracts the room ID from a TikTok broadcast link by passing the URL to live_room_url. Accepts both short links and standard web stream URLs.
Use cases
- Resolve short share URLs into direct room identifiers for downstream processing.
- Retrieve the room ID needed to query broadcast details or stream status.
- Parse stream links submitted by users into structured room identifiers.
Request
curl -X POST "https://api.sandbase.ai/v1/api/tiktok/web/live-room-id" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"live_room_url": "https://www.tiktok.com/@maksukaracun/live"}'
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
live_room_url | string | Yes | Live room link |
Notes
- Accepts short URLs (such as
vt.tiktok.comlinks) as well as standard profile broadcast links vialive_room_url.
Related APIs
- TikTok Video IDs from URLs (Batch): Resolves and extracts TikTok video IDs from a list of video URLs.
- TikTok User Sec User ID Extractor: Returns a list of sec_user_id identifiers corresponding to TikTok user profile URLs.
- TikTok Profile Unique IDs: Resolves a batch of TikTok user homepage links to retrieve their corresponding unique identifiers.
Start building
Send your first request
Platform API endpoint with unified authentication and usage tracking.
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
-X POST "https://api.sandbase.ai/v1/api/tiktok/web/live-room-id" \
-H "Authorization: Bearer $SANDBASE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'SANDBASE_JSON'
{
"live_room_url": "https://www.tiktok.com/@maksukaracun/live"
}
SANDBASE_JSON
)
printf '%s\n' "$result"Explore more
Related APIs
| API | Price | Response | Released |
|---|---|---|---|
TikTok Room ID ResolverThis API TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.0015 per call | JSON | Jul 31, 2026 |
TikTok | $0.07 per call | JSON | Jul 31, 2026 |
Questions
FAQ
How do I use the TikTok Room ID Resolver API?
Send a POST request to https://api.sandbase.ai/v1/api/tiktok/web/live-room-id with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.
How much does the TikTok Room ID Resolver API cost?
$0.0015 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.
What parameters does the TikTok Room ID Resolver API accept?
Required: live_room_url (string). The Parameters table and the Playground on this page list every field.
What does the TikTok Room ID Resolver API return?
A JSON response returned in the same HTTP request (synchronous).
Do I need a TikTok developer account or API key?
No. TikTok Room ID Resolver runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for TikTok API access separately.