GET /sites/$site/posts/$post_ID/likes/

Get a list of the likes for a post.

Resource Information

   
Method GET
URL https://public-api.wordpress.com/rest/v1.1/sites/$site/posts/$post_ID/likes/
Requires authentication? No

Method Parameters

Parameter Type Description
$site (int|string) Site ID or domain
$post_ID (int) The post ID

Query Parameters

Parameter Type Description
http_envelope (bool)
false:
(default)
true:
Some environments (like in-browser JavaScript or Flash) block or divert responses with a non-200 HTTP status code. Setting this parameter will force the HTTP status code to always be 200. The JSON response is wrapped in an "envelope" containing the "real" HTTP status code and headers.
pretty (bool)
false:
(default)
true:
Output pretty JSON
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.

Response Parameters

Parameter Type Description
found (int) The total number of likes for this post.
i_like (bool) If authenticated, this returns the current like status for the user on this post.
can_like (bool) True if this post can be liked
site_ID (int) The site ID
post_ID (int) The post ID
likes (array) An array of users who liked this post.

Resource Errors

These are the possible errors returned by this endpoint.

HTTP Code Error Identifier Error Message
403 unauthorized User cannot view post
403 unauthorized User cannot access this private blog.
403 unauthorized User cannot access this restricted blog
404 unknown_post Unknown post
400 invalid_number The NUMBER parameter must be less than or equal to 100.

Example

curl 'https://public-api.wordpress.com/rest/v1/sites/example.wordpress.com/posts/1/likes/'
<?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/example.wordpress.com/posts/1/likes/',
	false,
	$context
);
$response = json_decode( $response );
?>

Response

