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:\/\/0.gravatar.com\/avatar\/61d920dfb6d12ac0f2479571d8f9ae6bec4b57695125199006c659f756b86c40?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:\/\/1.gravatar.com\/avatar\/74386d795e0ab5e09808029386babfc4b518bb69775da6a16a53cd35327bedae?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:\/\/0.gravatar.com\/avatar\/c4c73312103a36ec5898ece94e07b858600567ca6f729732ac849166d76239c4?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:\/\/0.gravatar.com\/avatar\/09ce3d602237d43f4b403b72a72bfc6f6abd50f776b5040a691ce1ee074d3b20?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:\/\/0.gravatar.com\/avatar\/6745318f61c09abc36fd916b144b5296939311ccf2e43390ca7171dcffaf626b?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:\/\/2.gravatar.com\/avatar\/b92c65ffa76d6138c2774e6dd03f25eafdd8613e1453ad71ed2f63bcc6069c9e?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:\/\/0.gravatar.com\/avatar\/0cfef1789ab1017e57c82d919961fac282f24fa03b24d9320ed9950bddd48821?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:\/\/0.gravatar.com\/avatar\/6d9c0da61088fb4a24ff29ee7fdb134c1ce639732a386633ef0a419ad7a36169?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:\/\/0.gravatar.com\/avatar\/9f2560cf6aad159cb7575abe35b2cd25d005a9a1e4d7ac0c43e6e9b3ac8e0d59?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:\/\/2.gravatar.com\/avatar\/5cc87b1fe4855d477155b9fe8f734ca9cf87550b0126f8ab96a68fc49c4d7550?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:\/\/0.gravatar.com\/avatar\/f223ffb897ff3aae08801136d64191d594e4a2ad9d9ad57df84cbd9f38e66595?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\/5770e2e2507a453eff759735723bc349914972148bf4b01db5f58ff015c49729?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:\/\/2.gravatar.com\/avatar\/5a8b486f053ce462a9ae7d960c4f422691956cc4c5e71db6af17c2bb7cfe4b93?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\/a73cc9923b4e5825bf2b9ac2bc9c596ce7711728475029c78ab3aaf7ad685ba6?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\/6a4d054d194e682e3abf5e23c6c9633b4c56677d345ef387e4f09c19d43054a8?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\/cc8d49aaad409a404f6c5c3f803bd016847e8b9c13c9ea535706c04921cc07cb?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\/10d54a30a29f2773d641a30f4cfa3a557553b4b35c48715551e639afed2dd21c?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:\/\/2.gravatar.com\/avatar\/5c027eb2698372ee686ea1f8b0c35c67bd02ec2cd015028498872817025a1133?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\/966bad9721ff8cf007e00a101aa09fab41dacf612d0a48cb0ffcc8a35a18300f?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:\/\/1.gravatar.com\/avatar\/482a847be111f08f70f64a04a9c888cc07cabd6f0831ac03cf26fe2d95852d24?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:\/\/0.gravatar.com\/avatar\/9e0d5e3d9385e73ce3ab8f076b93eb84319f70bb8398e234ff3f425b92c57d64?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\/999a64dabe303b1c631137fd95eff4eee2b67e4b15a822d07f240b02f582ff55?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:\/\/2.gravatar.com\/avatar\/b92ffdabefe56f0945320f5aeadebdaeac0563c3f5b1e0082f1556f58c310636?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:\/\/1.gravatar.com\/avatar\/4a58ed9548fac5d54ce893329faba84fa3a560cfb723271a875dba739e236b79?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\/20576c370544b6a2bae5cb4b5e8dfd7273e4c94a096fb697173f4bc7dff91c7b?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:\/\/2.gravatar.com\/avatar\/b0669d09aa615a97cdaceb7ba925f5a666b5c835c35aab858896e41e7bc60489?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:\/\/2.gravatar.com\/avatar\/e53191bd5ae5f8e149fcf99e206aa1ffb1dbc8987eccd6398d33682680c90995?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:\/\/1.gravatar.com\/avatar\/d0043e799d7f73eff707cc8b434d2a3a25f151659bfb7175b0750cacc1c4945c?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:\/\/2.gravatar.com\/avatar\/21b053f9580d41eb81831819eaa89757eebdba350ee904d5b3a9e7a2b33e70cb?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:\/\/1.gravatar.com\/avatar\/1448a7f1c836dfbd29ece7bb08024500051b21373126a9c87ac2e9e71d6eb0af?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
        }
    ]
}