Renvoie les catégories Twitch correspondantes avec identifiant, nom et jaquette. Utilisez l'identifiant dans les endpoints de recherche de lives et de chaînes.
POST
/api/v1/twitch/search/categoriesConsommation de quota: Chaque requête réussie vers ce point de terminaison déduit 1 unités de quota de votre forfait.
Paramètres de requête
Paramètres obligatoires
| Nom | Emplacement | Type | Description |
|---|---|---|---|
query | body | string | Search query example: string |
Paramètres optionnels
| Nom | Emplacement | Type | Description |
|---|---|---|---|
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 |
Champs de réponse
| Nom | Type | Description |
|---|---|---|
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 |
Tester
https://openapi.scdata.cc/api/v1/twitch/search/categories
Sélectionnez une clé API du tableau de bord
Ajoutez une clé API avant d'envoyer une requête.Ouvrir le tableau de bord
Corps JSON
Exemple cURL
bash
curl -X POST "https://openapi.scdata.cc/api/v1/twitch/search/categories" \-H "Authorization: YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"query":"string","first":0,"after":"string"}'
Exemple de réponse (200 application/json)
json
{"success": true,"code": 200,"message": "Request successful","data": {"more": true,"offset": "string","data": [{"box_art_url": "string","id": 0,"name": "string"}]}}
Cas d'usage
- Ciblage par jeu — Résolvez un titre de jeu en identifiant de catégorie avant de chercher les streamers qui y jouent.
- Autocomplétion de catégories — Alimentez un sélecteur de catégories dans un outil interne.