TikTok

Live Room

per_call

Checks whether a TikTok creator is currently live and returns room ID, title, start time, current and peak viewer counts, and stream cover art. Useful for live-commerce monitoring and alerting when a tracked creator goes on air.

Endpoint

GET /v1/tiktok/live-room

Price

$1.50

per 1,000 calls · $0.0015 per call

Cost per call

1 credit

Failed calls never charged

Parameters

target

required

string

The TikTok handle, URL or identifier to resolve.

limit

optional

integer

Items to return for list responses. Default 10, max 100.

cursor

optional

string

Pagination cursor returned by a previous response.

Example request

Sandbox calls return deterministic sample data in the live payload shape.

curl

curl "https://api.fastfetchz.com/v1/tiktok/live-room?target=nasa" \
  -H "X-API-Key: $FASTFETCHZ_KEY"

Example response

200 application/json

{
  "success": true,
  "service": {
    "platform": "TikTok",
    "name": "Live Room",
    "slug": "live-room"
  },
  "credits_charged": 1,
  "credits_remaining": 99,
  "latency_ms": 214,
  "data": {
    "items": [
      {
        "id": "7000345014",
        "shortcode": "S7E7Q",
        "url": "https://example.com/tiktok/nasa/345014",
        "caption": "Sandbox live room item #1 for @nasa.",
        "media_type": "image",
        "like_count": 25214,
        "comment_count": 319,
        "view_count": 346014,
        "duration_sec": 56,
        "taken_at": "2026-08-24T10:37:49.162Z"
      },
      {
        "id": "7000323451",
        "shortcode": "S6XKR",
        "url": "https://example.com/tiktok/nasa/323451",
        "caption": "Sandbox live room item #2 for @nasa.",
        "media_type": "image",
        "like_count": 3651,
        "comment_count": 356,
        "view_count": 324451,
        "duration_sec": 93,
        "taken_at": "2026-08-23T10:37:49.162Z"
      }
    ],
    "paging": {
      "has_more": true,
      "next_cursor": "cursor_40643"
    }
  }
}

Error codes

StatusCodeMeaning

401invalid_api_keyMissing or unrecognized X-API-Key header. No credits are charged.

402insufficient_creditsYour balance is below the cost of the call. Top up to continue.

403account_suspended / key_revokedThe account is suspended or the key was revoked.

429rate_limitedThe key exceeded its monthly cap or the burst limit. Retry later.

500upstream_errorUnexpected failure while fulfilling the request. Not charged.