RoomScope

최종 업데이트

동영상

저장된 크리에이터의 동영상과 댓글.

모든 작업은 API key로 인증하며 (Authorization: Bearer <key>) 오류 응답은 다음 문서에서 설명하는 공통 오류 형식을 따릅니다: 오류. 이 페이지는 API의 OpenAPI 문서에서 생성되었습니다.

크리에이터의 동영상 목록 조회

GET/v1/creators/{uid}/videos

크리에이터에 대해 저장된 동영상, 최신순. 재생 수, 좋아요 수, 댓글 수가 포함됩니다.

스코프content:read크레딧캐시 조회

경로 파라미터

경로 파라미터 · GET /v1/creators/{uid}/videos
NameTypeDescription
uidRequired
string@를 제외한 크리에이터 핸들(linh.live) 또는 숫자로 된 TikTok 사용자 ID.

요청

curl "https://api.toktokdata.live/v1/creators/linh.live/videos" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

응답

200 OK
{  "data": {    "uniqueId": "linh.live",    "tiktokUserId": "990000000000000001",    "videos": [      {        "videoId": "7990000000000000001",        "tiktokUserId": "990000000000000001",        "uniqueId": "linh.live",        "description": "Video 1",        "createTime": "2026-10-31T10:51:44.935Z",        "coverUrl": null,        "durationSeconds": null,        "playCount": 10000,        "diggCount": 1000,        "commentCount": 100,        "shareCount": null,        "collectCount": null,        "firstSeenAt": "2026-11-01T10:51:45.590Z",        "lastRefreshedAt": "2026-11-01T10:36:44.935Z"      },      {        "videoId": "7990000000000000002",        "tiktokUserId": "990000000000000001",        "uniqueId": "linh.live",        "description": "Video 2",        "createTime": "2026-10-30T10:51:44.935Z",        "coverUrl": null,        "durationSeconds": null,        "playCount": 20000,        "diggCount": 2000,        "commentCount": 200,        "shareCount": null,        "collectCount": null,        "firstSeenAt": "2026-11-01T10:51:45.591Z",        "lastRefreshedAt": "2026-11-01T10:36:44.935Z"      }    ]  },  "provenance": {    "observedAt": "2026-11-01T10:36:44.935Z",    "freshness": "near_realtime",    "source": "public_creator_content",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "content-v1",    "window": null  }}

오류

  • 400 파라미터 또는 본문이 잘못되었습니다. code에 문제가 표시됩니다.
  • 401 API key가 없거나 알 수 없는 key입니다.
  • 402 워크스페이스의 크레딧 지갑으로 이 호출을 처리할 수 없습니다. resetAt에 크레딧이 초기화되는 시점이 나와 있습니다.
  • 403 key에 필요한 스코프가 없거나, 요금제에 해당 기능이 포함되어 있지 않습니다.
  • 429 요청 속도를 초과했습니다. Retry-After를 따르세요.

동영상 조회

GET/v1/videos/{video_id}

저장된 동영상 하나와 카운터.

스코프content:read크레딧캐시 조회

경로 파라미터

경로 파라미터 · GET /v1/videos/{video_id}
NameTypeDescription
video_idRequired
stringTikTok 동영상 ID.

요청

curl "https://api.toktokdata.live/v1/videos/7400000000000000001" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

응답

200 OK
{  "data": {    "video": {      "videoId": "7990000000000000001",      "tiktokUserId": "990000000000000001",      "uniqueId": "linh.live",      "description": "Video 1",      "createTime": "2026-10-31T10:51:44.935Z",      "coverUrl": null,      "durationSeconds": null,      "playCount": 10000,      "diggCount": 1000,      "commentCount": 100,      "shareCount": null,      "collectCount": null,      "firstSeenAt": "2026-11-01T10:51:45.590Z",      "lastRefreshedAt": "2026-11-01T10:36:44.935Z",      "history": []    }  },  "provenance": {    "observedAt": "2026-11-01T10:36:44.935Z",    "freshness": "near_realtime",    "source": "public_creator_content",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "content-v1",    "window": null  }}

오류

  • 400 파라미터 또는 본문이 잘못되었습니다. code에 문제가 표시됩니다.
  • 401 API key가 없거나 알 수 없는 key입니다.
  • 402 워크스페이스의 크레딧 지갑으로 이 호출을 처리할 수 없습니다. resetAt에 크레딧이 초기화되는 시점이 나와 있습니다.
  • 403 key에 필요한 스코프가 없거나, 요금제에 해당 기능이 포함되어 있지 않습니다.
  • 429 요청 속도를 초과했습니다. Retry-After를 따르세요.

동영상의 댓글 목록 조회

GET/v1/videos/{video_id}/comments

저장된 댓글. 특정 댓글의 답글을 보려면 parentCommentId를 전달하세요.

스코프content:read크레딧캐시 조회

경로 파라미터

경로 파라미터 · GET /v1/videos/{video_id}/comments
NameTypeDescription
video_idRequired
stringTikTok 동영상 ID.

쿼리 파라미터

쿼리 파라미터 · GET /v1/videos/{video_id}/comments
NameTypeDescription
parentCommentIdOptional
string이 댓글의 답글을 반환합니다.
cursorOptional
string이전 페이지의 nextCursor에서 받은 불투명 커서.
limitOptional
integer페이지당 댓글 수.

요청

curl "https://api.toktokdata.live/v1/videos/7400000000000000001/comments" \  -H "Authorization: Bearer $ROOMSCOPE_API_KEY"

응답

200 OK
{  "data": {    "videoId": "7400000000000000001",    "parentCommentId": null,    "comments": [      {        "commentId": "7400000000000100001",        "text": "See you at 9pm!",        "diggCount": 42,        "replyCount": 3,        "createTime": "2026-10-31T13:05:00Z",        "authorUniqueId": "fan.one"      }    ],    "nextCursor": null,    "hasMore": false  },  "provenance": {    "observedAt": "2026-11-01T10:36:44.935Z",    "freshness": "near_realtime",    "source": "public_video_comments",    "sourceKind": "derived",    "coverageStatus": "observed",    "methodologyVersion": "comments-v1",    "window": null  }}

오류

  • 400 파라미터 또는 본문이 잘못되었습니다. code에 문제가 표시됩니다.
  • 401 API key가 없거나 알 수 없는 key입니다.
  • 402 워크스페이스의 크레딧 지갑으로 이 호출을 처리할 수 없습니다. resetAt에 크레딧이 초기화되는 시점이 나와 있습니다.
  • 403 key에 필요한 스코프가 없거나, 요금제에 해당 기능이 포함되어 있지 않습니다.
  • 429 요청 속도를 초과했습니다. Retry-After를 따르세요.
이 페이지가 도움이 되었나요?