{
    "found": 30,
    "i_like": false,
    "can_like": true,
    "site_ID": 2916284,
    "post_ID": 1,
    "likes": [
        {
            "ID": 10946404,
            "login": "tildaf",
            "email": false,
            "name": "Matilda Flodin",
            "first_name": "Matilda",
            "last_name": "Flodin",
            "nice_name": "tildaf",
            "URL": "http:\/\/tildaf.wordpress.com",
            "avatar_URL": "https:\/\/2.gravatar.com\/avatar\/214b1efa3a22dfb6188233cc6927da67?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/tildaf",
            "ip_address": false,
            "site_ID": 10641115,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 20668049,
            "login": "yusufrhj",
            "email": false,
            "name": "Muhamad Yusup",
            "first_name": "Muhamad",
            "last_name": "Yusup",
            "nice_name": "yusufrhj",
            "URL": "http:\/\/makalahsekolah.wordpress.com",
            "avatar_URL": "https:\/\/0.gravatar.com\/avatar\/93b4a5a3b14971f444286260db20cb24?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/yusufrhj",
            "ip_address": false,
            "site_ID": 20080724,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 22176418,
            "login": "gemian",
            "email": false,
            "name": "dian pratama",
            "first_name": "dian",
            "last_name": "putra",
            "nice_name": "gemian",
            "URL": "http:\/\/pratagemian.wordpress.com",
            "avatar_URL": "https:\/\/2.gravatar.com\/avatar\/584bab593c374c0d9f6278fddc15049c?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/gemian",
            "ip_address": false,
            "site_ID": 21650596,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 24879195,
            "login": "charlesdusty10",
            "email": false,
            "name": "charlesdusty10",
            "first_name": "Charles",
            "last_name": "Dusty",
            "nice_name": "charlesdusty10",
            "URL": "http:\/\/charlesdusty10.wordpress.com",
            "avatar_URL": "https:\/\/2.gravatar.com\/avatar\/ed349bb52743ee0464077c2541bc7509?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/charlesdusty10",
            "ip_address": false,
            "default_avatar": false
        },
        {
            "ID": 25391862,
            "login": "femasmarvendra",
            "email": false,
            "name": "femasmarvendra",
            "first_name": "Femas",
            "last_name": "Femas",
            "nice_name": "femasmarvendra",
            "URL": "http:\/\/femasmarvendra.wordpress.com",
            "avatar_URL": "https:\/\/1.gravatar.com\/avatar\/4daceca922acd4ef629aef553d3916a6?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/femasmarvendra",
            "ip_address": false,
            "site_ID": 25483937,
            "site_visible": true,
            "default_avatar": true
        },
        {
            "ID": 26523905,
            "login": "cescastar5",
            "email": false,
            "name": "cescastar5",
            "first_name": "",
            "last_name": "",
            "nice_name": "cescastar5",
            "URL": "http:\/\/cescastar5.wordpress.com",
            "avatar_URL": "https:\/\/1.gravatar.com\/avatar\/72e3d49c7f81060766b0496185c080c4?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/cescastar5",
            "ip_address": false,
            "site_ID": 26978877,
            "site_visible": false,
            "default_avatar": false
        },
        {
            "ID": 29076106,
            "login": "jwellwin",
            "email": false,
            "name": "jwellwin",
            "first_name": "Wellwin",
            "last_name": "John",
            "nice_name": "jwellwin",
            "URL": "http:\/\/theamateurone.wordpress.com\/",
            "avatar_URL": "https:\/\/2.gravatar.com\/avatar\/eb50ec84a93f959e378dd65066d57e96?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/jwellwin",
            "ip_address": false,
            "site_ID": 62411637,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 30089109,
            "login": "hf556",
            "email": false,
            "name": "hf556",
            "first_name": "",
            "last_name": "",
            "nice_name": "hf556",
            "URL": "http:\/\/binweevilcompany.wordpress.com",
            "avatar_URL": "https:\/\/2.gravatar.com\/avatar\/2f4294b173b5172ef0d5b711c27fb1bb?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/hf556",
            "ip_address": false,
            "site_ID": 50643431,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 32825362,
            "login": "psiepsilon",
            "email": false,
            "name": "psiepsilon",
            "first_name": "Psi",
            "last_name": "Epsilon",
            "nice_name": "psiepsilon",
            "URL": "http:\/\/psiepsilon.wordpress.com",
            "avatar_URL": "https:\/\/1.gravatar.com\/avatar\/1aaa202365e2d4dcc3569e850352b834?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/psiepsilon",
            "ip_address": false,
            "site_ID": 94936614,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 42144909,
            "login": "prinzecharming",
            "email": false,
            "name": "Prinze Charming",
            "first_name": "Anthony",
            "last_name": "Terragna",
            "nice_name": "prinzecharming",
            "URL": "http:\/\/www.prinzecharming.com",
            "avatar_URL": "https:\/\/1.gravatar.com\/avatar\/df5fbbe123e17558c67d518ccaea9573?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/prinzecharming",
            "ip_address": false,
            "site_ID": 42717098,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 45452212,
            "login": "charlevy",
            "email": false,
            "name": "charlevy",
            "first_name": "Pierre",
            "last_name": "Edmond",
            "nice_name": "charlevy",
            "URL": "http:\/\/charlevy.wordpress.com",
            "avatar_URL": "https:\/\/2.gravatar.com\/avatar\/869e8b27f3a90a6bf73c660ba9bfdd88?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/charlevy",
            "ip_address": false,
            "site_ID": 46277737,
            "site_visible": true,
            "default_avatar": true
        },
        {
            "ID": 45796856,
            "login": "kg2tw",
            "email": false,
            "name": "Websiteguy's Plugins",
            "first_name": "",
            "last_name": "",
            "nice_name": "websiteguysplugins-2",
            "URL": "http:\/\/www.websiteguystplugins.wordpress.com",
            "avatar_URL": "https:\/\/2.gravatar.com\/avatar\/2a116ddb1dbb4bd63dd24b8e84e69257?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/kg2tw",
            "ip_address": false,
            "site_ID": 58533737,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 47279936,
            "login": "fategg2511",
            "email": false,
            "name": "FatEgg2511",
            "first_name": "Faith",
            "last_name": "Tan",
            "nice_name": "fategg2511",
            "URL": "http:\/\/fateggsareawesome.wordpress.com",
            "avatar_URL": "https:\/\/1.gravatar.com\/avatar\/7eba35c8cadd92dcd70952c10b0ad348?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/fategg2511",
            "ip_address": false,
            "site_ID": 48465336,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 47993692,
            "login": "elseygirl",
            "email": false,
            "name": "elseygirl",
            "first_name": "",
            "last_name": "",
            "nice_name": "elseygirl",
            "URL": "http:\/\/goodreadsblog.wordpress.com",
            "avatar_URL": "https:\/\/1.gravatar.com\/avatar\/130d5978b8d2523abfff5f492658e9f3?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/elseygirl",
            "ip_address": false,
            "site_ID": 49391156,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 48307503,
            "login": "liubishazdravkovich",
            "email": false,
            "name": "liubishazdravkovich",
            "first_name": "Krasimira",
            "last_name": "Dankova",
            "nice_name": "liubishazdravkovich",
            "URL": "http:\/\/bestseller21vek.wordpress.com",
            "avatar_URL": "https:\/\/0.gravatar.com\/avatar\/9c94251a6bbb7b5ef939f43780ecd4c0?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/liubishazdravkovich",
            "ip_address": false,
            "site_ID": 49792835,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 50869561,
            "login": "nanaiury",
            "email": false,
            "name": "nanaiury",
            "first_name": "nan",
            "last_name": "yeon ha",
            "nice_name": "nanaiury",
            "URL": "http:\/\/nanandae.wordpress.com",
            "avatar_URL": "https:\/\/0.gravatar.com\/avatar\/3b05ddcb52ac7e2d9907fc55feb5b9b6?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/nanaiury",
            "ip_address": false,
            "site_ID": 53066216,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 53864328,
            "login": "scaryplug",
            "email": false,
            "name": "Sc\u03b1\u044f\u2442 P\u029fu\u2761 \u534c",
            "first_name": "Scary",
            "last_name": "Plug",
            "nice_name": "scaryplug",
            "URL": "http:\/\/poptropicawithscaryplug.wordpress.com",
            "avatar_URL": "https:\/\/1.gravatar.com\/avatar\/11b17c2192eacef0619c4db2cb738ac0?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/scaryplug",
            "ip_address": false,
            "default_avatar": false
        },
        {
            "ID": 55508653,
            "login": "chiegustifitria",
            "email": false,
            "name": "chiegustifitria",
            "first_name": "Gustifitria",
            "last_name": "Snowy",
            "nice_name": "chiegustifitria",
            "URL": "http:\/\/chiegustifitria.wordpress.com",
            "avatar_URL": "https:\/\/1.gravatar.com\/avatar\/d65638cfa27af84de06193160c8f26ef?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/chiegustifitria",
            "ip_address": false,
            "site_ID": 58067797,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 56028978,
            "login": "djzinfumusical",
            "email": false,
            "name": "Djzinfumusical.net",
            "first_name": "",
            "last_name": "",
            "nice_name": "djzinfumusical",
            "URL": "http:\/\/GIRASOLE\u00d1OFLOW.NET",
            "avatar_URL": "https:\/\/0.gravatar.com\/avatar\/39358cf55afa3384d3d70768e7881794?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/djzinfumusical",
            "ip_address": false,
            "site_ID": 60069997,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 57028283,
            "login": "erynabakery",
            "email": false,
            "name": "Cik na",
            "first_name": "Eryna",
            "last_name": "cikna",
            "nice_name": "erynabakery",
            "URL": "http:\/\/erynagift.wordpress.com",
            "avatar_URL": "https:\/\/0.gravatar.com\/avatar\/cdb516bb3e033bdade17e22c310f7f77?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/erynabakery",
            "ip_address": false,
            "site_ID": 59636052,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 57619773,
            "login": "jamessinach",
            "email": false,
            "name": "jamessinach",
            "first_name": "Anuforo",
            "last_name": "James",
            "nice_name": "jamessinach",
            "URL": "http:\/\/www.sinach4entertainment.com",
            "avatar_URL": "https:\/\/2.gravatar.com\/avatar\/2ba56e86582e88746811bbbad54eeeff?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/jamessinach",
            "ip_address": false,
            "site_ID": 60232275,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 57924559,
            "login": "federica3101",
            "email": false,
            "name": "federica3101",
            "first_name": "Federica",
            "last_name": "",
            "nice_name": "federica3101",
            "URL": "http:\/\/ithinkthatiknow.wordpress.com",
            "avatar_URL": "https:\/\/0.gravatar.com\/avatar\/6431a1cc4c9cba294fadb5628fa7e5d9?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/federica3101",
            "ip_address": false,
            "default_avatar": false
        },
        {
            "ID": 58076001,
            "login": "corsa1972",
            "email": false,
            "name": "corsa1972",
            "first_name": "",
            "last_name": "",
            "nice_name": "corsa1972",
            "URL": "http:\/\/corsa1972.wordpress.com",
            "avatar_URL": "https:\/\/0.gravatar.com\/avatar\/cd84e5f609c929261012d57fe4a3a6c2?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/corsa1972",
            "ip_address": false,
            "site_ID": 60676021,
            "site_visible": true,
            "default_avatar": true
        },
        {
            "ID": 60373862,
            "login": "eaglenebula06",
            "email": false,
            "name": "Stoatpaw",
            "first_name": "",
            "last_name": "",
            "nice_name": "eaglenebula06",
            "URL": "http:\/leftyandmo.wordpress.com",
            "avatar_URL": "https:\/\/0.gravatar.com\/avatar\/f08aeb41c5f32013391a099d876f7abf?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/eaglenebula06",
            "ip_address": false,
            "site_ID": 136494446,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 60785675,
            "login": "ahmadtamer2006",
            "email": false,
            "name": "ahmadtamer2006",
            "first_name": "ahmad",
            "last_name": "tamer",
            "nice_name": "ahmadtamer2006",
            "URL": "http:\/\/ahmadtamer2006.wordpress.com",
            "avatar_URL": "https:\/\/2.gravatar.com\/avatar\/5c7b5e192551b579988a4a9836910610?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/ahmadtamer2006",
            "ip_address": false,
            "site_ID": 63524705,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 71634990,
            "login": "xhonxhon3x",
            "email": false,
            "name": "xhonxhon3x",
            "first_name": "",
            "last_name": "",
            "nice_name": "xhonxhon3x",
            "URL": "http:\/\/neserpasneser.wordpress.com",
            "avatar_URL": "https:\/\/1.gravatar.com\/avatar\/16fabbb0fd2cd202035756d543deb896?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/xhonxhon3x",
            "ip_address": false,
            "site_ID": 74969713,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 79979691,
            "login": "asma2010must",
            "email": false,
            "name": "Asma Aslam",
            "first_name": "Asma",
            "last_name": "Aslam",
            "nice_name": "asma2010must",
            "URL": "http:\/\/beautiesofpeople.com",
            "avatar_URL": "https:\/\/1.gravatar.com\/avatar\/d02a9d6971120b9014b6a143285ba2ed?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/asma2010must",
            "ip_address": false,
            "site_ID": 84079080,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 84324674,
            "login": "cnvaughn",
            "email": false,
            "name": "cnvaughn",
            "first_name": "Casey",
            "last_name": "Vaughn",
            "nice_name": "cnvaughn",
            "URL": "http:\/\/adventuresinholiness.wordpress.com",
            "avatar_URL": "https:\/\/2.gravatar.com\/avatar\/8cca7fd3fd331ba11687e1c6b2927d66?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/cnvaughn",
            "ip_address": false,
            "site_ID": 88713126,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 87203424,
            "login": "estudiobisio",
            "email": false,
            "name": "Carlos Bisio",
            "first_name": "Carlos",
            "last_name": "Bisio",
            "nice_name": "estudiobisio",
            "URL": "http:\/\/estudiobisio.wordpress.com",
            "avatar_URL": "https:\/\/1.gravatar.com\/avatar\/aa1496515120c11b5de25b3b04f92fe0?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/estudiobisio",
            "ip_address": false,
            "site_ID": 91756313,
            "site_visible": true,
            "default_avatar": false
        },
        {
            "ID": 87832698,
            "login": "muhammadmurtadha",
            "email": false,
            "name": "adexmild",
            "first_name": "Muhammad",
            "last_name": "Murtadha",
            "nice_name": "muhammadmurtadha",
            "URL": "http:\/\/adexmild.wordpress.com",
            "avatar_URL": "https:\/\/0.gravatar.com\/avatar\/0369b2b9ad06146542f8bd3c74afa40f?s=96&d=identicon&r=G",
            "profile_URL": "https:\/\/en.gravatar.com\/muhammadmurtadha",
            "ip_address": false,
            "site_ID": 92427216,
            "site_visible": true,
            "default_avatar": false
        }
    ]
}