SerpBase

Google Videos Search — API 레퍼런스

POST
사용 가능
/google/videos/search

동영상 검색

Google 동영상 목록을 검색합니다. 동영상 다운로드나 워터마크 제거 서비스가 아닙니다.

type
videos
result
videos
과금
1 credits

Google 동영상 목록을 검색합니다. 동영상 다운로드나 워터마크 제거 서비스가 아닙니다.

파라미터
q
필수
string

필수

검색 쿼리 문자열입니다.

hl
선택
string

선택

언어 코드입니다. 기본값은 en입니다.

gl
선택
string

선택

국가 코드입니다. 기본값은 us입니다.

page
선택
number

선택

1부터 시작하는 페이지 번호입니다. 기본값은 1입니다.

query
예시
string

카탈로그 예시. 필수 필드는 API가 검증합니다.

예시: "how espresso machines work"

json
{
  "query": "how espresso machines work"
}
Playground에서 실행
응답 필드
query
필수
string

필수

요청에서 정규화된 쿼리입니다.

page
필수
number

필수

현재 페이지 번호입니다. 1부터 시작합니다.

videos
선택
VideoResult[]

동영상 결과가 파싱된 경우.

Google 동영상 검색 결과.

VideoResult 결과 항목 구조
rank
필수
number

필수

이 응답 안에서 1부터 시작하는 순위입니다.

position
선택
number

제공되는 경우 rank의 별칭입니다.

position 필드를 기대하는 클라이언트용 정규화 순위입니다.

title
필수
string

필수

결과 제목입니다.

link
필수
string

필수

파서가 반환하는 기본 링크입니다.

url
선택
string

결과 링크를 정규화할 수 있을 때 반환됩니다.

정규화된 대상 URL이며 보통 link와 같습니다.

source_url
선택
string

Google 리다이렉트/원본 URL이 관측된 경우에만 반환됩니다.

디버깅과 출처 확인을 위해 보존되는 원본 Google URL입니다.

display_url
선택
string

Google 표시 텍스트나 도메인을 추출할 수 있을 때 반환됩니다.

표시 URL 또는 출처 도메인입니다.

source
선택
string

출처/채널을 파싱할 수 있는 경우.

동영상 출처 또는 채널 라벨.

duration
선택
string

결과 텍스트에 길이가 있는 경우.

동영상 길이 텍스트.

time
선택
string

게시 시간을 파싱할 수 있는 경우.

게시 시간 원문.

published_at
선택
string

파싱된 시간이 있으면 해당 별칭.

정규화된 게시 시간 별칭.

thumbnail_url
선택
string

Google이 썸네일을 제공할 때 반환됩니다.

썸네일 URL입니다.

thumbnail
선택
string

제공되는 경우 thumbnail_url의 별칭입니다.

정규화된 썸네일 별칭입니다.

코드 및 응답 예시
bash
curl -X POST 'https://api.serpbase.dev/google/videos/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"query":"how espresso machines work"}'
기존 Google 요청 예시
bash
curl -X POST https://api.serpbase.dev/google/videos/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "python asyncio tutorial",
    "hl": "en",
    "gl": "us",
    "page": 1
  }'
참고

동영상 검색, 튜토리얼 탐색, 미디어 모니터링.

전용 동영상 카드가 없으면 호환 Google 레이아웃에서 뉴스 형식 추출을 사용합니다.