YouTube API: Vidéos — Commentaires par ID de vidéo

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 contient les éléments de la conversation, les données publiques des auteurs, les signaux d'interaction et les champs de pagination.

Quand l'utiliser

Utilisez « Commentaires par ID de vidéo » lorsque vous avez besoin du texte de la conversation, des auteurs, des horodatages et d'une pagination continue.

Cas d'usage courants

Surveillance des conversations

Suivez les réactions de l'audience sous les contenus et autour des objets sélectionnés.

Modération

Acheminez les messages publics vers des files de vérification, de classification et de qualité.

Analyse des commentaires

Utilisez le texte des conversations et leurs métadonnées dans les rapports et les études d'audience.

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.

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
`video_id`	Oui	`str`	`5aS-8QCRdGE`	Identifiant de la vidéo sur la plateforme choisie.
`cursor`	Non	`str \| None`	`cursor-next-page`	Curseur de la page suivante issu de la réponse précédente. À omettre pour la première page.

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/youtube.com/videos/comments-by-video-id

Format normalisé

Aperçu de la requête

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

Endpoint /api/v2/youtube.com/videos/comments-by-video-id

Paramètres obligatoires

video_id

Paramètres facultatifs

cursor

URL d'exemple

https://www.scrapestorm.net/api/v2/youtube.com/videos/comments-by-video-id?video_id=5aS-8QCRdGE

Exemples de code

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/youtube.com/videos/comments-by-video-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'video_id=5aS-8QCRdGE' \
  # 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/videos/comments-by-video-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "video_id": "5aS-8QCRdGE",
}

# 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/videos/comments-by-video-id";

const params = new URLSearchParams({
  video_id: "5aS-8QCRdGE",
});

// 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 = {
  video_id: "5aS-8QCRdGE",
};

// 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 = [
    "video_id" => "5aS-8QCRdGE",
];

// Optional parameters
// $query["cursor"] = "cursor-next-page";

try {
    $response = $client->request("GET", "/api/v2/youtube.com/videos/comments-by-video-id", [
        '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/videos/comments-by-video-id"

    params := url.Values{}
    params.Set("video_id", "5aS-8QCRdGE")

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

Chemin de requête par version

V1

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/v1/youtube.com/videos/comments-by-video-id

Format natif de la plateforme

Aperçu de la requête

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

Endpoint /api/v1/youtube.com/videos/comments-by-video-id

Paramètres obligatoires

video_id

Paramètres facultatifs

cursor

URL d'exemple

https://www.scrapestorm.net/api/v1/youtube.com/videos/comments-by-video-id?video_id=5aS-8QCRdGE

Exemples de code

curl --request GET \
  --url "https://www.scrapestorm.net/api/v1/youtube.com/videos/comments-by-video-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'video_id=5aS-8QCRdGE' \
  # 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/videos/comments-by-video-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "video_id": "5aS-8QCRdGE",
}

# 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/videos/comments-by-video-id";

const params = new URLSearchParams({
  video_id: "5aS-8QCRdGE",
});

// 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 = {
  video_id: "5aS-8QCRdGE",
};

// 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 = [
    "video_id" => "5aS-8QCRdGE",
];

// Optional parameters
// $query["cursor"] = "cursor-next-page";

