Resource Information
| Method | GET |
|---|---|
| URL | https://public-api.wordpress.com/rest/v1.1/sites/$site/comment-counts |
| Requires authentication? | No |
Method Parameters
| Parameter | Type | Description |
|---|---|---|
| $site | (int|string) | Site ID or domain |
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| context | (string) |
|
| http_envelope | (bool) |
|
| pretty | (bool) |
|
| meta | (string) | Optional. Loads data from the endpoints found in the 'meta' part of the response. Comma-separated list. Example: meta=site,likes |
| fields | (string) | Optional. Returns specified fields only. Comma-separated list. Example: fields=ID,title |
| callback | (string) | An optional JSONP callback function. |
| post_id | (int) | post ID for filtering the comment counts by post |
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| all | (int) | Combined number of approved and unapproved comments |
| approved | (int) | Number of approved comments |
| pending | (int) | Number of unapproved comments |
| trash | (int) | Number of trash comments |
| spam | (int) | Number of spam comments |
| post_trashed | (int) | Number of comments whose parent post has been trashed |
| total_comments | (int) | Combined number of comments in each category |
Resource Errors
These are the possible errors returned by this endpoint.
| HTTP Code | Error Identifier | Error Message |
|---|---|---|
| 403 | authorization_required | An active access token must be used to retrieve comment counts. |
| 403 | authorization_required | You are not authorized to view comment counts for this blog. |
| 400 | invalid_input | Provided post_id does not exist |
| 403 | unauthorized | User cannot access this private blog. |
| 403 | unauthorized | User cannot access this restricted blog |
Example
curl 'https://public-api.wordpress.com/rest/v1/sites/en.blog.wordpress.com/comment-counts'
<?php
$options = array (
'http' =>
array (
'ignore_errors' => true,
),
);
$context = stream_context_create( $options );
$response = file_get_contents(
'https://public-api.wordpress.com/rest/v1/sites/en.blog.wordpress.com/comment-counts',
false,
$context
);
$response = json_decode( $response );
?>
