GET /read/liked/

Get a list of posts from the blogs a user likes.

Resource URL

Type URL and Format
GET https://public-api.wordpress.com/rest/v1.1/read/liked/

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.
number (int) The number of posts to return. Limit: 40. Default: 10.
page (int) Return the Nth 1-indexed page of posts.
order (string)
DESC:
(default) Return posts in descending order. For dates, that means newest to oldest.
ASC:
Return posts in ascending order. For dates, that means oldest to newest.
after (iso 8601 datetime) Return posts dated after the specified datetime.
before (iso 8601 datetime) Return posts dated before the specified datetime.

Response Parameters

Parameter Type Description
ID (int) The post ID.
site_ID (int) The site ID.
author (object) The author of the post.
date (iso 8601 datetime) The post's creation time.
modified (iso 8601 datetime) The post's most recent update time.
title (html) context dependent.
URL (url) The full permalink URL to the post.
short_URL (url) The wp.me short URL.
content (html) context dependent.
excerpt (html) context dependent.
slug (string) The name (slug) for the post, used in URLs.
guid (string) The GUID for the post.
status (string)
publish:
The post is published.
draft:
The post is saved as a draft.
pending:
The post is pending editorial approval.
private:
The post is published privately
future:
The post is scheduled for future publishing.
trash:
The post is in the trash.
auto-draft:
The post is a placeholder for a new post.
sticky (bool) Is the post sticky?
password (string) The plaintext password protecting the post, or, more likely, the empty string if the post is not password protected.
parent (object|false) A reference to the post's parent, if it has one.
type (string) The post's post_type. Post types besides post, page and revision need to be whitelisted using the rest_api_allowed_post_types filter.
comments_open (bool) Is the post open for comments?
pings_open (bool) Is the post open for pingbacks, trackbacks?
likes_enabled (bool) Is the post open to likes?
sharing_enabled (bool) Should sharing buttons show on this post?
comment_count (int) The number of comments for this post.
like_count (int) The number of likes for this post.
i_like (bool) Does the current user like this post?
is_reblogged (bool) Did the current user reblog this post?
is_following (bool) Is the current user following this blog?
global_ID (string) A unique WordPress.com-wide representation of a post.
featured_image (url) The URL to the featured image for this post if it has one.
post_thumbnail (object) The attachment object for the featured image if it has one.
format (string)
standard:
Standard
aside:
Aside
chat:
Chat
gallery:
Gallery
link:
Link
image:
Image
quote:
Quote
status:
Status
video:
Video
audio:
Audio
geo (object|false)
menu_order (int) (Pages Only) The order pages should appear in.
publicize_URLs (array) Array of Twitter and Facebook URLs published by this post.
tags (object) Hash of tags (keyed by tag name) applied to the post.
categories (object) Hash of categories (keyed by category name) applied to the post.
attachments (object) Hash of post attachments (keyed by attachment ID).
metadata (array) Array of post metadata keys and values. All unprotected meta keys are available by default for read requests. Both unprotected and protected meta keys are available for authenticated requests with access. Protected meta keys can be made available with the rest_api_allowed_public_metadata filter.
meta (object) API result meta data
current_user_can (object) List of permissions. Note, deprecated in favor of `capabilities`
capabilities (object) List of post-specific permissions for the user; publish_post, edit_post, delete_post
date_range (object) date range covered by current results.
number (int) The number of posts brought back by current query.
posts (array) An array of post objects.

Example

cURL

curl \
 -H 'authorization: Bearer YOUR_API_TOKEN' \
 'https://public-api.wordpress.com/rest/v1/read/liked/?number=2&pretty=1'

PHP

<?php

$options  = array (
  'http' => 
  array (
    'ignore_errors' => true,
    'header' => 
    array (
      0 => 'authorization: Bearer YOUR_API_TOKEN',
    ),
  ),
);

$context  = stream_context_create( $options );
$response = file_get_contents(
  'https://public-api.wordpress.com/rest/v1/read/liked/?number=2&pretty=1',
  false,
  $context
);
$response = json_decode( $response );

?>

