Finden Sie Suche-Daten auf Twitch anhand einer Nutzeranfrage und binden Sie die Ergebnisse an Such-, Katalog- oder Rechercheoberflächen an.
Nutzen Sie „Live-Kanäle nach Suchanfrage“, 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 „Live-Kanäle nach Suchanfrage“, 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 Twitch-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 |
|---|---|---|---|---|
query |
Ja | str |
gaming |
Vom Nutzer eingegebene Suchanfrage. |
cursor |
Nein | str | None |
MTU= |
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/twitch.tv/search/live-channels-by-querycurl --request GET \
--url "https://www.scrapestorm.net/api/v2/twitch.tv/search/live-channels-by-query" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'query=gaming' \
# Optional parameters:
# --data-urlencode 'cursor=MTU='from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/twitch.tv/search/live-channels-by-query"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"query": "gaming",
}
# Optional parameters
# params["cursor"] = "MTU="
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/twitch.tv/search/live-channels-by-query";
const params = new URLSearchParams({
query: "gaming",
});
// Optional parameters
// params.set("cursor", "MTU=");
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 = {
query: "gaming",
};
// Optional parameters
// params.cursor = "MTU=";
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 = [
"query" => "gaming",
];
// Optional parameters
// $query["cursor"] = "MTU=";
try {
$response = $client->request("GET", "/api/v2/twitch.tv/search/live-channels-by-query", [
'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/twitch.tv/search/live-channels-by-query"
params := url.Values{}
params.Set("query", "gaming")
// Optional parameters
// params.Set("cursor", "MTU=")
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/twitch.tv/search/live-channels-by-querycurl --request GET \
--url "https://www.scrapestorm.net/api/v1/twitch.tv/search/live-channels-by-query" \
--header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
--get --data-urlencode 'query=gaming' \
# Optional parameters:
# --data-urlencode 'cursor=MTU='from urllib.parse import urljoin
import requests
BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/twitch.tv/search/live-channels-by-query"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}
params = {
"query": "gaming",
}
# Optional parameters
# params["cursor"] = "MTU="
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/twitch.tv/search/live-channels-by-query";
const params = new URLSearchParams({
query: "gaming",
});
// Optional parameters
// params.set("cursor", "MTU=");
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 = {
query: "gaming",
};
// Optional parameters
// params.cursor = "MTU=";
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 = [
"query" => "gaming",
];
// Optional parameters
// $query["cursor"] = "MTU=";
try {
$response = $client->request("GET", "/api/v1/twitch.tv/search/live-channels-by-query", [
'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/twitch.tv/search/live-channels-by-query"
params := url.Values{}
params.Set("query", "gaming")
// Optional parameters
// params.Set("cursor", "MTU=")
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": "gaming"
},
"data": {
"live_channels": {
"count": 15,
"items": [
{
"rank": 1,
"channel_url": "https://www.twitch.tv/zentreya",
"user_id": "128440061",
"username": "zentreya",
"display_name": "Zentreya",
"description": "【 VARIETY STREAMER VTUBER 】 【⚡ THE CYBER PUNK / ROCKIN RED DRAGON 🔥 】. I have an amazing community, stop by, say hi! Hope you enjoy watching and have fun! ( BUSINESS INQUIRES :…",
"hashtags": [],
"emails": [
"[email protected]",
"[email protected]"
],
"is_partner": true,
"is_live": true,
"follower_count": 612568,
"stream": {
"stream_id": "320448797530",
"type": "live",
"title": "NEW 3D UPDATES AND A COOL NEW OUTFIT + COLLAB DAY + NEW ZEN FIGURE DROP !ggd | !agentink !youtooz !nendo !spencers !senpai !v1tech !vite",
"game": {
"game_id": "789588840",
"slug": "funnel-runners",
"name": "Funnel Runners",
"display_name": "Funnel Runners"
},
"started_at": "2026-07-19T15:58:37.516727Z",
"viewer_count": 4914,
"preview_image_url": "https://example.com/image.jpg",
"vertical_preview_image_url": "https://example.com/image.jpg",
"template_preview_image_url": "https://example.com/image.jpg",
"width": 1920,
"height": 1080,
"tags": [
"English",
"ForkliftCertified",
{
"_more_items": 8
}
]
},
"latest_video": {
"video_id": "2823900103",
"title": "NEW 3D UPDATES AND A COOL NEW OUTFIT + COLLAB DAY + NEW ZEN FIGURE DROP !ggd | !agentink !youtooz !nendo !spencers !senpai !v1tech !vite",
"video_url": "https://www.twitch.tv/videos/2823900103",
"preview_thumbnail_url": "https://example.com/image.jpg",
"duration_seconds": 20040
},
"top_clip": {
"clip_id": "1186678872",
"slug": "RealHelpfulDeerNotLikeThis-gZwKslfacDFqbqep",
"title": "didyouseeit!",
"clip_url": "https://clips.twitch.tv/RealHelpfulDeerNotLikeThis-gZwKslfacDFqbqep",
"preview_thumbnail_url": "https://example.com/image.jpg",
"duration_seconds": 59
},
"avatar_url": "https://example.com/image.jpg"
},
{
"rank": 2,
"channel_url": "https://www.twitch.tv/controcalcio__",
"user_id": "541899730",
"username": "controcalcio__",
"display_name": "ControCalcio__",
"description": "Il Canale Twitch di Controcalcio! Tutti i giorni live dalle 16!",
"hashtags": [],
"emails": [],
"is_partner": true,
"is_live": true,
"follower_count": 144445,
"stream": {
"stream_id": "320561303771",
"type": "live",
"title": "REACTION INGHILTERRA FRANCIA! ATTENTION PLEASE! MBAPPE CAPOCANNONIERE? TANTE NOTIZIE DI MERCADU",
"game": {
"game_id": "518203",
"slug": "sports-1",
"name": "Sports",
"display_name": "Sports"
},
"started_at": "2026-07-19T17:30:34.719Z",
"viewer_count": 2762,
"preview_image_url": "https://example.com/image.jpg",
"vertical_preview_image_url": "https://example.com/image.jpg",
"template_preview_image_url": "https://example.com/image.jpg",
"width": 1920,
"height": 1080,
"tags": [
"Italiano",
"gaming",
{
"_more_items": 1
}
]
},
"latest_video": {
"video_id": "2823962078",
"title": "REACTION INGHILTERRA FRANCIA! ATTENTION PLEASE! MBAPPE CAPOCANNONIERE? TANTE NOTIZIE DI MERCADU",
"video_url": "https://www.twitch.tv/videos/2823962078",
"preview_thumbnail_url": "https://example.com/image.jpg",
"duration_seconds": 14523
},
"top_clip": {
"clip_id": "52102576",
"slug": "CorrectCourageousKoalaHeyGirl-lUz_1Inf513UJRP4",
"title": "Chirico sale in cattedra",
"clip_url": "https://clips.twitch.tv/CorrectCourageousKoalaHeyGirl-lUz_1Inf513UJRP4",
"preview_thumbnail_url": "https://example.com/image.jpg",
"duration_seconds": 30
},
"avatar_url": "https://example.com/image.jpg"
},
{
"_more_items": 13
}
]
}
}
}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": "gaming"
},
"data": {
"data": {
"searchFor": {
"banners": null,
"querySubstitution": {
"edges": [],
"__typename": "SearchForResultSubstitution"
},
"channels": {
"cursor": "",
"edges": [],
"score": 0,
"totalMatches": 0,
"__typename": "SearchForResultUsers"
},
"channelsWithTag": {
"cursor": "QVFB...",
"edges": [
{
"trackingID": "a973ce02-2fff-41b1-94b5-0e479c35c5de",
"item": "…",
"__typename": "SearchForEdge"
},
{
"trackingID": "76d25532-952e-4a1d-86ca-1930ad7a5d17",
"item": "…",
"__typename": "SearchForEdge"
},
{
"_more_items": 13
}
],
"score": 0,
"totalMatches": 15,
"__typename": "SearchForResultUsers"
},
"games": {
"cursor": "",
"edges": [],
"score": 0,
"totalMatches": 0,
"__typename": "SearchForResultGames"
},
"videos": {
"cursor": "",
"edges": [],
"score": 0,
"totalMatches": 0,
"__typename": "SearchForResultVideos"
},
"relatedLiveChannels": {
"edges": [],
"score": null,
"__typename": "SearchForResultRelatedLiveChannels"
},
"collections": {
"cursor": "",
"edges": [],
"score": 0,
"totalMatches": 0,
"__typename": "SearchForResultCollections"
},
"__typename": "SearchFor"
}
},
"extensions": {
"durationMilliseconds": 136,
"operationName": "SearchResultsPage_SearchResults",
"requestID": "01KXY4PY60MNX0KZ0FK36H97D2"
}
}
}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 „Live-Kanäle nach Suchanfrage“ 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.