douyin/
live-room-detail

알고 있는 숫자형 room_id로 공개 Douyin 라이브 방송 하나를 조회하여 제목, 상태, 진행자 정보, 미디어, 공개된 시청자 수와 좋아요 수, 수집 시각을 반환합니다.

Douyin Live Room Detail API

알고 있는 방송 조회
진행자 정보
시청자 스냅샷
요청당 0.1 크레딧
준비됨
준비됨

매개변수를 입력하고 요청을 전송하세요. 작업 상태와 정규화된 결과가 여기에 표시됩니다.

README

SocQ 작성 · 업데이트

Douyin Live Room Detail

Douyin 라이브 방송은 제목, 현재 상태, 진행자 정보, 미디어, 공개된 시청자 수와 좋아요 수를 갖춘 공개 방송 세션입니다. 이러한 필드는 방송 카탈로그 정보 보강, 세션 상태 추적, 특정 시점 비교에 활용할 수 있습니다.

Douyin Live Room Detail API 주요 기능

  • 알고 있는 방송 상세 조회알고 있는 숫자형 room_id 하나를 원본 페이지네이션 없이 단일 원본 요청으로 처리해, 정규화된 live_room 레코드 최대 1건으로 변환합니다.
  • 방송·진행자 정보확인 가능한 방송 제목, 상태, 진행자 정보, 원본 URL, 수집 시각을 하나의 일관된 구조로 유지합니다.
  • 공개된 세션 스냅샷확인 가능한 시청자 수와 좋아요 수를 공개 미디어와 함께 수집해, 시각이 기록된 방송 상태를 확인합니다.

Douyin Live Room Detail API 매개변수

매개변수필수설명
room_id필수숫자로만 이루어진 Douyin 라이브 방송 식별자로, 필수 값입니다. 긴 식별자가 클라이언트에서 반올림되지 않도록 문자열로 보내세요.

Douyin Live Room Detail API 사용 방법

알고 있는 숫자형 방송 ID로 시작해 비동기 상세 조회 작업을 제출하고, 저장된 정규화된 결과를 읽습니다.

  1. 숫자형 식별자가 노출되는 라이브 방송 화면에서 room_id를 확인합니다. 이 엔드포인트는 방송 ID를 탐색하지 않습니다.
  2. 비어 있지 않은 숫자 전용 문자열로 식별자를 /v1/douyin/live-room-detail에 POST합니다.
  3. status가 succeeded 또는 failed가 될 때까지 /v1/tasks/{task_id}를 폴링합니다.
  4. /v1/tasks/{task_id}?limit=50에서 data.results.items를 읽습니다. 확인된 방송은 항목을 최대 1개 만들며, next_cursor는 SocQ에 저장된 결과의 페이지네이션에만 사용됩니다.
# Set DOUYIN_ROOM_ID to a known numeric room_id before sending.
curl -X POST "https://api.socq.ai/v1/douyin/live-room-detail" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"room_id\":\"${DOUYIN_ROOM_ID}\"}"

# Poll GET /v1/tasks/{task_id}, then read data.results.items from /v1/tasks/{task_id}?limit=50.

Douyin Live Room Detail API 추천 활용 사례

  • 라이브 방송 카탈로그 정보 보강: 방송 ID를 이미 저장한 카탈로그에 확인 가능한 제목, 상태, 진행자, 미디어, 공개 지표, 수집 시각을 추가합니다.
  • 세션 상태 스냅샷 추적: 따로 수집한 레코드를 collected_at과 함께 보관해, 특정 시점의 방송 상태와 시청자 관측값을 구분합니다.
  • 진행자·방송 정보 검토: 확인 가능한 진행자 정보를 방송 제목, 상태, 미디어, 공개된 세션 수치와 함께 하나의 정규화된 레코드로 검토합니다.

Douyin Live Room Detail API 활용 팁

  • 긴 식별자의 모든 자릿수가 유지되도록 room_id는 JavaScript 숫자가 아니라 따옴표로 감싼 숫자 전용 문자열로 제출하세요.
  • 이 요청은 라이브 방송 탐색이 아니라 상세 조회를 수행하므로, 엔드포인트를 호출하기 전에 알고 있는 room_id를 확보하세요.
  • 표준 라이브 방송 결과는 원본이 room_id를 id로 되돌려 준다고 보장하지 않으므로, 제출한 room_id를 자체 레코드에 보관하세요.
  • 원본이 개별 공개 필드를 생략할 수 있으므로 title, status, author, metrics, media, URL, 타임스탬프는 null일 수 있는 값으로 취급하세요.
  • results_limit이나 원본 커서를 보내지 마세요. next_cursor가 있더라도 공급자 요청이 아니라 저장된 SocQ 결과 항목을 페이지네이션합니다.

Douyin Live Room Detail API 외에 Douyin의 다른 유형의 공개 데이터가 필요할 때 이 API를 사용하세요.

다른 플랫폼 둘러보기

Douyin 데이터를 지원되는 다른 소셜 플랫폼의 공개 데이터와 함께 활용하세요.

Douyin Live Room Detail API — 자주 묻는 질문

Douyin Live Room Detail API는 숫자형 room_id로 알고 있는 공개 라이브 방송 하나를 조회합니다. 확인 가능한 방송, 진행자, 미디어, 시청자, 수집 시각 필드를 특정 시점의 정규화된 레코드로 반환합니다.

방송의 숫자형 식별자가 노출되는 공개 라이브 방송 화면을 이용하고, 이를 레코드와 함께 보관하세요. 이 엔드포인트는 라이브 방송을 검색하거나 방송 ID를 탐색하지 않습니다.

런타임 검증기는 숫자 전용 방송 ID 형식에 맞는 문자열을 요구합니다. 값을 텍스트로 유지하면 숫자형 클라이언트에서 긴 ID가 반올림되는 것도 막을 수 있습니다.

정규화된 레코드에는 title, status, author, URL, media, 공개된 viewers_count와 likes_count, created_at, collected_at이 포함될 수 있습니다. 선택적인 원본 필드는 null이거나 없을 수 있습니다.

아니요. 상세 조회 요청을 한 번 보내 정규화된 레코드를 최대 1건 만들며, 작업 결과의 next_cursor는 이미 저장된 SocQ 항목을 위한 표준 커서일 뿐입니다.

작업이 성공하면 고정 0.10 SocQ 크레딧이 차감됩니다. 결과 수나 페이지네이션 설정에 따라 요금이 달라지지 않습니다.