The id
field for the /PAGEPOST-ID/comments
endpoint will no longer be returned for apps using the Page Public Content Access feature. To access the id
field for comments for a Page post you must be able to perform the MODERATE task on the Page being queried. This change is in effect for v11.0+ and will be implement for all versions on September, 7, 2021.
Name | Description |
---|---|
Page Public Content Access | This feature permission may be required. |
GET
request to the /{page-post-id}/comments
edge:
Parameter | Description |
---|---|
filter enum{stream, toplevel} | Default value: toplevel SELF_EXPLANATORY |
live_filter enum{filter_low_quality, no_filter} | Default value: filter_low_quality For comments on a Live streaming video, this determines whether low quality comments will be filtered out of the results (filtering is enabled by default). In all other circumstances this parameter is ignored. |
order enum{chronological, reverse_chronological} | Preferred ordering of the comments. Accepts chronological (oldest first) and reverse chronological (newest first). If the comments can be ranked, then the order will always be ranked regardless of this modifier. The best practice for querying comments on a Live video is to continually poll for comments in the reversechronological ordering mode. |
since datetime | Lower bound of the time range to consider |
Reading from this edge will return a JSON formatted result:
{ "
data
": [], "paging
": {}, "summary
": {} }
data
paging
summary
Aggregated information about the edge, such as counts. Specify the fields to fetch in the summary param (like summary=order
).
Field | Description |
---|---|
order enum | Preferred ordering of the comments. Accepts chronological (oldest first) and reverse chronological (newest first). If the comments can be ranked, then the order will always be ranked regardless of this modifier. The best practice for querying comments on a Live video is to continually poll for comments in the reversechronological ordering mode. |
total_count unsigned int32 | Total number of people who commented |
can_comment bool | Can the viewer comment |
Error | Description |
---|---|
80001 | There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting. |
100 | Invalid parameter |
190 | Invalid OAuth 2.0 Access Token |
200 | Permissions error |
368 | The action attempted has been deemed abusive or is otherwise disallowed |
283 | That action requires the extended permission pages_read_engagement and/or pages_read_user_content and/or pages_manage_ads and/or pages_manage_metadata |
104 | Incorrect signature |
210 | User not visible |
2500 | Error parsing graph query |