Twitch API: Profil — Métriques des vidéos par nom d'utilisateur

Ce que fait cet endpoint

Ce que vous pouvez construire avec cette méthode d'API

Examinez d'abord le résultat et les flux courants, puis passez aux paramètres et à un exemple de requête fonctionnel.

À quoi sert cet endpoint

La réponse fournit un résumé Profil prêt à l'emploi avec des compteurs et des métriques clés au format d'API choisi.

Quand l'utiliser

Utilisez « Métriques des vidéos par nom d'utilisateur » pour les tableaux de bord, les évaluations et les rapports récurrents qui nécessitent un instantané compact des métriques.

Cas d'usage courants

Tableaux de bord produit

Affichez les principales métriques Twitch sans charger ni traiter une collection complète.

Suivi des tendances

Enregistrez des instantanés réguliers et comparez l'évolution des métriques dans le temps.

Évaluation des objets

Utilisez les métriques agrégées comme entrée pour les classements et les règles internes.

Versions disponibles

Version de la réponse

Les deux versions répondent au même besoin et acceptent les mêmes paramètres. Utilisez le sélecteur pour comparer la structure de la réponse et choisissez la version attendue par votre client.

Version de la réponse V2

Changez de version sur cette page pour comparer les structures de réponse sous la même URL de documentation.

V1 Non disponible

Ce qui reste identique

L'authentification, les paramètres obligatoires et la forme de la requête sont identiques en V1 et V2. En pratique, vous choisissez la version en construisant le chemin de l'endpoint et en lisant la réponse.

Ce qui change entre les versions

La principale différence réside dans l'enveloppe de la réponse. Utilisez V2 pour les nouvelles intégrations et ne conservez V1 que si vous avez besoin de compatibilité avec un contrat client existant.

Comment l'utiliser

Comment appeler la méthode

Utilisez le même en-tête de clé API et les mêmes paramètres de requête dans les deux versions. Cette documentation présente d'abord l'ensemble commun de paramètres, puis les chemins et extraits de code de chaque version.

Paramètres d'entrée

Paramètres communs

Paramètre	Obligatoire	Type	Exemple	Description
`username`	Oui	`str`	`ninja`	Nom d'utilisateur public sans le symbole @.

Chemin de requête par version

V2

Choisissez une version lorsque vous copiez le chemin exact de l'endpoint, l'URL d'exemple et l'extrait de code. La liste des paramètres ci-dessus ne change pas.

GET /api/v2/twitch.tv/profile/videos-metrics-by-username

Format normalisé

Aperçu de la requête

URL de base https://www.scrapestorm.net

Endpoint /api/v2/twitch.tv/profile/videos-metrics-by-username

Paramètres obligatoires

username

Paramètres facultatifs

Aucun

URL d'exemple

https://www.scrapestorm.net/api/v2/twitch.tv/profile/videos-metrics-by-username?username=ninja

Exemples de code

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/twitch.tv/profile/videos-metrics-by-username" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'username=ninja'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/twitch.tv/profile/videos-metrics-by-username"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "username": "ninja",
}

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/profile/videos-metrics-by-username";

const params = new URLSearchParams({
  username: "ninja",
});

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 = {
  username: "ninja",
};

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 = [
    "username" => "ninja",
];

