Search YouTube by keyword

justoneapi.x.youtube-search-v1

Search YouTube by keyword with optional type, upload-date, duration, feature, and sort filters, or continue with a token.

Price: $0.01476/success제공업체 원가
Success rate: 99.8%Last 30 days · 1,741 calls
Latency p50: 2.5 sp95 3.9 s
Last verified: 2026. 7. 28.Verified working

GEThttps://toolswitch.dev/v1/tools/justoneapi.x.youtube-search-v1?keyword=coffeePreview

Try online출시 예정Provider docs ↗

Uses platform quota
Synchronous response
Reads public data

파라미터

파라미터	유형	필수	설명
쿼리 파라미터
`type`	문자열	선택	Filter results by result type. Available Values: - `video`: Video results - `channel`: Channel results - `playlist`: Playlist results - `movie`: Movie results One of: video, channel, playlist, movie.
`sortBy`	문자열	선택	Sort order for search results. Available Values: - `relevance`: Sort by relevance - `upload_date`: Sort by upload date - `view_count`: Sort by view count - `rating`: Sort by rating One of: relevance, upload_date, view_count, rating.
`keyword`	문자열	선택	Search keyword. Required on the first request; leave empty when using a continuation token.
`duration`	문자열	선택	Filter video results by duration. Supported request values: short, medium, long. Available Values: - `SHORT`: Short videos under 4 minutes - `MEDIUM`: Medium videos from 4 to 20 minutes - `LONG`: Long videos over 20 minutes One of: SHORT, MEDIUM, LONG.
`features`	문자열	선택	Feature filters separated by commas. Supported values: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr. One of: live, FOUR_K, hd, subtitles, creative_commons, THREE_SIXTY, vr180, THREE_D, hdr.
`uploadDate`	문자열	선택	Filter results by upload date. Available Values: - `last_hour`: Uploaded within the last hour - `today`: Uploaded today - `this_week`: Uploaded this week - `this_month`: Uploaded this month - `this_year`: Uploaded this year One of: last_hour, today, this_week, this_month, this_year.
`continuationToken`	문자열	선택	Pagination token returned by the previous response.

쿼리 파라미터
type문자열선택
Filter results by result type. Available Values: - `video`: Video results - `channel`: Channel results - `playlist`: Playlist results - `movie`: Movie results One of: video, channel, playlist, movie.
sortBy문자열선택
Sort order for search results. Available Values: - `relevance`: Sort by relevance - `upload_date`: Sort by upload date - `view_count`: Sort by view count - `rating`: Sort by rating One of: relevance, upload_date, view_count, rating.
keyword문자열선택
Search keyword. Required on the first request; leave empty when using a continuation token.
duration문자열선택
Filter video results by duration. Supported request values: short, medium, long. Available Values: - `SHORT`: Short videos under 4 minutes - `MEDIUM`: Medium videos from 4 to 20 minutes - `LONG`: Long videos over 20 minutes One of: SHORT, MEDIUM, LONG.
features문자열선택
Feature filters separated by commas. Supported values: live, 4k, hd, subtitles, creative_commons, 360, vr180, 3d, hdr. One of: live, FOUR_K, hd, subtitles, creative_commons, THREE_SIXTY, vr180, THREE_D, hdr.
uploadDate문자열선택
Filter results by upload date. Available Values: - `last_hour`: Uploaded within the last hour - `today`: Uploaded today - `this_week`: Uploaded this week - `this_month`: Uploaded this month - `this_year`: Uploaded this year One of: last_hour, today, this_week, this_month, this_year.
continuationToken문자열선택
Pagination token returned by the previous response.

코드 예제

$TOOLSWITCH_KEY를 콘솔에서 생성한 키로 바꾸세요.

Preview

curl -X GET 'https://toolswitch.dev/v1/tools/justoneapi.x.youtube-search-v1?keyword=coffee' \
  -H "X-Toolswitch-Key: $TOOLSWITCH_KEY"

import os
import requests

response = requests.request(
    "GET",
    "https://toolswitch.dev/v1/tools/justoneapi.x.youtube-search-v1?keyword=coffee",
    headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)

const response = await fetch("https://toolswitch.dev/v1/tools/justoneapi.x.youtube-search-v1?keyword=coffee", {
  method: "GET",
  headers: {
    "X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
  },
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());

게이트웨이 API는 미리보기 버전이며 URL과 인증 방식이 변경될 수 있습니다. 예제 매개변수는 샘플 데이터입니다. 호출 요금은 $0.01476/success이며 서비스 수수료가 포함되어 있습니다.