List comments across the channel's videos (newest thread first, replies inline), one video's comments, or the replies to one comment

GET
/v1/content/youtube.videos.comments

List comments across the channel's videos (newest thread first, replies inline), one video's comments, or the replies to one comment.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Query Parameters

connectedProfileId*string

Koil Connected Profile associated with the operation.

Length1 <= length
mediaExternalId?string

Only this video's comments; every video of the channel otherwise.

Length1 <= length
parentExternalId?string

The replies to this top-level comment instead of the threads.

Length1 <= length
moderationStatus?||

Which of YouTube's queues to read; defaults to published. Ignored with parentExternalId.

searchTerms?string

Only threads containing these terms. Ignored with parentExternalId.

Length1 <= length
cursor?string

Opaque cursor for fetching the next result page.

Length1 <= length
limit?number

Maximum number of items to return.

Range1 <= value
includeProviderRaw?boolean

Whether to include transient provider-native payloads.

Response Body

application/json

application/json

curl -X GET "https://example.com/v1/content/youtube.videos.comments?connectedProfileId=string"
{  "data": [    {      "externalId": "string",      "mediaExternalId": "string",      "text": "string",      "author": {        "id": "string",        "displayName": "string",        "username": "string"      },      "authorProfileImageUrl": "string",      "thread": {        "parentId": "string",        "rootId": "string",        "threadId": "string"      },      "moderationStatus": "published",      "engagement": {        "views": 0,        "likes": 0,        "comments": 0      },      "providerPermalink": "http://example.com",      "publishedAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z",      "providerRaw": null,      "contentType": "youtube.videos.comments"    }  ],  "nextCursor": "string",  "hasMore": true}
{  "error": {    "code": "validation_error",    "message": "string",    "meta": {      "property1": null,      "property2": null    }  }}