try {
    $response = $client->request("GET", "/api/v2/twitch.tv/profile/videos-metrics-by-username", [
        '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/profile/videos-metrics-by-username"

    params := url.Values{}
    params.Set("username", "ninja")

    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)
}

Exemple de réponse

Réponse en direct par version

L'aperçu contient les champs clés et les premiers éléments de la collection pour vous permettre de vérifier rapidement la forme de la réponse. Le format JSON change avec la version.

Exemple de réponse

V2 JSON de réponse

Exemple vérifié

Cet exemple JSON compact provient de la dernière vérification réussie de V2.

{
  "success": true,
  "status": "ok",
  "search_context": {
    "username": "ninja"
  },
  "data": {
    "channel": {
      "channel_url": "https://www.twitch.tv/ninja",
      "user_id": "19571641",
      "username": "ninja",
      "display_name": "Ninja",
      "description": "Just want to make people happy. Co-Founder @DrinkNutcase.",
      "hashtags": [],
      "emails": [],
      "follower_count": 19252591,
      "is_partner": true,
      "last_broadcast_game": {
        "game_id": "1264310518",
        "slug": null,
        "name": null,
        "display_name": "Marvel Rivals"
      },
      "avatar_url": "https://example.com/image.jpg"
    },
    "analytics": {
      "all_posts": {
        "analyzed_posts_count": 100,
        "last_post_date": "2026-06-10T19:00:38+00:00",
        "total_engagement": 0,
        "avg_engagement_rate_per_post": 0.0,
        "peak_engagement_rate_per_post": 0.0,
        "avg_weighted_engagement_score": 0.0,
        "total_engagement_rate": 0.0,
        "median_engagement_per_post": 0.0,
        "max_engagement_per_post": 0,
        "avg_caption_length": 54,
        "avg_posts_per_week": 3,
        "avg_posts_per_month": 14,
        "posts_count_last_7_days": 0,
        "posts_count_last_30_days": 0,
        "total_views": 15817982,
        "avg_views_per_post": 158180,
        "avg_views_per_video": 158180,
        "total_view_rate": 82.160277,
        "follower_count": 19252591,
        "median_views_per_video": 162716.0,
        "min_views": 4902,
        "max_views": 597845,
        "average_view_rate_per_video": 0.821599,
        "average_duration_seconds": 20202.76,
        "_more_fields": "6 more fields"
      },
      "sponsored_posts": {
        "analyzed_posts_count": 1,
        "last_post_date": "2025-12-12T13:51:10+00:00",
        "total_engagement": 0,
        "avg_engagement_rate_per_post": 0.0,
        "peak_engagement_rate_per_post": 0.0,
        "avg_weighted_engagement_score": 0.0,
        "total_engagement_rate": 0.0,
        "median_engagement_per_post": 0.0,
        "max_engagement_per_post": 0,
        "avg_caption_length": 110,
        "avg_posts_per_week": 0,
        "avg_posts_per_month": 1,
        "posts_count_last_7_days": 0,
        "posts_count_last_30_days": 0,
        "total_views": 218793,
        "avg_views_per_post": 218793,
        "avg_views_per_video": 218793,
        "total_view_rate": 1.136434,
        "follower_count": 19252591,
        "median_views_per_video": 218793.0,
        "min_views": 218793,
        "max_views": 218793,
        "average_view_rate_per_video": 1.136434,
        "average_duration_seconds": 33685.0,
        "_more_fields": "6 more fields"
      },
      "organic_posts": {
        "analyzed_posts_count": 99,
        "last_post_date": "2026-06-10T19:00:38+00:00",
        "total_engagement": 0,
        "avg_engagement_rate_per_post": 0.0,
        "peak_engagement_rate_per_post": 0.0,
        "avg_weighted_engagement_score": 0.0,
        "total_engagement_rate": 0.0,
        "median_engagement_per_post": 0.0,
        "max_engagement_per_post": 0,
        "avg_caption_length": 53,
        "avg_posts_per_week": 3,
        "avg_posts_per_month": 14,
        "posts_count_last_7_days": 0,
        "posts_count_last_30_days": 0,
        "total_views": 15599189,
        "avg_views_per_post": 157568,
        "avg_views_per_video": 157568,
        "total_view_rate": 81.023842,
        "follower_count": 19252591,
        "median_views_per_video": 161266.0,
        "min_views": 4902,
        "max_views": 597845,
        "average_view_rate_per_video": 0.81842,
        "average_duration_seconds": 20066.58,
        "_more_fields": "6 more fields"
      },
      "segment_comparison": {
        "sponsored_content_share": 1.0,
        "organic_content_share": 99.0,
        "organic_vs_sponsored_engagement_rate_gap": 0.0,
        "sponsored_to_organic_avg_engagement_ratio": 0.0
      }
    },
    "feed": {
      "count": 100,
      "items": [
        {
          "url": "https://www.twitch.tv/videos/2793492428",
          "video_id": "2793492428",
          "title": "NEW FORTNITE SEASON W/ MY BRO JUST VIBING",
          "preview_thumbnail_url": "https://example.com/image.jpg",
          "animated_preview_url": "https://d1m7jfoe9zdc1j.cloudfront.net/8930b8733be938a812b5_ninja_319868118491_1781118033/storyboards/2793492428-strip-0.jpg",
          "published_at": "2026-06-10T19:00:38Z",
          "duration_seconds": 14683,
          "view_count": 184897,
          "game": {
            "game_id": "33214",
            "slug": "fortnite",
            "name": "Fortnite",
            "display_name": "Fortnite",
            "box_art_url": "https://static-cdn.jtvnw.net/ttv-boxart/33214-40x56.jpg"
          },
          "owner": {
            "channel_url": "https://www.twitch.tv/ninja",
            "user_id": "19571641",
            "username": "ninja",
            "display_name": "Ninja",
            "is_partner": true,
            "avatar_url": "https://example.com/image.jpg"
          },
          "is_sponsored": false,
          "sponsored_detection_source": null,
          "sponsored_detection_confidence": null
        },
        {
          "url": "https://www.twitch.tv/videos/2792555053",
          "video_id": "2792555053",
          "title": "NEW FORTNITE SEASON W/ MY BRO JUST VIBING",
          "preview_thumbnail_url": "https://example.com/image.jpg",
          "animated_preview_url": "https://d1m7jfoe9zdc1j.cloudfront.net/80f5149b59d31a7254e8_ninja_319741192794_1781021015/storyboards/2792555053-strip-0.jpg",
          "published_at": "2026-06-09T16:03:40Z",
          "duration_seconds": 11216,
          "view_count": 128845,
          "game": {
            "game_id": "33214",
            "slug": "fortnite",
            "name": "Fortnite",
            "display_name": "Fortnite",
            "box_art_url": "https://static-cdn.jtvnw.net/ttv-boxart/33214-40x56.jpg"
          },
          "owner": {
            "channel_url": "https://www.twitch.tv/ninja",
            "user_id": "19571641",
            "username": "ninja",
            "display_name": "Ninja",
            "is_partner": true,
            "avatar_url": "https://example.com/image.jpg"
          },
          "is_sponsored": false,
          "sponsored_detection_source": null,
          "sponsored_detection_confidence": null
        },
        {
          "_more_items": 98
        }
      ]
    }
  }
}

Méthodes associées

Continuez avec Profil

Les méthodes associées résolvent le même objet par un autre identifiant, ouvrent des détails ou passent à une vue agrégée.

Étapes suivantes

Poursuivez l'évaluation

Utilisez cette documentation comme premier point de décision, puis vérifiez les prix, la couverture de la plateforme et les règles d'intégration avant de connecter l'endpoint pour un usage récurrent.

Ouvrez la page de la plateforme Twitch

Comparez les entités associées, les groupes de méthodes d'API et la documentation liée avant l'implémentation.

Ouvrir la page de la plateforme

Comparez les prix des méthodes d'API

Vérifiez la place de cette méthode dans le tableau public des tarifs avant d'augmenter l'utilisation.

Voir les tarifs

Consultez les règles d'intégration

Confirmez l'authentification, les versions, les nouvelles tentatives et les différences entre test et production dans la documentation de démarrage.

Ouvrir la documentation

Questions fréquentes

Les questions que posent les équipes avant l'implémentation

Utilisez ces réponses pour décider si cette méthode d'API convient à votre flux, à votre choix de version et à votre plan de déploiement.

Quelles données renvoie cette méthode de l'API Twitch ?

La méthode exécute « Métriques des vidéos par nom d'utilisateur » pour Profil. L'exemple de réponse compact ci-dessous montre la structure exacte des champs.

Dois-je choisir V1 ou V2 ?

Choisissez V2 pour les nouvelles intégrations, car elle fournit une structure normalisée. N'utilisez V1 que pour la compatibilité avec des clients qui traitent déjà le format natif de la plateforme.

De quoi ai-je besoin pour la première requête ?

Créez une clé API, envoyez-la dans l'en-tête de la requête et renseignez les paramètres obligatoires du tableau. Les exemples de code contiennent déjà le bon chemin et la bonne structure de requête.