try {
    $response = $client->request("GET", "/api/v1/youtube.com/videos/comments-by-video-id", [
        '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/videos/comments-by-video-id"

    params := url.Values{}
    params.Set("video_id", "5aS-8QCRdGE")

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

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",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "video_id": "5aS-8QCRdGE"
  },
  "data": {
    "comments": {
      "count": 20,
      "items": [
        {
          "author": {
            "url": "https://www.youtube.com/@nobody_9248",
            "channel_id": "UCaey52A0aWwWjtBEUu9qOQg",
            "username": "nobody_9248",
            "avatar_url": "https://example.com/image.jpg",
            "avatar_urls": "https://example.com/image.jpg"
          },
          "comment_id": "Ugyt1rlGJzwUjTuaNc14AaABAg",
          "text": "Life was good",
          "published_time": "3 months ago",
          "like_count": 15000,
          "reply_count": 74,
          "is_pinned": null,
          "is_author_channel_owner": false
        },
        {
          "author": {
            "url": "https://www.youtube.com/@WallArt.k",
            "channel_id": "UCU5bycVtGjkw86BtH4FlvXg",
            "username": "WallArt.k",
            "avatar_url": "https://example.com/image.jpg",
            "avatar_urls": "https://example.com/image.jpg"
          },
          "comment_id": "UgwaR0aXMWNM7wnG1iZ4AaABAg",
          "text": "The marketing team failed the engineering team",
          "published_time": "3 months ago",
          "like_count": 6200,
          "reply_count": 28,
          "is_pinned": null,
          "is_author_channel_owner": false
        },
        {
          "_more_items": 18
        }
      ]
    }
  }
}

Exemple de réponse

V1 JSON de réponse

Exemple vérifié

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

{
  "success": true,
  "status": "ok",
  "pagination": {
    "cursor": "QVFB...",
    "has_more": true
  },
  "search_context": {
    "video_id": "5aS-8QCRdGE"
  },
  "data": {
    "responseContext": {
      "serviceTrackingParams": [
        {
          "service": "CSI",
          "params": [
            {
              "key": "c",
              "value": "WEB"
            },
            {
              "key": "cver",
              "value": "2.20260715.04.00"
            },
            {
              "_more_items": 2
            }
          ]
        },
        {
          "service": "GFEEDBACK",
          "params": [
            {
              "key": "logged_in",
              "value": "0"
            },
            {
              "key": "visitor_data",
              "value": "Cgt4N0JiRG5EMEVXRSjq_fTSBjIKCgJVUxIEGgAgDWLfAgrcAjIwLllUPUNfMWpRMHJlQk1McFpvcW96LW54NS03VzZrZUhaazNJU0pJVjh4bHM1NVdlakdMbjktUm5CeDVTaTAxVHhYc0ZGVkZ1a184cU9qNkVhazdpR2NoaXptT1gxYTBpa3Bxdm9tXzVDeHFTUHRleWRhc2huTS03VVRXaVF0RURkMng0aTkzNmNQVUNqZ3FKNnM1cnVUZUxKNkxDY1c5dkpLUkg3ODRmR2tKT293NkVQQUhRdlYtZEtBemwzeG5hYkE3RlJqeV9zOEdNeU1COE91NnNGdEtFZ3ExeERGWFBnOFJkR1BnZTJ5YjM0U2tjNHE0ZmxtTVdSMk5nbEQ4eEFrckpsQXN2R0pURmpWQWFCeVJ5LWVvNGQ5Ni1UdUlBRDl1VThSdFVoSDVscVFjZ196YjF0aEo3aFVRSXNyeU8zVUt2TGFGXzB1eXgxNTd4QTRQZWh1YlpaQQ%3D%3D"
            }
          ]
        },
        {
          "_more_items": 2
        }
      ],
      "mainAppWebResponseContext": {
        "loggedOut": true,
        "trackingParam": "k5_fmPxhoXZR7HU4txEU-Ct0VYWH8520YDejlgXXkqyESzp_aU88omzM5HRMkusYh7BwOcCw59TLtslLKPQGSS"
      },
      "responseId": "IhMIhZaMnNXflQMVPMQ_BB3Cpix2",
      "webResponseContextExtensionData": {
        "webResponseContextPreloadData": {
          "preloadMessageNames": [
            "commentsHeaderRenderer",
            "commentSimpleboxRenderer",
            {
              "_more_items": 10
            }
          ]
        },
        "hasDecorated": true
      }
    },
    "trackingParams": "CAAQg2ciEwiFloyc1d-VAxU8xD8EHcKmLHbKAQRetfVv",
    "onResponseReceivedEndpoints": [
      {
        "clickTrackingParams": "CAAQg2ciEwiFloyc1d-VAxU8xD8EHcKmLHbKAQRetfVv",
        "reloadContinuationItemsCommand": {
          "targetId": "engagement-panel-comments-section",
          "continuationItems": [
            {
              "commentsHeaderRenderer": "…"
            }
          ],
          "slot": "RELOAD_CONTINUATION_SLOT_HEADER"
        }
      },
      {
        "clickTrackingParams": "CAAQg2ciEwiFloyc1d-VAxU8xD8EHcKmLHbKAQRetfVv",
        "reloadContinuationItemsCommand": {
          "targetId": "engagement-panel-comments-section",
          "continuationItems": [
            {
              "commentThreadRenderer": "…"
            },
            {
              "commentThreadRenderer": "…"
            },
            {
              "_more_items": 19
            }
          ],
          "slot": "RELOAD_CONTINUATION_SLOT_BODY"
        }
      }
    ],
    "frameworkUpdates": {
      "entityBatchUpdate": {
        "mutations": [
          {
            "entityKey": "EgAgKygB",
            "type": "ENTITY_MUTATION_TYPE_REPLACE",
            "payload": {
              "commentSharedEntityPayload": "…"
            }
          },
          {
            "entityKey": "EhpVZ3l0MXJsR0p6d1VqVHVhTmMxNEFhQUJBZyAoKAE%3D",
            "type": "ENTITY_MUTATION_TYPE_REPLACE",
            "payload": {
              "commentEntityPayload": "…"
            }
          },
          {
            "_more_items": 99
          }
        ],
        "timestamp": {
          "seconds": "1784495888",
          "nanos": 369158136
        }
      }
    }
  }
}

Méthodes associées

Continuez avec Vidéos

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 YouTube

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 YouTube ?

La méthode exécute « Commentaires par ID de vidéo » pour Vidéos. 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.

YouTube API: Vidéos — Commentaires par ID de vidéo

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

À quoi sert cet endpoint

Quand l'utiliser

Cas d'usage courants

Surveillance des conversations

Modération

Analyse des commentaires

Version de la réponse

Ce qui reste identique

Ce qui change entre les versions

Comment appeler la méthode

Paramètres d'entrée

Chemin de requête par version

Exemples de code

Chemin de requête par version

Exemples de code

Réponse en direct par version

V2 JSON de réponse

V1 JSON de réponse

Continuez avec Vidéos

Vidéos: Détails par ID de vidéo

Vidéos: Contenus associés par ID de vidéo

Poursuivez l'évaluation

Ouvrez la page de la plateforme YouTube

Comparez les prix des méthodes d'API

Consultez les règles d'intégration

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