List YouTube comments by id or parent comment id
youtube.x.youtube-comments-listcomments.list — Retrieves a list of resources, possibly filtered.
- Price
- freeAt provider cost
- Success rate
- —No success-rate data yetNo success-rate data yet
- Latency p50
- ——
- Last verified
- —Not verified yet
GEThttps://toolswitch.dev/v1/tools/youtube.x.youtube-comments-listPreview- Uses platform quota
- Synchronous response
- Reads public data
Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
| Query parameters | ||||
id | string | Optional | Returns the comments with the given IDs for One Platform. | |
part | string | Required | The *part* parameter specifies a comma-separated list of one or more comment resource properties that the API response will include. | |
parentId | string | Optional | Returns replies to the specified comment. Note, currently YouTube features only one level of replies (ie replies to top level comments). However replies to replies may be supported in the future. | |
pageToken | string | Optional | The *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved. | |
maxResults | integer | Optional | The *maxResults* parameter specifies the maximum number of items that should be returned in the result set. | |
textFormat | string | Optional | The requested text format for the returned comments. | |
- Query parameters
idstringOptionalReturns the comments with the given IDs for One Platform.
partstringRequiredThe *part* parameter specifies a comma-separated list of one or more comment resource properties that the API response will include.
parentIdstringOptionalReturns replies to the specified comment. Note, currently YouTube features only one level of replies (ie replies to top level comments). However replies to replies may be supported in the future.
pageTokenstringOptionalThe *pageToken* parameter identifies a specific page in the result set that should be returned. In an API response, the nextPageToken and prevPageToken properties identify other pages that could be retrieved.
maxResultsintegerOptionalThe *maxResults* parameter specifies the maximum number of items that should be returned in the result set.
textFormatstringOptionalThe requested text format for the returned comments.
Code samples
Replace $TOOLSWITCH_KEY with the key you created in the console.
curl -X GET 'https://toolswitch.dev/v1/tools/youtube.x.youtube-comments-list' \
-H "X-Toolswitch-Key: $TOOLSWITCH_KEY"import os
import requests
response = requests.request(
"GET",
"https://toolswitch.dev/v1/tools/youtube.x.youtube-comments-list",
headers={"X-Toolswitch-Key": os.environ["TOOLSWITCH_KEY"]},
)
response.raise_for_status()
print(response.text)const response = await fetch("https://toolswitch.dev/v1/tools/youtube.x.youtube-comments-list", {
method: "GET",
headers: {
"X-Toolswitch-Key": process.env.TOOLSWITCH_KEY ?? "",
},
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
console.log(await response.text());This gateway API is in preview; its URL and authentication may change. The example parameters are sample data. Calls are billed at free, including the service fee.