Führt eine Stichwortsuche über Twitch-Kanäle aus und liefert Treffer mit Live-Status und Kanalmetadaten, paginiert.
POST
/api/v1/twitch/search/channelsKontingentverbrauch: Jede erfolgreiche Anfrage an diesen Endpunkt zieht 1 Kontingenteinheiten von Ihrem Plan ab.
Request-Parameter
Pflichtparameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
query | body | string | Search query example: string |
Optionale Parameter
| Name | Ort | Typ | Beschreibung |
|---|---|---|---|
live_only | body | boolean | Only search live channels example: true |
first | body | integer | Maximum number of items per page. Minimum 1, maximum 100, default 20 example: 0 |
after | body | object | Next page cursor example: string |
Antwortfelder
| Name | Typ | Beschreibung |
|---|---|---|
success | boolean | Success |
code | integer | Code |
message | string | Message |
data | object | - |
data.more | boolean | Has more |
data.offset | string | offset |
data.data | array<object> | data |
Ausprobieren
https://openapi.scdata.cc/api/v1/twitch/search/channels
API-Schlüssel aus dem Dashboard auswählen
Fügen Sie einen API-Schlüssel hinzu, bevor Sie eine Anfrage senden.Zum Dashboard
JSON-Body
cURL-Beispiel
bash
curl -X POST "https://openapi.scdata.cc/api/v1/twitch/search/channels" \-H "Authorization: YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"query":"string","live_only":true,"first":0,"after":"string"}'
Antwortbeispiel (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"more": true,"offset": "string","data": [{"id": "string","broadcaster_language": "string","broadcaster_login": "string","display_name": "string","game_id": "string","game_name": "string","is_live": true,"tags": ["string"],"thumbnail_url": "string","title": "string","started_at": "2019-08-24T14:15:22.123Z"}]}}
Anwendungsfälle
- Streamer-Entdeckung — Finden Sie Kanäle, die eine Produktkategorie oder Community im Namen oder Titel erwähnen.
- Sprachspezifisches Sourcing — Filtern Sie Ergebnisse nach Sendesprache für regionale Kampagnen.