Finden Sie Suche-Daten auf YouTube anhand einer Nutzeranfrage und binden Sie die Ergebnisse an Such-, Katalog- oder Rechercheoberflächen an.
Nutzen Sie „Movies By Country“, wenn Sie die genaue Objekt-ID nicht kennen und zuerst relevante Kandidaten finden müssen.
Prüfen Sie zuerst das Ergebnis und die typischen Abläufe und gehen Sie dann zu den Parametern und einem funktionierenden Anfragebeispiel über.
Die Antwort enthält passende Suche, öffentlichen Kontext und Paginierungsdaten, wenn weitere Ergebnisse vorhanden sind.
Nutzen Sie „Movies By Country“, wenn Sie die genaue Objekt-ID nicht kennen und zuerst relevante Kandidaten finden müssen.
Ergänzen Sie Kunden- und interne Oberflächen um die Suche in YouTube-Daten.
Finden Sie Kandidaten per Anfrage und speichern Sie relevante Objekte für die spätere Anreicherung.
Sammeln Sie Ergebnissätze für Analysen von Themen, Creatorn und Wettbewerb.
Beide Versionen lösen dieselbe Aufgabe und akzeptieren dieselben Parameter. Vergleichen Sie mit dem Umschalter die Antwortstruktur und wählen Sie die Version, die Ihr Client erwartet.
Wechseln Sie auf dieser Seite die Version, um die Antwortstrukturen unter derselben Dokumentations-URL zu vergleichen.
Authentifizierung, Pflichtparameter und Anfrageform sind in V1 und V2 identisch. In der Praxis wählen Sie die Version beim Aufbau des Endpunktpfads und bei der Auswertung der Antwort.
Der Hauptunterschied liegt in der Antwort-Hülle. Verwenden Sie V2 für neue Integrationen und behalten Sie V1 nur, wenn Sie Kompatibilität mit einem bestehenden Client-Vertrag benötigen.
Verwenden Sie in beiden Versionen denselben API-Schlüssel-Header und dieselben Query-Parameter. Diese Dokumentation zeigt zuerst den gemeinsamen Parametersatz und danach die Pfade und Codeausschnitte jeder Version.
| Parameter | Pflicht | Typ | Beispiel | Beschreibung |
|---|---|---|---|---|
country_code |
Ja | str |
US |
Two-letter ISO 3166-1 alpha-2 country code used for YouTube localization. Example: US. |
query |
Ja | str |
technology review |
Vom Nutzer eingegebene Suchanfrage. |
cursor |
Nein | str | None |
cursor-next-page |
Cursor der nächsten Seite aus der vorherigen Antwort. Für die erste Seite weglassen. |
Wählen Sie eine Version, wenn Sie den genauen Endpunktpfad, die Beispiel-URL und den Codeausschnitt kopieren. Die Parameterliste oben ändert sich nicht.
GET /api/v2/youtube.com/search/movies-by-countrycurl --request GET \
--url "https://www.scrapestorm.net/api/v2/youtube.com/search/movies-by-country" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'country_code=US' \
--get --data-urlencode 'query=technology review' \
# Optional parameters:
# --data-urlencode 'cursor=cursor-next-page'from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/youtube.com/search/movies-by-country"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"country_code": "US",
"query": "technology review",
}
# Optional parameters
# params["cursor"] = "cursor-next-page"
with requests.Session() as session:
response = session.request(
method="GET",
url=urljoin(BASE_URL, ENDPOINT),
headers=HEADERS,
params=params,
timeout=30,
)
response.raise_for_status()
payload = response.json()
print(payload)const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/youtube.com/search/movies-by-country";
const params = new URLSearchParams({
country_code: "US",
query: "technology review",
});
// Optional parameters
// params.set("cursor", "cursor-next-page");
const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
method: "GET",
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
if (!response.ok) {
throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}
const payload = await response.json();
console.log(payload);import axios from "axios";
const client = axios.create({
baseURL: "https://www.scrapestorm.net",
timeout: 30000,
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
const params = {
country_code: "US",
query: "technology review",
};
// Optional parameters
// params.cursor = "cursor-next-page";
const { data: payload } = await client.request({
method: "GET",
url: endpoint,
params,
});
console.log(payload);<?php
declare(strict_types=1);
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;
$client = new Client([
'base_uri' => "https://www.scrapestorm.net",
'timeout' => 30.0,
'headers' => [
'Accept' => 'application/json',
'X-API-Key' => "00000000-0000-4000-8000-000000000000",
],
]);
$query = [
"country_code" => "US",
"query" => "technology review",
];
// Optional parameters
// $query["cursor"] = "cursor-next-page";
try {
$response = $client->request("GET", "/api/v2/youtube.com/search/movies-by-country", [
'query' => $query,
]);
$payload = json_decode(
(string) $response->getBody(),
true,
512,
JSON_THROW_ON_ERROR
);
var_dump($payload);
} catch (GuzzleException $e) {
throw $e;
}package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
"time"
)
func main() {
baseURL := "https://www.scrapestorm.net"
endpoint := "/api/v2/youtube.com/search/movies-by-country"
params := url.Values{}
params.Set("country_code", "US")
params.Set("query", "technology review")
// Optional parameters
// params.Set("cursor", "cursor-next-page")
req, err := http.NewRequest(
"GET",
fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
nil,
)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/json")
req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")
client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var payload any
if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
panic(err)
}
fmt.Printf("%+v\n", payload)
}Wählen Sie eine Version, wenn Sie den genauen Endpunktpfad, die Beispiel-URL und den Codeausschnitt kopieren. Die Parameterliste oben ändert sich nicht.
GET /api/v1/youtube.com/search/movies-by-countrycurl --request GET \
--url "https://www.scrapestorm.net/api/v1/youtube.com/search/movies-by-country" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'country_code=US' \
--get --data-urlencode 'query=technology review' \
# Optional parameters:
# --data-urlencode 'cursor=cursor-next-page'from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/youtube.com/search/movies-by-country"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"country_code": "US",
"query": "technology review",
}
# Optional parameters
# params["cursor"] = "cursor-next-page"
with requests.Session() as session:
response = session.request(
method="GET",
url=urljoin(BASE_URL, ENDPOINT),
headers=HEADERS,
params=params,
timeout=30,
)
response.raise_for_status()
payload = response.json()
print(payload)const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v1/youtube.com/search/movies-by-country";
const params = new URLSearchParams({
country_code: "US",
query: "technology review",
});
// Optional parameters
// params.set("cursor", "cursor-next-page");
const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
method: "GET",
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
if (!response.ok) {
throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}
const payload = await response.json();
console.log(payload);import axios from "axios";
const client = axios.create({
baseURL: "https://www.scrapestorm.net",
timeout: 30000,
headers: {
Accept: "application/json",
"X-API-Key": "00000000-0000-4000-8000-000000000000",
},
});
const params = {
country_code: "US",
query: "technology review",
};
// Optional parameters
// params.cursor = "cursor-next-page";
const { data: payload } = await client.request({
method: "GET",
url: endpoint,
params,
});
console.log(payload);<?php
declare(strict_types=1);
use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;
$client = new Client([
'base_uri' => "https://www.scrapestorm.net",
'timeout' => 30.0,
'headers' => [
'Accept' => 'application/json',
'X-API-Key' => "00000000-0000-4000-8000-000000000000",
],
]);
$query = [
"country_code" => "US",
"query" => "technology review",
];
// Optional parameters
// $query["cursor"] = "cursor-next-page";
try {
$response = $client->request("GET", "/api/v1/youtube.com/search/movies-by-country", [
'query' => $query,
]);
$payload = json_decode(
(string) $response->getBody(),
true,
512,
JSON_THROW_ON_ERROR
);
var_dump($payload);
} catch (GuzzleException $e) {
throw $e;
}package main
import (
"encoding/json"
"fmt"
"net/http"
"net/url"
"time"
)
func main() {
baseURL := "https://www.scrapestorm.net"
endpoint := "/api/v1/youtube.com/search/movies-by-country"
params := url.Values{}
params.Set("country_code", "US")
params.Set("query", "technology review")
// Optional parameters
// params.Set("cursor", "cursor-next-page")
req, err := http.NewRequest(
"GET",
fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
nil,
)
if err != nil {
panic(err)
}
req.Header.Set("Accept", "application/json")
req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")
client := &http.Client{Timeout: 30 * time.Second}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
var payload any
if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
panic(err)
}
fmt.Printf("%+v\n", payload)
}Die Vorschau enthält die wichtigsten Felder und die ersten Elemente der Sammlung, damit Sie die Form der Antwort schnell prüfen können. Beim Wechsel der Version ändert sich das JSON-Format.
Dieses kompakte JSON-Beispiel stammt aus dem letzten erfolgreichen Verifizierungslauf von V2.
{
"success": true,
"status": "ok",
"pagination": {
"cursor": "QVFB...",
"has_more": true
},
"search_context": {
"query": "technology review",
"country_code": "US"
},
"data": {
"videos": {
"count": 20,
"items": [
{
"author": {
"url": null,
"channel_id": null,
"username": null,
"display_name": "YouTube Movies & TV"
},
"url": "https://www.youtube.com/watch?v=sZaE5rIavVA&pp=ygURdGVjaG5vbG9neSByZXZpZXc%3D",
"video_id": "sZaE5rIavVA",
"title": "Bob Lazar: Area 51 & Flying Saucers",
"snippet": "In 1989, physicist Bob Lazar broke the story of Area 51 and the US government's work on alien spacecrafts. He blew the whistle, ...",
"published_time": null,
"duration_seconds": 5797,
"duration_text": "1:36:37",
"view_count": null,
"badges": [
"Free with ads",
"TV-14",
{
"_more_items": 2
}
],
"thumbnail_url": "https://example.com/image.jpg",
"thumbnails": [
{
"url": "https://i.ytimg.com/vi_webp/sZaE5rIavVA/movieposter_en.webp",
"width": 279,
"height": 402
}
]
},
{
"author": {
"url": "https://www.youtube.com/@hbomax",
"channel_id": "UCx-KWLTKlB83hDI6UKECtJQ",
"username": "hbomax",
"display_name": "HBO Max"
},
"url": "https://www.youtube.com/watch?v=fq9i7DpU_y8&pp=ygURdGVjaG5vbG9neSByZXZpZXc%3D",
"video_id": "fq9i7DpU_y8",
"title": "Finding Bigfoot: The Search Continues",
"snippet": "The Finding Bigfoot team reunites after 3 years to investigate compelling Squatch evidence in Ohio and West Virginia. Equipped ...",
"published_time": null,
"duration_seconds": 5052,
"duration_text": "1:24:12",
"view_count": null,
"badges": [
"Try now",
"TV-PG",
{
"_more_items": 2
}
],
"thumbnail_url": "https://example.com/image.jpg",
"thumbnails": [
{
"url": "https://lh3.googleusercontent.com/dcI2GffkBaVn79jFzqPL1WF4hAEAj5Oi-h7uqrcSwWUkNsWLXX57Y05w0LFayOwxG2UIv4jtzgae",
"width": 279,
"height": 402
}
]
},
{
"_more_items": 18
}
]
}
}
}Dieses kompakte JSON-Beispiel stammt aus dem letzten erfolgreichen Verifizierungslauf von V1.
{
"success": true,
"status": "ok",
"pagination": {
"cursor": "QVFB...",
"has_more": true
},
"search_context": {
"query": "technology review",
"country_code": "US"
},
"data": {
"responseContext": {
"serviceTrackingParams": [
{
"service": "GUIDED_HELP",
"params": [
{
"key": "context",
"value": "yt_web_search"
},
{
"key": "logged_in",
"value": "0"
}
]
},
{
"service": "GFEEDBACK",
"params": [
{
"key": "has_unlimited_entitlement",
"value": "False"
},
{
"key": "has_premium_lite_entitlement",
"value": "False"
},
{
"_more_items": 2
}
]
},
{
"_more_items": 2
}
],
"mainAppWebResponseContext": {
"loggedOut": true,
"trackingParam": "k5_fmPxhoXZRWv_kZz5IcWI40CAb7P48eE1T5iuvvrt8jgEXqU0YR3WQSzRMkuMESLBwOcCw59TLtslLKPQGSS"
},
"responseId": "IhMIy8KrltXflQMVZMDOAB17zR_6",
"webResponseContextExtensionData": {
"webResponseContextPreloadData": {
"preloadMessageNames": [
"twoColumnSearchResultsRenderer",
"sectionListRenderer",
{
"_more_items": 43
}
]
},
"hasDecorated": true
}
},
"estimatedResults": "893",
"contents": {
"twoColumnSearchResultsRenderer": {
"primaryContents": {
"sectionListRenderer": {
"contents": [
"…",
"…"
],
"trackingParams": "CDwQui8iEwjLwquW1d-VAxVkwM4AHXvNH_o=",
"subMenu": {
"searchSubMenuRenderer": "…"
},
"hideBottomSeparator": true,
"targetId": "search-feed"
}
}
}
},
"trackingParams": "CAAQvGkiEwjLwquW1d-VAxVkwM4AHXvNH_rKAQRetfVv",
"header": {
"searchHeaderRenderer": {
"chipBar": {
"chipCloudRenderer": {
"chips": [
"…",
"…",
{
"_more_items": 5
}
],
"trackingParams": "CDIQkVoiEwjLwquW1d-VAxVkwM4AHXvNH_o=",
"nextButton": {
"buttonRenderer": "…"
},
"previousButton": {
"buttonRenderer": "…"
}
}
},
"searchFilterButton": {
"buttonRenderer": {
"style": "STYLE_TEXT",
"size": "SIZE_DEFAULT",
"isDisabled": false,
"text": {
"runs": "…"
},
"icon": {
"iconType": "TUNE"
},
"tooltip": "Search filters",
"trackingParams": "CBMQ8FsiEwjLwquW1d-VAxVkwM4AHXvNH_o=",
"accessibilityData": {
"accessibilityData": "…"
},
"command": {
"clickTrackingParams": "CBMQ8FsiEwjLwquW1d-VAxVkwM4AHXvNH_rKAQRetfVv",
"openPopupAction": "…"
},
"iconPosition": "BUTTON_ICON_POSITION_TYPE_RIGHT_OF_TEXT"
}
},
"trackingParams": "CBIQiOoKIhMIy8KrltXflQMVZMDOAB17zR_6"
}
},
"topbar": {
"desktopTopbarRenderer": {
"logo": {
"topbarLogoRenderer": {
"iconImage": {
"iconType": "YOUTUBE_LOGO"
},
"tooltipText": {
"runs": "…"
},
"endpoint": {
"clickTrackingParams": "CBEQsV4iEwjLwquW1d-VAxVkwM4AHXvNH_rKAQRetfVv",
"commandMetadata": "…",
"browseEndpoint": "…"
},
"trackingParams": "CBEQsV4iEwjLwquW1d-VAxVkwM4AHXvNH_o=",
"overrideEntityKey": "EgZ0b3BiYXIg9QEoAQ%3D%3D"
}
},
"searchbox": {
"fusionSearchboxRenderer": {
"icon": {
"iconType": "SEARCH"
},
"placeholderText": {
"runs": "…"
},
"config": {
"webSearchboxConfig": "…"
},
"trackingParams": "CA0Q7VAiEwjLwquW1d-VAxVkwM4AHXvNH_o=",
"searchEndpoint": {
"clickTrackingParams": "CA0Q7VAiEwjLwquW1d-VAxVkwM4AHXvNH_rKAQRetfVv",
"commandMetadata": "…",
"searchEndpoint": "…"
},
"clearButton": {
"buttonRenderer": "…"
},
"showImageSourceDialog": {
"clickTrackingParams": "CA0Q7VAiEwjLwquW1d-VAxVkwM4AHXvNH_rKAQRetfVv",
"showDialogCommand": "…"
},
"disableAiAppearance": true
}
},
"trackingParams": "CAEQq6wBIhMIy8KrltXflQMVZMDOAB17zR_6",
"topbarButtons": [
{
"topbarMenuButtonRenderer": {
"icon": "…",
"menuRequest": "…",
"trackingParams": "CAsQ_qsBGAAiEwjLwquW1d-VAxVkwM4AHXvNH_o=",
"accessibility": "…",
"tooltip": "Settings",
"style": "STYLE_DEFAULT"
}
},
{
"buttonRenderer": {
"style": "STYLE_SUGGESTIVE",
"size": "SIZE_SMALL",
"text": "…",
"icon": "…",
"navigationEndpoint": "…",
"trackingParams": "CAoQ1IAEGAEiEwjLwquW1d-VAxVkwM4AHXvNH_o=",
"targetId": "topbar-signin"
}
}
],
"hotkeyDialog": {
"hotkeyDialogRenderer": {
"title": {
"runs": "…"
},
"sections": [
"…",
"…",
{
"_more_items": 2
}
],
"dismissButton": {
"buttonRenderer": "…"
},
"trackingParams": "CAgQteYDIhMIy8KrltXflQMVZMDOAB17zR_6"
}
},
"backButton": {
"buttonRenderer": {
"trackingParams": "CAcQvIYDIhMIy8KrltXflQMVZMDOAB17zR_6",
"command": {
"clickTrackingParams": "CAcQvIYDIhMIy8KrltXflQMVZMDOAB17zR_6ygEEXrX1bw==",
"commandMetadata": "…",
"signalServiceEndpoint": "…"
}
}
},
"forwardButton": {
"buttonRenderer": {
"trackingParams": "CAYQvYYDIhMIy8KrltXflQMVZMDOAB17zR_6",
"command": {
"clickTrackingParams": "CAYQvYYDIhMIy8KrltXflQMVZMDOAB17zR_6ygEEXrX1bw==",
"commandMetadata": "…",
"signalServiceEndpoint": "…"
}
}
},
"a11ySkipNavigationButton": {
"buttonRenderer": {
"style": "STYLE_DEFAULT",
"size": "SIZE_DEFAULT",
"isDisabled": false,
"text": {
"runs": "…"
},
"trackingParams": "CAUQ8FsiEwjLwquW1d-VAxVkwM4AHXvNH_o=",
"command": {
"clickTrackingParams": "CAUQ8FsiEwjLwquW1d-VAxVkwM4AHXvNH_rKAQRetfVv",
"commandMetadata": "…",
"signalServiceEndpoint": "…"
}
}
},
"voiceSearchButton": {
"buttonRenderer": {
"style": "STYLE_DEFAULT",
"size": "SIZE_DEFAULT",
"isDisabled": false,
"serviceEndpoint": {
"clickTrackingParams": "CAIQ7a8FIhMIy8KrltXflQMVZMDOAB17zR_6ygEEXrX1bw==",
"commandMetadata": "…",
"signalServiceEndpoint": "…"
},
"icon": {
"iconType": "MICROPHONE_ON"
},
"tooltip": "Search with your voice",
"trackingParams": "CAIQ7a8FIhMIy8KrltXflQMVZMDOAB17zR_6",
"accessibilityData": {
"accessibilityData": "…"
}
}
}
}
},
"targetId": "search-page"
}
}Nutzen Sie diese Dokumentation als ersten Entscheidungspunkt und prüfen Sie dann Preise, Plattformabdeckung und Integrationsregeln, bevor Sie den Endpunkt für die wiederkehrende Nutzung anbinden.
Nutzen Sie diese Antworten, um zu entscheiden, ob diese API-Methode zu Ihrem Ablauf, Ihrer Versionswahl und Ihrem Einführungsplan passt.
Die Methode führt „Movies By Country“ für Suche aus. Das kompakte Antwortbeispiel unten zeigt die genaue Struktur der Felder.
Wählen Sie V2 für neue Integrationen, da sie eine normalisierte Struktur bietet. Verwenden Sie V1 nur zur Kompatibilität mit Clients, die bereits das native Format der Plattform verarbeiten.
Erstellen Sie einen API-Schlüssel, senden Sie ihn im Header der Anfrage und geben Sie die Pflichtparameter aus der Tabelle an. Die Codebeispiele enthalten bereits den korrekten Pfad und die richtige Anfragestruktur.