List comments
curl --request GET \
--url https://api.refmatter.com/v1/comments \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.refmatter.com/v1/comments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.refmatter.com/v1/comments"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"object": "list",
"data": [
{
"object": "comment",
"id": "<string>",
"itemId": "<string>",
"parentId": "<string>",
"author": {
"object": "account",
"id": "<string>",
"platform": "youtube",
"handle": "<string>",
"name": "<string>",
"url": "<string>"
},
"authorIsCreator": true,
"text": "<string>",
"publishedAt": "<string>",
"publishedText": "<string>",
"stats": {
"likes": 4503599627370495,
"replies": 4503599627370495
},
"likesApproximate": true,
"pinned": true
}
],
"page": {
"nextCursor": "<string>",
"hasMore": true
},
"total": 4503599627370495,
"totalApproximate": true,
"account": {
"object": "account",
"id": "<string>",
"platform": "youtube",
"handle": "<string>",
"name": "<string>",
"url": "<string>"
},
"observedAt": "<string>",
"cached": true,
"usage": {
"creditsCharged": 4503599627370495,
"lines": [
{
"part": "fetch",
"credits": 4503599627370496
}
]
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}Comments
List comments
Costs 1 credit for a live page or the first serving of a stored page with at least one row; empty pages, errors and repeats within maxAge are free. YouTube videos only today; an item of another platform answers 422 with a hint.
GET
/
v1
/
comments
List comments
curl --request GET \
--url https://api.refmatter.com/v1/comments \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.refmatter.com/v1/comments', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.refmatter.com/v1/comments"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"object": "list",
"data": [
{
"object": "comment",
"id": "<string>",
"itemId": "<string>",
"parentId": "<string>",
"author": {
"object": "account",
"id": "<string>",
"platform": "youtube",
"handle": "<string>",
"name": "<string>",
"url": "<string>"
},
"authorIsCreator": true,
"text": "<string>",
"publishedAt": "<string>",
"publishedText": "<string>",
"stats": {
"likes": 4503599627370495,
"replies": 4503599627370495
},
"likesApproximate": true,
"pinned": true
}
],
"page": {
"nextCursor": "<string>",
"hasMore": true
},
"total": 4503599627370495,
"totalApproximate": true,
"account": {
"object": "account",
"id": "<string>",
"platform": "youtube",
"handle": "<string>",
"name": "<string>",
"url": "<string>"
},
"observedAt": "<string>",
"cached": true,
"usage": {
"creditsCharged": 4503599627370495,
"lines": [
{
"part": "fetch",
"credits": 4503599627370496
}
]
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}{
"error": {
"code": "invalid_input",
"message": "<string>",
"retryable": true,
"requestId": "<string>",
"details": {}
}
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Item selector: a natural key such as youtube:dQw4w9WgXcQ, or the item URL
Required string length:
1 - 2048Comment ordering
Available options:
top, newest Opaque cursor from a previous page
How fresh a stored page may be; default 15m
Pattern:
^(0|[1-9][0-9]{0,5}[mhd])$Response
One page of item comments
Allowed value:
"list"Maximum array length:
100Show child attributes
Show child attributes
Show child attributes
Show child attributes
Required range:
0 <= x <= 9007199254740991Show child attributes
Show child attributes
Pattern:
^\d{4}-(0[1-9]|1[0-2])-([0-2]\d|3[01])T([01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d{1,9})?(?:Z|[+-](?:[01]\d|2[0-3]):[0-5]\d)$Show child attributes
Show child attributes