Search YouTube videos by keyword
youtube.youtube.search.videosSearch YouTube videos by keyword
- Price
- freeZum Anbieterpreis
- Success rate
- 100 %Last 30 days · 2.373 calls
- Latency p50
- 332 msp95 596 ms
- Last verified
- 28.07.2026Verified working
GEThttps://toolswitch.dev/v1/tools/youtube.youtube.search.videos?q=design+tutorial&part=snippet&type=video&maxResults=2Preview- Uses platform quota
- Synchronous response
- Reads public data
Parameter
search results carry NO statistics — pass the returned video ids to youtube.video.detail for view/like counts
| Parameter | Typ | Erforderlich | Beschreibung | Beispiel |
|---|---|---|---|---|
| Abfrageparameter | ||||
q | Zeichenkette | Erforderlich | coffee | |
part | Zeichenkette | Erforderlich | snippet | |
type | Zeichenkette | Optional | video | channel | playlist; omit to mix all three | video |
order | Zeichenkette | Optional | relevance (default) | date | viewCount | rating | title | |
maxResults | Ganzzahl | Optional | 1–50, default 5 | 10 |
regionCode | Zeichenkette | Optional | ISO 3166-1 alpha-2 | US |
publishedAfter | Zeichenkette | Optional | RFC 3339 timestamp | 2026-01-01T00:00:00Z |
- Abfrageparameter
qZeichenketteErforderlichBeispiel:
coffeepartZeichenketteErforderlichBeispiel:
snippettypeZeichenketteOptionalvideo | channel | playlist; omit to mix all three
Beispiel:
videoorderZeichenketteOptionalrelevance (default) | date | viewCount | rating | title
maxResultsGanzzahlOptional1–50, default 5
Beispiel:
10regionCodeZeichenketteOptionalISO 3166-1 alpha-2
Beispiel:
USpublishedAfterZeichenketteOptionalRFC 3339 timestamp
Beispiel:
2026-01-01T00:00:00Z
Codebeispiele
Ersetze $TOOLSWITCH_KEY durch den in der Konsole erstellten Schlüssel.
Preview
curl -X GET 'https://toolswitch.dev/v1/tools/youtube.youtube.search.videos?q=design+tutorial&part=snippet&type=video&maxResults=2' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/youtube.youtube.search.videos?q=design+tutorial&part=snippet&type=video&maxResults=2",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/youtube.youtube.search.videos?q=design+tutorial&part=snippet&type=video&maxResults=2", {
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());Diese Gateway-API ist eine Vorschauversion; URL und Authentifizierung können sich ändern. Die Beispielparameter sind Musterdaten. Aufrufe werden mit free einschließlich Servicegebühr abgerechnet.