Returns the list of video comments with pagination.
Authentication
| Parameter | Type | Description |
|---|---|---|
link_id | path | Review link identifier |
token | query | User session token |
The token is required to access comments. This same token can be used to edit or delete comments that were created with it. The token can be the same value as link_id or a unique identifier generated by the application.
Example: 550e8400-e29b-41d4-a716-446655440000
Behavior
- Returns main comments with their nested replies
- Supports pagination via
pageandlimit - Allows filtering by
status(open/resolved) - If the link has
show_resolved: false, only open comments are returned
Response Structure
Comments are returned in hierarchical format, where each main comment contains a replies array with its responses.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
GET /public-video-review/{link_id}/comments
{link_id}/commentsLists comments on a video from the reviewer side, with pagination.
Authentication: session tokenPass the reviewer's
tokenUUID as a query parameter. Comments are returned in a hierarchical shape — each main comment carries itsrepliesarray.
Visibility honors the linkIf the link has
show_resolved: false, onlystatus=opencomments are returned (astatus=resolvedfilter on such a link returns 403).
HTTP Method & Path
GET /public-video-review/{link_id}/comments?token=<uuid>
Base URL: https://api-v2.pandavideo.com.br
Path Parameters
| Name | Type | Required | Description |
|---|---|---|---|
link_id | string (uuid) | yes | Review link UUID. |
Query Parameters
| Name | Type | Required | Description |
|---|---|---|---|
token | string (uuid) | yes | Reviewer session token. |
page | string | no | Page number, digits only (0–1000000). Default 1. |
limit | string | no | Items per page (1–100). Default 10. |
status | string | no | open or resolved. |
Response
Success Response (200)
{
"data": [
{
"id": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"video_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"user_name": "John Smith",
"text": "The audio is low in this section.",
"status": "open",
"time": 330,
"reply_to": null,
"created_at": "2025-01-15T10:30:00.000Z",
"updated_at": "2025-01-15T10:30:00.000Z",
"replies": [
{
"id": "c3d4e5f6-a7b8-9012-cdef-345678901234",
"video_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"user_name": "Mary Johnson",
"text": "I will adjust it in the next version.",
"status": "open",
"time": 330,
"reply_to": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
"created_at": "2025-01-15T11:00:00.000Z",
"updated_at": "2025-01-15T11:00:00.000Z"
}
]
}
],
"hasNextPage": false,
"totalPages": 1,
"page": 1,
"limit": 10,
"totalItens": 1
}Response Schema
| Field | Type | Description |
|---|---|---|
data[] | array | Main comments with nested replies. |
data[].id | string (uuid) | Comment UUID. |
data[].video_id | string (uuid) | Owning video. |
data[].user_name | string | Reviewer name. |
data[].text | string | Comment body. |
data[].status | string | open | resolved. |
data[].time | integer | Video timestamp in seconds. |
data[].reply_to | string | null | Parent comment UUID (null for top‑level). |
data[].created_at / updated_at | string (ISO date‑time) | Timestamps. |
data[].replies[] | array | Same shape as the parent. |
hasNextPage | boolean | More pages available. |
totalPages | integer | Total number of pages. |
page / limit | integer | Echo of pagination input. |
totalItens | integer | Total number of main comments (replies not counted). Spelled totalItens (one s) by the API. |
Error Responses
- 400 — invalid
page/limit/statusvalue. - 401 — missing/invalid
token. - 403 — link expired/inactive, or
status=resolvedrequested on a link withshow_resolved: false. - 404 — link not found.
- 500 — internal error.
Example Usage
cURL
curl --request GET \
--url 'https://api-v2.pandavideo.com.br/public-video-review/550e8400-e29b-41d4-a716-446655440000/comments?token=550e8400-e29b-41d4-a716-446655440000&page=1&limit=10'