# TikTok Room Active Status Batch Check API

> Checks whether multiple TikTok broadcast rooms are currently active. Accepts a comma-separated list of room identifiers to return current status details.

Source: https://www.sandbase.ai/apis/tiktok/web/batch-check-live-alive
API reference: https://www.sandbase.ai/apis/tiktok/web/batch-check-live-alive/docs

## Facts

- Provider: TikTok
- Type: Data API
- Endpoint: `POST https://api.sandbase.ai/v1/api/tiktok/web/batch-check-live-alive`
- Price: $0.07 per call
- Capabilities: api, tiktok
- Billing: pay per use from one SandBase balance; no provider account or subscription needed

## Call it

`POST https://api.sandbase.ai/v1/api/tiktok/web/batch-check-live-alive` with `Authorization: Bearer $SANDBASE_API_KEY` and the parameters as a JSON body.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `room_ids` | string | yes |  |

## FAQ

### How do I use the TikTok Room Active Status Batch Check API?

Send a POST request to https://api.sandbase.ai/v1/api/tiktok/web/batch-check-live-alive 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 Active Status Batch Check API cost?

$0.07 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

### What parameters does the TikTok Room Active Status Batch Check API accept?

Required: room_ids (string). The Parameters table and the Playground on this page list every field.

### What does the TikTok Room Active Status Batch Check 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 Active Status Batch Check 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.

## README

### TikTok Room Active Status Batch Check API

Inspect the active broadcast status across multiple TikTok streams using `room_ids`. Pass a comma-separated list of room identifiers to inspect stream availability.

#### Use cases

- Monitor multiple TikTok broadcast rooms simultaneously for real-time stream status.
- Track when target creators begin broadcasting across a watchlist of room identifiers.
- Filter inactive broadcast rooms from automated monitoring dashboards.

#### Request

```bash
curl -X POST "https://api.sandbase.ai/v1/api/tiktok/web/batch-check-live-alive" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"room_ids": "<room_ids>"}'
```

#### Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `room_ids` | string | Yes | Live room ID list separated by commas, e.g.: 7530611486784277278,7530633767468288782 |

#### Notes

- Pass multiple room identifiers formatted as a comma-separated string in `room_ids`.

#### Related APIs

- [TikTok Video IDs from URLs (Batch)](/model/tiktok/web/all-aweme-id): Resolves and extracts TikTok video IDs from a list of video URLs.
- [TikTok User Sec User ID Extractor](/model/tiktok/web/all-sec-user-id): Returns a list of sec_user_id identifiers corresponding to TikTok user profile URLs.
- [TikTok Profile Unique IDs](/model/tiktok/web/all-unique-id): Resolves a batch of TikTok user homepage links to retrieve their corresponding unique identifiers.