Response Body

	{
		"date_range": {
			"before": "2015-01-10T02:40:58+00:00",
			"after": "2014-12-22T23:55:56+00:00"
		},
		"number": 2,
		"posts": [
			{
				"ID": 13761,
				"site_ID": 33534099,
				"author": {
					"ID": 41605250,
					"login": "jonathansadowski",
					"email": false,
					"name": "Jonathan Sadowski",
					"nice_name": "jonathansadowski",
					"URL": "",
					"avatar_URL": "https://1.gravatar.com/avatar/7ea858b8bf89cb212a152c14238c4d42?s=96&d=identicon&r=G",
					"profile_URL": "http://en.gravatar.com/jonathansadowski",
					"site_ID": 48921299
				},
				"date": "2015-01-06T22:00:40+00:00",
				"modified": "2015-01-06T22:00:40+00:00",
				"title": "Version 1.1 of the WordPress.com REST API",
				"URL": "https://developer.wordpress.com/2015/01/06/rest-api-v1-1/",
				"short_URL": "http://wp.me/p2gHKz-3zX",
				"content": "<p>Today, we&#8217;ve launched version 1.1 of the WordPress.com REST API. In recent weeks, we&#8217;ve been hard at work launching new features on WordPress.com, and many of these changes are powered by our REST API. When we started working on the upgrades to <a href=\"http://en.blog.wordpress.com/2014/12/09/stats-navigation-enhancements/\">stats</a> and <a href=\"http://en.blog.wordpress.com/2014/12/16/dashboard-update/\">post management</a>, we quickly realized that the existing endpoints didn&#8217;t have all the power we needed to provide the best experience. In order to add the functionality we needed to the API without breaking existing implementations, we decided to version our API.</p>\n<h2>What does this mean for you?</h2>\n<p>If you&#8217;re already implementing version 1 of the API, you&#8217;ll be able to continue using those endpoints without changing your code for the foreseeable future. Version 1 of the API is now deprecated, so any new development you do should be against 1.1. We currently have no plans to disable version 1 of the REST API — should we ever decide to do so, we&#8217;ll give you plenty of advanced notice.</p>\n<h2>Media Endpoints</h2>\n<ul>\n<li>Upload support for all file types. If you can you upload it though the media explorer, you can upload it with the API. PDFs, Docs, Powerpoints, Audio files, and Videos (Jetpack &amp; .com blogs with VideoPress) are all supported.</li>\n<li>Better error handling. If you upload multiple files and some fail, it&#8217;s easier to pull those out and retry.</li>\n<li>Improved consistency with other endpoints and cleaned up response parameters.</li>\n<li>When uploading files, you can now pass attributes like name and description without needing to do a second call to the update endpoint.</li>\n<li>Bonus: The <code>/sites/$site/</code> endpoint now returns a list of allowed file types.</li>\n</ul>\n<h2>Stats Endpoints</h2>\n<ul>\n<li>Support for pulling back stats over multiple days without those stats being grouped into a single result.</li>\n<li>New stats detailing the top comment authors on your site, as well as the posts that have received the most comments.</li>\n<li>In addition to chart data for views and visitors: chartable data about likes and comments.</li>\n<li>Keep on track with your posting goals. The new streak endpoint contains the data to help motivate you to post more often.</li>\n</ul>\n<p>We&#8217;re looking forward to seeing what you build using version 1.1. Take a look at the <a href=\"https://developer.wordpress.com/docs/api/\">REST API documentation</a> to get started. If you have any questions about the API, don&#8217;t hesitate to comment below or reach out to us via our <a title=\"Contact\" href=\"https://developer.wordpress.com/contact/\">developer contact form</a>.</p>\n",
				"excerpt": "<p>Today, we&#8217;ve launched version 1.1 of the WordPress.com REST API. In recent weeks, we&#8217;ve been hard at work launching new features on WordPress.com, and many of these changes are powered by our REST API. When we started working on the upgrades to stats and post management, we quickly realized that the existing endpoints didn&#8217;t have all the [&hellip;]</p>\n",
				"slug": "rest-api-v1-1",
				"guid": "https://developer.wordpress.com/?p=13761",
				"status": "publish",
				"sticky": false,
				"password": "",
				"parent": false,
				"type": "post",
				"comments_open": true,
				"pings_open": true,
				"likes_enabled": true,
				"sharing_enabled": true,
				"comment_count": 1,
				"like_count": 17,
				"i_like": 1,
				"is_reblogged": 0,
				"is_following": 1,
				"global_ID": "75d60fe5eafc53b04358a3966101be50",
				"featured_image": "",
				"post_thumbnail": null,
				"format": "standard",
				"geo": false,
				"menu_order": 0,
				"publicize_URLs": [],
				"tags": {},
				"categories": {
					"APIs": {
						"ID": 40428,
						"name": "APIs",
						"slug": "apis",
						"description": "",
						"post_count": 12,
						"parent": 0,
						"meta": {
							"links": {
								"self": "https://public-api.wordpress.com/rest/v1/sites/33534099/categories/slug:apis",
								"help": "https://public-api.wordpress.com/rest/v1/sites/33534099/categories/slug:apis/help",
								"site": "https://public-api.wordpress.com/rest/v1/sites/33534099"
							}
						}
					}
				},
				"attachments": {},
				"metadata": [
					{
						"id": "112797",
						"key": "email_notification",
						"value": "1420581643"
					},
					{
						"id": "78966",
						"key": "geo_public",
						"value": "0"
					},
					{
						"id": "112794",
						"key": "publicize_twitter_url",
						"value": "http://t.co/jrtqpCXAtz"
					},
					{
						"id": "112793",
						"key": "publicize_twitter_user",
						"value": "AutomatticEng"
					},
					{
						"id": "111091",
						"key": "superawesome",
						"value": "false"
					}
				],
				"meta": {
					"links": {
						"self": "https://public-api.wordpress.com/rest/v1/sites/33534099/posts/13761",
						"help": "https://public-api.wordpress.com/rest/v1/sites/33534099/posts/13761/help",
						"site": "https://public-api.wordpress.com/rest/v1/sites/33534099",
						"replies": "https://public-api.wordpress.com/rest/v1/sites/33534099/posts/13761/replies/",
						"likes": "https://public-api.wordpress.com/rest/v1/sites/33534099/posts/13761/likes/"
					}
				},
				"current_user_can": {
					"publish_post": true,
					"delete_post": true,
					"edit_post": true
				},
				"capabilities": {
					"publish_post": true,
					"delete_post": true,
					"edit_post": true
				},
				"pseudo_ID": "75d60fe5eafc53b04358a3966101be50",
				"is_external": false,
				"site_name": "Developer Resources",
				"site_URL": "https://developer.wordpress.com",
				"site_is_private": false,
				"featured_media": {},
				"date_liked": "2015-01-07T20:35:50+00:00"
			},
			{
				"ID": 1361,
				"site_ID": 60451524,
				"author": {
					"ID": 422,
					"login": "justin",
					"email": false,
					"name": "Justin Shreve",
					"nice_name": "justin",
					"URL": "http://justin.gs",
					"avatar_URL": "https://0.gravatar.com/avatar/9ea5b460afb2859968095ad3afe4804b?s=96&d=retro&r=G",
					"profile_URL": "http://en.gravatar.com/justin",
					"site_ID": 60451524
				},
				"date": "2015-01-01T13:51:50-05:00",
				"modified": "2015-01-01T13:51:50-05:00",
				"title": "Twenty Fifteen",
				"URL": "http://binarysmash.com/2015/01/01/twenty-fifteen/",
				"short_URL": "http://wp.me/p45EcA-lX",
				"content": "<p>January 1st! Happy New Years, dear readers <span class="wp-smiley wp-emoji wp-emoji-smile" title=":)">:)</span>.</p>\n<p>It&#8217;s time to reflect on last years goals and set some new ones. If you allow me some flexibility with my resolutions from last year &#8211; I think I met a good deal of them.</p>\n<p><strong>Let&#8217;s take a look..</strong></p>\n<blockquote><p>Now that I’m finished with my undergraduate degree, and I’m no longer tied to one place, my goal is to be completely moved to NYC by the end of the spring. I will be heading there in February to secure a place. This will be the first time I’ve lived anywhere but Kent… and I don’t plan on going back.</p></blockquote>\n<p>If I amend that goal to read &#8220;get out of Ohio and move somewhere&#8221; than I did that. Instead of moving ~6 hours to the big city, I moved across the country to Oregon instead. That is pretty big. I didn&#8217;t end up moving to a giant city (I&#8217;m south of Portland but in a smaller city). I did get a house instead of a tiny studio apartment. That&#8217;s a win and the cats appreciate it.</p>\n<blockquote><p>I’ve been putting some thought into this and I plan on continuing school to get my master’s degree.</p></blockquote>\n<p>I was accepted into the program &#8211; so I think I should get a little credit for this one <span class="wp-smiley wp-emoji wp-emoji-wink" title=";)">;)</span>. I ended up deferring to spring because of the move and then ultimately decided not to do the program.  One of the reasons is because I became a team lead at Automattic (WordPress.com) which has taught me a lot itself. I also feel like it would be hard to balance a new degree with a new role. However, if I change this goal to &#8220;advance professionally&#8221; you can check this one of off!</p>\n<blockquote><p>My third goal is to <a href=\"http://binarysmash.com/2013/12/26/write-every-day/\">write each and everyday</a>. That means that I should have at least 356 blog posts by the end of next year.</p></blockquote>\n<p>I have nothing to say for this one. I failed <span class="wp-smiley wp-emoji wp-emoji-smile" title=":)">:)</span>. It turns out blogging is really really hard. I&#8217;ll keep writing though &#8211; I still think it is a fantastic outlet for everyone.</p>\n<blockquote><p>The fourth and final goal relates to moving. I hope to make as many new friends and meet as many new people as I can. I’m starting over in a completely new place where I will know next to no one and I will need to make new local friends. I want to take use of as many opportunities as I can to meet people (such as doing improv classes). I don’t want to waste a moment. Who knows.. maybe I’ll even <a href=\"http://binarysmash.com/2013/11/26/what-ive-learned-from-being-alone/\">meet someone</a>.</p></blockquote>\n<p>This can be marked as resolved without further edit. I went on a date with a wonderful person named Andrea 3 days after moving out here. We&#8217;ve been together ~4 months now. I also rang in the new year last night with a group of awesome people that I met entirely here. I also have Kristyn and Anthony who moved out here with me. I feel like I have a pretty good social circle here &#8212; and still have friends in other places that I video chat or play games with often.</p>\n<p><strong>So what about next year?</strong></p>\n<p>I&#8217;m not a firm believer that new years day is some magic construct that gives you a fresh start&#8230; you are still the same person once that ball drops. However, it is a good time to set goals for the next few months &#8212; just remember that you can restart these if you mess up. You don&#8217;t have to wait till 2016 to make your life better.</p>\n<p>The only two I have this are:</p>\n<p><em>#1. Develop better savings habits.</em></p>\n<p>I&#8217;m a fortunate person.. but I could greatly improve my future by starting to save and invest. That includes paying off my debts and putting aside savings for stuff I would like to do in the future.</p>\n<p><em>#2. Fill my life with more meaningful interactions.</em></p>\n<p>Both online and off. Online, I&#8217;ve started this by purging my Facebook friend list and removing negativities, people I don&#8217;t talk to, or people that just clutter up my friends list (post something racist or sexist? you don&#8217;t belong in my newsfeed) &#8212; but I want to take that one step further and actually meaningfully engage with people online instead of just being passive. Offline, I want to spend more time with the people love &#8212; both here in Oregon and elsewhere.</p>\n<p><strong>Fin.</strong></p>\n<p>I think these are vague enough that I should be able to hit both next year. We&#8217;ll see <span class="wp-smiley wp-emoji wp-emoji-smile" title=":)">:)</span>.</p>\n<p>Happy New Years everyone!</p>\n",
				"excerpt": "<p>January 1st! Happy New Years, dear readers <span class="wp-smiley wp-emoji wp-emoji-smile" title=":)">:)</span>. It&#8217;s time to reflect on last years goals and set some new ones. If you allow me some flexibility with my resolutions from last year &#8211; I think I met a good deal of them. Let&#8217;s take a look.. Now that I’m finished with my undergraduate degree, and I’m [&hellip;]</p>\n",
				"slug": "twenty-fifteen",
				"guid": "http://binarysmash.com/?p=1361",
				"status": "publish",
				"sticky": false,
				"password": "",
				"parent": false,
				"type": "post",
				"comments_open": true,
				"pings_open": true,
				"likes_enabled": true,
				"sharing_enabled": true,
				"comment_count": 1,
				"like_count": 9,
				"i_like": 1,
				"is_reblogged": 0,
				"is_following": 1,
				"global_ID": "8e74522727f27c98e3e2398de50465c5",
				"featured_image": "https://binarysmashdotcom.files.wordpress.com/2015/01/598361_3997243495772_669618792_n.jpg",
				"post_thumbnail": {
					"ID": 1364,
					"URL": "https://binarysmashdotcom.files.wordpress.com/2015/01/598361_3997243495772_669618792_n.jpg",
					"guid": "http://binarysmashdotcom.files.wordpress.com/2015/01/598361_3997243495772_669618792_n.jpg",
					"mime_type": "image/jpeg",
					"width": 612,
					"height": 612
				},
				"format": "standard",
				"geo": false,
				"menu_order": 0,
				"publicize_URLs": [],
				"tags": {
					"2015": {
						"ID": 48041,
						"name": "2015",
						"slug": "2015",
						"description": "",
						"post_count": 1,
						"meta": {
							"links": {
								"self": "https://public-api.wordpress.com/rest/v1/sites/60451524/tags/slug:2015",
								"help": "https://public-api.wordpress.com/rest/v1/sites/60451524/tags/slug:2015/help",
								"site": "https://public-api.wordpress.com/rest/v1/sites/60451524"
							}
						}
					},
					"New Years Resolutions": {
						"ID": 34327,
						"name": "New Years Resolutions",
						"slug": "new-years-resolutions",
						"description": "",
						"post_count": 2,
						"meta": {
							"links": {
								"self": "https://public-api.wordpress.com/rest/v1/sites/60451524/tags/slug:new-years-resolutions",
								"help": "https://public-api.wordpress.com/rest/v1/sites/60451524/tags/slug:new-years-resolutions/help",
								"site": "https://public-api.wordpress.com/rest/v1/sites/60451524"
							}
						}
					}
				},
				"categories": {
					"Life": {
						"ID": 124,
						"name": "Life",
						"slug": "life",
						"description": "",
						"post_count": 71,
						"parent": 0,
						"meta": {
							"links": {
								"self": "https://public-api.wordpress.com/rest/v1/sites/60451524/categories/slug:life",
								"help": "https://public-api.wordpress.com/rest/v1/sites/60451524/categories/slug:life/help",
								"site": "https://public-api.wordpress.com/rest/v1/sites/60451524"
							}
						}
					},
					"List": {
						"ID": 14608,
						"name": "List",
						"slug": "list",
						"description": "",
						"post_count": 20,
						"parent": 0,
						"meta": {
							"links": {
								"self": "https://public-api.wordpress.com/rest/v1/sites/60451524/categories/slug:list",
								"help": "https://public-api.wordpress.com/rest/v1/sites/60451524/categories/slug:list/help",
								"site": "https://public-api.wordpress.com/rest/v1/sites/60451524"
							}
						}
					}
				},
				"attachments": {
					"1364": {
						"ID": 1364,
						"URL": "https://binarysmashdotcom.files.wordpress.com/2015/01/598361_3997243495772_669618792_n.jpg",
						"guid": "http://binarysmashdotcom.files.wordpress.com/2015/01/598361_3997243495772_669618792_n.jpg",
						"mime_type": "image/jpeg",
						"width": 612,
						"height": 612
					}
				},
				"metadata": [
					{
						"id": "5532",
						"key": "email_notification",
						"value": "1420138311"
					},
					{
						"id": "5537",
						"key": "publicize_twitter_url",
						"value": "http://t.co/FJanoMGPgu"
					}
				],
				"meta": {
					"links": {
						"self": "https://public-api.wordpress.com/rest/v1/sites/60451524/posts/1361",
						"help": "https://public-api.wordpress.com/rest/v1/sites/60451524/posts/1361/help",
						"site": "https://public-api.wordpress.com/rest/v1/sites/60451524",
						"replies": "https://public-api.wordpress.com/rest/v1/sites/60451524/posts/1361/replies/",
						"likes": "https://public-api.wordpress.com/rest/v1/sites/60451524/posts/1361/likes/"
					}
				},
				"current_user_can": {
					"publish_post": true,
					"delete_post": true,
					"edit_post": true
				},
				"capabilities": {
					"publish_post": true,
					"delete_post": true,
					"edit_post": true
				},
				"pseudo_ID": "8e74522727f27c98e3e2398de50465c5",
				"is_external": false,
				"site_name": "BinarySmash",
				"site_URL": "http://binarysmashdotcom.wordpress.com",
				"site_is_private": false,
				"featured_media": {
					"uri": "https://binarysmashdotcom.files.wordpress.com/2015/01/598361_3997243495772_669618792_n.jpg",
					"width": 612,
					"height": 612,
					"type": "image"
				},
				"date_liked": "2015-01-01T20:00:21+00:00"
			},
		]
	}