유튜브

유튜브 API로 동영상 조회수와 정보 가져오는 방법!

파란하늘999 2025. 9. 10. 09:48

안녕하세요, 블로거 여러분! 유튜브 동영상의 조회수, 좋아요 수, 제목 같은 정보를 자동으로 가져오고 싶으신가요? YouTube Data API v3를 사용하면 공개된 동영상의 다양한 데이터를 쉽게 얻을 수 있습니다. 오늘은 초보자도 따라 할 수 있도록 설정 방법과 예제 코드를 정리해드릴게요! 😊


1. YouTube Data API로 무엇을 할 수 있나요?

YouTube Data API를 사용하면 다음과 같은 정보를 가져올 수 있습니다:

  • 영상 정보: 제목, 설명, 썸네일, 업로드 날짜
  • 통계: 조회수, 좋아요 수, 댓글 수
  • 검색: 특정 키워드로 영상 목록 가져오기
  • 채널 정보: 채널 이름, 구독자 수 등

공개된 동영상 데이터는 API 키만 있으면 누구나 조회 가능해요!


2. 시작하기: API 키 발급받기

API를 사용하려면 먼저 Google Cloud Console에서 API 키를 발급받아야 합니다. 아래 단계를 따라 해보세요:

  1. **Google Cloud Console**에 접속해 새 프로젝트를 만듭니다.
  2. 라이브러리 메뉴에서 "YouTube Data API v3"를 검색해 활성화합니다.
  3. 사용자 인증 정보 > API 키 만들기를 클릭해 API 키를 발급받습니다.
    • 중요: API 키는 비공개로 관리하세요!

이제 이 키를 사용해 유튜브 데이터를 가져올 수 있습니다. 🛠️


3. 동영상 조회수 가져오기

특정 영상의 조회수를 얻으려면 videos 엔드포인트를 사용합니다. 예를 들어, 유명한 Rick Astley의 "Never Gonna Give You Up" 영상 정보를 가져와볼게요.

API 요청 예시

text
 
GET https://www.googleapis.com/youtube/v3/videos?id=dQw4w9WgXcQ&key=여기에_당신의_API_키&part=snippet,statistics
  • id: 영상 ID (URL에서 v= 뒤에 나오는 부분, 예: dQw4w9WgXcQ)
  • key: 발급받은 API 키
  • part: snippet(제목, 설명 등), statistics(조회수, 좋아요 등)

응답 예시

json
 
{
  "items": [
    {
      "id": "dQw4w9WgXcQ",
      "snippet": {
        "title": "Rick Astley - Never Gonna Give You Up",
        "publishedAt": "2009-10-25T06:57:33Z",
        ...
      },
      "statistics": {
        "viewCount": "1500000000",
        "likeCount": "12000000",
        "commentCount": "500000"
      }
    }
  ]
}

이 JSON에서 statistics.viewCount가 조회수입니다!


4. 검색으로 원하는 영상 찾기

특정 키워드로 영상을 찾고 싶다면 search 엔드포인트를 사용하세요. 예를 들어, "펌킨 스파이스" 관련 영상을 찾는 요청은 이렇게 생겼습니다:

text
 
GET https://www.googleapis.com/youtube/v3/search?q=펌킨+스파이스&key=여기에_당신의_API_키&part=snippet&type=video&maxResults=10
  • q: 검색어 (예: 펌킨+스파이스)
  • maxResults: 최대 결과 수 (최대 50)

이 요청으로 영상 ID를 얻은 뒤, videos 엔드포인트로 조회수 같은 상세 정보를 추가로 가져올 수 있습니다.


5. Python으로 쉽게 구현하기

Python을 사용하면 API 요청이 더 간단해집니다. 아래는 특정 영상의 조회수를 가져오는 간단한 코드입니다:

python
 
import requests

API_KEY = "여기에_당신의_API_키"
VIDEO_ID = "dQw4w9WgXcQ"
url = f"https://www.googleapis.com/youtube/v3/videos?id={VIDEO_ID}&key={API_KEY}&part=statistics"

response = requests.get(url).json()
view_count = response["items"][0]["statistics"]["viewCount"]
print(f"조회수: {view_count}")

이 코드를 실행하면 선택한 영상의 조회수가 출력됩니다! 🎉


6. 주의할 점

  • 쿼터 제한: 무료 API는 하루 10,000 단위 쿼터가 있습니다. 요청이 많으면 제한에 걸릴 수 있으니 Google Cloud Console에서 사용량을 확인하세요.
  • 공개 데이터만 가능: 비공개 영상은 API 키로 접근할 수 없으며, OAuth 2.0 인증이 필요합니다.
  • API 키 보안: 소스 코드에 API 키를 직접 넣지 말고, 환경 변수로 관리하세요.

7. 더 알아보고 싶다면?


마무리

YouTube Data API를 사용하면 블로그 콘텐츠에 유튜브 영상의 조회수, 제목, 썸네일 등을 쉽게 추가할 수 있어요. 예를 들어, "펌킨 스파이스 레시피" 관련 영상을 분석해 블로그에 최신 트렌드를 반영해보면 어떨까요?

반응형