YouTube API 문서

YouTube API: 재생목록 — 사용자 식별자로

동기화, 보관, 모니터링을 위해 YouTube의 재생목록 페이지 컬렉션을 불러오세요.

항목 순서와 다음 페이지에서의 재개가 중요한 반복 수집 워크플로에 "사용자 식별자로"을 사용하세요.

메서드 GET
엔터티 재생목록
버전 2
이 엔드포인트가 하는 일

이 API 메서드로 만들 수 있는 것

먼저 결과와 일반적인 워크플로를 확인한 다음 매개변수와 작동하는 요청 예제로 넘어가세요.

이 엔드포인트가 도움이 되는 일

응답에는 재생목록 컬렉션, 각 항목의 컨텍스트, 다음 페이지 커서가 포함됩니다.

적합한 사용 시점

항목 순서와 다음 페이지에서의 재개가 중요한 반복 수집 워크플로에 "사용자 식별자로"을 사용하세요.

주요 사용 사례

데이터 동기화

새 YouTube 항목을 내부 저장소로 계속 전송하세요.

보관

사용 가능한 공개 컬렉션을 저장해 나중에 검색하고 처리하세요.

반복 모니터링

마지막 페이지부터 재개하여 새로 나타나는 객체를 감지하세요.

사용 가능한 버전

응답 버전

두 버전 모두 같은 작업을 해결하며 같은 매개변수를 받습니다. 전환기로 응답 구조를 비교하고 클라이언트가 기대하는 버전을 선택하세요.

응답 버전 V2

이 페이지에서 버전을 전환하면 같은 문서 URL에서 응답 구조를 비교할 수 있습니다.

동일하게 유지되는 것

인증, 필수 매개변수, 요청 형태는 V1과 V2에서 같습니다. 실제로는 엔드포인트 경로를 구성할 때와 응답을 읽을 때 버전을 선택합니다.

버전 간에 달라지는 것

주요 차이는 응답 봉투입니다. 새 연동에는 V2를 사용하고, 기존 클라이언트 계약과의 호환성이 필요한 경우에만 V1을 유지하세요.

사용 방법

메서드 호출 방법

두 버전 모두 같은 API 키 헤더와 같은 쿼리 매개변수를 사용합니다. 이 문서는 먼저 공통 매개변수를 보여 준 다음 각 버전의 경로와 코드 스니펫을 보여 줍니다.

입력 매개변수

공통 매개변수
매개변수 필수 유형 예시 설명
user_identifier 예 str mkbhd YouTube channel handle, username, or channel identifier. Example: mkbhd.
cursor 아니요 str | None cursor-next-page 이전 응답에서 받은 다음 페이지 커서. 첫 페이지에서는 생략합니다.

버전별 요청 경로

V2

정확한 엔드포인트 경로, 예시 URL, 코드 스니펫을 복사할 때 버전을 선택하세요. 위의 매개변수 목록은 바뀌지 않습니다.

GET /api/v2/youtube.com/playlist/by-user-identifier

정규화된 형식

코드 예제

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/youtube.com/playlist/by-user-identifier" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'user_identifier=mkbhd' \
  # Optional parameters:
  # --data-urlencode 'cursor=cursor-next-page'
응답 예시

버전별 실제 응답

미리보기에는 주요 필드와 컬렉션의 첫 항목이 포함되어 있어 응답 형태를 빠르게 확인할 수 있습니다. 버전을 바꾸면 JSON 형식이 바뀝니다.

응답 예시

V2 응답 JSON

검증된 예시

이 간결한 JSON 예시는 V2의 최근 성공한 검증 실행에서 가져왔습니다.

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": null,
    "has_more": false
  },
  "search_context": {
    "user_identifier": "mkbhd"
  },
  "data": {
    "playlists": {
      "count": 23,
      "items": [
        {
          "url": "https://www.youtube.com/playlist?list=PLBsP89CPrMeNIuvr9j3_EQaMwaNJ6rhuQ",
          "playlist_id": "PLBsP89CPrMeNIuvr9j3_EQaMwaNJ6rhuQ",
          "title": "Retro Tech S2",
          "playlist_type": "series",
          "video_count": 5,
          "content_count_text": "5 episodes",
          "first_video_id": "ifI_fwg55k8",
          "first_video_url": "https://www.youtube.com/watch?v=ifI_fwg55k8&list=PLBsP89CPrMeNIuvr9j3_EQaMwaNJ6rhuQ",
          "thumbnail_url": "https://example.com/image.jpg",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/ifI_fwg55k8/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLB60CMX6sapZh-Ie9FtxWJza9a9QA",
              "width": 480,
              "height": 270
            }
          ]
        },
        {
          "url": "https://www.youtube.com/playlist?list=PLBsP89CPrMeO7uztAu6YxSB10cRMpjgiY",
          "playlist_id": "PLBsP89CPrMeO7uztAu6YxSB10cRMpjgiY",
          "title": "Retro Tech",
          "playlist_type": "series",
          "video_count": 11,
          "content_count_text": "11 episodes",
          "first_video_id": "kMtN9KJHn5Y",
          "first_video_url": "https://www.youtube.com/watch?v=kMtN9KJHn5Y&list=PLBsP89CPrMeO7uztAu6YxSB10cRMpjgiY",
          "thumbnail_url": "https://example.com/image.jpg",
          "thumbnails": [
            {
              "url": "https://i.ytimg.com/vi/kMtN9KJHn5Y/hqdefault.jpg?sqp=-oaymwEXCOADEI4CSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLC0TNdLeMkXHV1ZDh1TcFSCFIhhgw",
              "width": 480,
              "height": 270
            }
          ]
        },
        {
          "_more_items": 21
        }
      ]
    }
  }
}
다음 단계

평가 계속하기

이 문서를 첫 판단 기준으로 삼고, 반복 사용을 위해 엔드포인트를 연결하기 전에 요금, 플랫폼 지원 범위, 연동 규칙을 확인하세요.

YouTube 플랫폼 페이지 열기

구현 전에 관련 엔터티, API 메서드 그룹, 관련 문서를 비교하세요.

플랫폼 페이지 열기

API 메서드 요금 비교

사용량을 늘리기 전에 공개 요금표에서 이 메서드의 위치를 확인하세요.

요금 보기

연동 규칙 확인

시작 문서에서 인증, 버전, 재시도, 테스트와 운영의 차이를 확인하세요.

문서 열기
자주 묻는 질문

팀이 구현 전에 묻는 질문

이 답변을 참고하여 이 API 메서드가 워크플로, 버전 선택, 도입 계획에 맞는지 판단하세요.

이 YouTube API 메서드는 어떤 데이터를 반환하나요?

이 메서드는 재생목록에 대해 "사용자 식별자로"을 실행합니다. 아래의 간결한 응답 예시에서 필드의 정확한 구조를 확인할 수 있습니다.

V1과 V2 중 무엇을 선택해야 하나요?

새 연동에는 정규화된 구조를 제공하는 V2를 선택하세요. V1은 이미 플랫폼 고유 형식을 처리하는 클라이언트와의 호환성을 위해서만 사용하세요.

첫 요청에는 무엇이 필요한가요?

API 키를 만들어 요청 헤더에 넣고 표의 필수 매개변수를 입력하세요. 코드 예제에는 이미 올바른 경로와 요청 구조가 포함되어 있습니다.