# RetrieveRoomInfoFromHtml

`GET /webcast/anchors/{unique_id}/room_info/crawled`

Retrieve TikTok Live Room Information from the state the creator's LIVE page (`tiktok.com/@{unique_id}/live`) renders. `data.raw` is that page's `LiveRoom` state.

## Example (cURL)

```bash
curl -X GET "https://api.eulerstream.com/webcast/anchors/{unique_id}/room_info/crawled" \
  -H "x-api-key: YOUR_API_KEY"
```

## Path Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `unique_id` | string | Yes | The unique ID (handle) of the TikTok user. |

## Header Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `x-image-source` | enum(ORIGIN, CDN, CDN_CNAME) | No | Where returned image URLs are served from (ORIGIN, CDN, CDN_CNAME). |

## Responses

### 200 — Ok

**Content Type:** `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `code` | number | Yes |  |
| `message` | string | No |  |
| `ok` | boolean | Yes |  |
| `routes_attempted` | array of string | Yes |  |
| `source` | any | Yes | Which source produced `data`. `CACHE` means the room came from the cache; `ALERTS` means the live check answered offline and no room was fetched. |
| `data` | object | Yes |  |
| `detail` | string | No | The WAF solver's own error text, when TikTok served a challenge page that could not be solved. |

**`data`** child attributes:

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `unique_id` | string | Yes |  |
| `user` | object | No |  |
| `room_info` | object | No |  |
| `raw` | object | Yes |  |

**`user`** child attributes:

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `unique_id` | string | Yes |  |
| `avatar_url` | string | No |  |
| `nickname` | string | No |  |
| `sec_uid` | string | No |  |
| `numeric_uid` | string | No |  |
| `signature` | string | No |  |
| `is_verified` | boolean | No |  |
| `following` | number | No |  |
| `followers` | number | No |  |


**`room_info`** child attributes:

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `status` | number | No |  |
| `is_live` | boolean | No |  |
| `id` | string | No |  |
| `cover_url` | string | No |  |
| `title` | string | No |  |
| `start_time` | number | No |  |
| `stream_urls` | array of object | Yes | Every playback URL the room published. Always present, but empty for offline rooms and for live rooms TikTok served without stream metadata. |

**`stream_urls`** child attributes:

Array of:

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `url` | string | Yes | Direct playback URL. |
| `quality` | any | Yes | Best-known rendition. `UNKNOWN` when TikTok does not label it. |
| `type` | any | Yes | Playback protocol. |



**`raw`** child attributes:

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `_note` | string | Yes |  |




### 429 — Too Many Requests

**Content Type:** `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `code` | integer | Yes |  |
| `message` | string | Yes |  |


### 500 — Internal Server Error

**Content Type:** `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `code` | integer | Yes |  |
| `message` | string | Yes |  |


### 503 — Service Unavailable

**Content Type:** `application/json`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `code` | integer | Yes |  |
| `message` | string | Yes |  |

