GET /read/following/

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

Resource Information

   
Method GET
URL https://public-api.wordpress.com/rest/v1.1/read/following/
Requires authentication? Yes

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.

Resource Errors

These are the possible errors returned by this endpoint.

HTTP Code Error Identifier Error Message
403 unauthorized User cannot view taxonomy
403 unauthorized User cannot view post
403 authorization_required An active access token must be used to query information about the current user.
403 unauthorized User cannot edit taxonomy
400 invalid_post Invalid post
400 invalid_context Invalid API CONTEXT
403 unauthorized User cannot edit post
404 unknown_post Unknown post

Example

curl \
 -H 'authorization: Bearer YOUR_API_TOKEN' \
 'https://public-api.wordpress.com/rest/v1/read/following/?number=2'
<?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/following/?number=2',
	false,
	$context
);
$response = json_decode( $response );
?>

Response

{
    "date_range": {
        "before": "2016-08-23T12:43:01-04:00",
        "after": "2016-08-23T12:43:01-04:00"
    },
    "number": 1,
    "posts": [
        {
            "ID": 37128,
            "site_ID": 70135762,
            "author": {
                "ID": 1107852,
                "login": "caaf",
                "email": false,
                "name": "Carrie Frye",
                "first_name": "Carrie",
                "last_name": "Frye",
                "nice_name": "caaf",
                "URL": "",
                "avatar_URL": "https:\/\/2.gravatar.com\/avatar\/5e20a3e774adc6a5b4a943b2486bf888?s=96&d=identicon&r=G",
                "profile_URL": "http:\/\/en.gravatar.com\/caaf",
                "site_ID": 70135762
            },
            "date": "2016-08-23T12:43:01-04:00",
            "modified": "2016-08-23T12:43:01-04:00",
            "title": "The Summer Break Where Charlotte Bront\u00eb Started ‘Jane Eyre’",
            "URL": "http:\/\/blog.longreads.com\/2016\/08\/23\/the-summer-break-where-charlotte-bronte-started-jane-eyre\/",
            "short_URL": "http:\/\/wp.me\/p4KhvY-9EQ",
            "content": "<div>\n<p><em><a href=\"http:\/\/www.tinyletter.com\/caaf\">Black Cardigan<\/a> is a great newsletter by writer-editor\u00a0<a href=\"https:\/\/twitter.com\/CAAF\">Carrie Frye<\/a>, who\u00a0shares dispatches from her reading life. We’re thrilled to share some of them on Longreads. <a href=\"http:\/\/www.tinyletter.com\/caaf\">Go here\u00a0to sign up for\u00a0her latest updates<\/a>.<br \/>\n<\/em><\/p>\n<p style=\"text-align:center;\">* * *<\/p>\n<p>In the summer of 1843, Charlotte Bront\u00eb was staying at the school in Brussels where she was both a student and a teacher\u2014at this time, more the latter. Over her time at the Pensionnat, she had developed an unrequited passion for the directrice’s husband, Constantin H\u00e9ger, and she’d been present as he departed for the seaside with his handsome wife and their young children.\u00a0The other teachers and the school’s boarders had already left for their own holidays, and Bront\u00eb was the only person left remaining\u00a0except for the cook. Her friends outside the school had left the city too. Summer in the city: everyone who can, leaves. Her relationship with the cook, one suspects, was cordial but necessarily distant, and the cook would have had her sleep quarters in another part of the house. Bront\u00eb was alone at nights in the dormitory.<\/p>\n<p>If you’ve read\u00a0<em>Villette<\/em>, the contours of this summer term are already familiar. The empty dark echoing hot rooms of the school,\u00a0the tiny plain Englishwoman fluttering through\u00a0them like the world’s most anguished moth:<\/p>\n<blockquote><p>How long were the September days! How silent, how lifeless! How vast and void seemed the desolate premises. \u2026\u00a0 A sorrowful indifference to existence often pressed on me \u2013 a despairing resignation to reach betimes the end of all things earthly. Alas! When I had full leisure to look on life as life must be looked on by such as me, I found it but a hopeless desert: tawny sands, with no green field, no palm-tree, no well in view.<\/p><\/blockquote>\n<p><img class=\" size-medium wp-image-37484 alignright\" src=\"https:\/\/longreadsblog.files.wordpress.com\/2016\/08\/cover.jpg?w=197&h=300\" alt=\"Cover\" width=\"197\" height=\"300\" \/>If you’ve ever been lonely and heartsick abroad, feeling yourself connected to no one for days on end, it’s an easy scene to identify with. Claire Harman’s\u00a0biography,\u00a0<a href=\"https:\/\/www.amazon.com\/Charlotte-Bront%C3%AB-Fiery-Claire-Harman\/dp\/0307962083\/ref=sr_1_1?ie=UTF8&amp;qid=1468462704&amp;sr=8-1&amp;keywords=Claire+Harman\"><em>Charlotte<\/em>\u00a0<em>Bront\u00eb: A Fiery Heart<\/em><\/a>, starts with a description of how, as happens to Lucy Snowe in\u00a0<em>Villette<\/em>, Bront\u00eb, a Protestant,\u00a0was eventually\u00a0drawn\u00a0to a Catholic church\u00a0and, entering the confessional, poured out some of her “long accumulating, long pent-up pain” (<em>Villette<\/em>‘s phrase) to the priest there.<\/p>\n<p>Harman’s biography is excellent, by the way; elegant and keenly perceptive, while retaining a nice generosity in its descriptions of people’s actions and motives. Later in it, she returns to that summer and describes how Bront\u00eb found herself in that jittery, restless, depressed state where you’re unable to read or focus on anything. Harman notes:\u00a0“Walking the busy city streets was just as distressing: ‘I know you, living in the country can hardly believe that it is possible life can be monotonous in the centre of a brilliant capital like Brussels,’\u00a0she wrote to [her friend Ellen Nussey]; ‘but so it is.'”<\/p>\n<p>For a Bront\u00eb, writing would normally\u00a0have been a comfort and a refuge, but that, too, required a focus\u00a0that Charlotte didn’t have\u00a0that summer. She did manage to write a little, however\u2014or at least planned to. Harman shares an outline for a story Bront\u00eb\u00a0started inside a German exercise book. The story was to be a “magazine tale” set 30 to 50 years before in England, have a rural setting, be in the first person, and deal with characters of “Rank\u2014middle.” After the heading for “Subject,” Bront\u00eb had written,\u00a0“Certain remarkable occurrences,” which is a pretty wonderful instance of literary plot TK-ing. Feel free to use it yourself next time you’re stuck in a draft:\u00a0<em>[Certain remarkable occurrences TK.]<\/em><\/p>\n<p>At the back of that same exercise book was this fragment, unrelated to the “magazine story” outline. It reads:<\/p>\n<blockquote><p>There was once a large house called Gateshead stood not far from a [illeg.] high-road in the North of England\u2014it is gone now every vestige of it, and the site is [replaced?] by a Railway Station. No great loss was the demolition of that said house for it was never a tasteful or picturesque building.<\/p><\/blockquote>\n<p>Harman writes,\u00a0“Charlotte Bront\u00eb later said that she always made two or three starts on her novels before settling down, and here we see a very early glimpse of her second novel,\u00a0<em>Jane Eyre<\/em>\u2026 It’s odd to think Charlotte may have been hatching the story in the long lonely summer at the Pensionnat.”<\/p>\n<p>Here’s the first page of Bront\u00eb’s later fair copy of <em>Jane Eyre<\/em> with the\u00a0first sentence,\u00a0“There was no possibility of taking a walk that day,” she’d\u00a0arrived at after those two or three (or however many) false starts.<\/p>\n<p><img class=\"alignnone size-large wp-image-38258\" src=\"https:\/\/longreadsblog.files.wordpress.com\/2016\/08\/bronte-charlotte-faircopy.jpg?w=817&h=1024\" alt=\"bronte-charlotte-faircopy\" width=\"817\" height=\"1024\" \/><\/p>\n<\/div>\n<div>When I was reading Harman’s biography the other night, that first beginning\u00a0fragment\u2014”There was once a large house called Gatehead”\u2014gave me goosebumps. I don’t know why. Ninety percent\u00a0of the reaction was attributable to pure <em>Jane Eyre<\/em>– Bront\u00eb love, of course. One percent\u00a0probably\u00a0to the fragment’s echo to “Hill House, not sane, stood by itself against its hills, holding darkness within,” and to the Gateshead of the fragment being a house that, like Manderley, can’t be returned to. (As Thornfield Hall ends up being in the completed <em>Jane Eyre<\/em>.) The rest of it, though, had something to do with the way the note had been scribbled in the back of the exercise book, with a couple words illegible to even the most diligent of biographers. About how it was off to the side of the main thing that Bront\u00eb was working on. One of those stumbling starts on something you make during a long, terrible summer that may come to nothing. Or may not.<\/div>\n<div><\/div>\n<div>\n<p style=\"text-align:center;\">* * *<\/p>\n<p style=\"text-align:center;\"><a href=\"http:\/\/www.tinyletter.com\/caaf\"><em>Sign up for Frye’s Black Cardigan newsletter.<\/em><\/a><\/p>\n<\/div>\n",
            "excerpt": "<p>Black Cardigan is a great newsletter by writer-editor\u00a0Carrie Frye, who\u00a0shares dispatches from her reading life. We’re thrilled to share some of them on Longreads. Go here\u00a0to sign up for\u00a0her latest updates. * * * In the summer of 1843, Charlotte Bront\u00eb was staying at the school in Brussels where she was both a student and [&hellip;]<\/p>\n",
            "slug": "the-summer-break-where-charlotte-bronte-started-jane-eyre",
            "guid": "http:\/\/blog.longreads.com\/?p=37128",
            "status": "publish",
            "sticky": false,
            "password": "",
            "parent": false,
            "type": "post",
            "comments_open": false,
            "pings_open": true,
            "likes_enabled": true,
            "sharing_enabled": true,
            "comment_count": 0,
            "like_count": 140,
            "i_like": false,
            "is_reblogged": false,
            "is_following": true,
            "global_ID": "134d428b92154c10da1bf01c9b854883",
            "featured_image": "https:\/\/longreadsblog.files.wordpress.com\/2016\/08\/charlotte_bronte_portrait.jpg",
            "post_thumbnail": {
                "ID": 38262,
                "URL": "https:\/\/longreadsblog.files.wordpress.com\/2016\/08\/charlotte_bronte_portrait.jpg",
                "guid": "http:\/\/longreadsblog.files.wordpress.com\/2016\/08\/charlotte_bronte_portrait.jpg",
                "mime_type": "image\/jpeg",
                "width": 1263,
                "height": 968
            },
            "format": "standard",
            "geo": false,
            "menu_order": 0,
            "publicize_URLs": [],
            "tags": {
                "black cardigan": {
                    "ID": 2736951,
                    "name": "black cardigan",
                    "slug": "black-cardigan",
                    "description": "",
                    "post_count": 6,
                    "meta": {
                        "links": {
                            "self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/tags\/slug:black-cardigan",
                            "help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/tags\/slug:black-cardigan\/help",
                            "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762"
                        }
                    }
                },
                "Charlotte Bront\u00eb": {
                    "ID": 152328,
                    "name": "Charlotte Bront\u00eb",
                    "slug": "charlotte-bronte",
                    "description": "",
                    "post_count": 2,
                    "meta": {
                        "links": {
                            "self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/tags\/slug:charlotte-bronte",
                            "help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/tags\/slug:charlotte-bronte\/help",
                            "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762"
                        }
                    }
                },
                "Claire Harman": {
                    "ID": 10064654,
                    "name": "Claire Harman",
                    "slug": "claire-harman",
                    "description": "",
                    "post_count": 1,
                    "meta": {
                        "links": {
                            "self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/tags\/slug:claire-harman",
                            "help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/tags\/slug:claire-harman\/help",
                            "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762"
                        }
                    }
                },
                "The Bront\u00ebs": {
                    "ID": 950433,
                    "name": "The Bront\u00ebs",
                    "slug": "the-brontes",
                    "description": "",
                    "post_count": 2,
                    "meta": {
                        "links": {
                            "self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/tags\/slug:the-brontes",
                            "help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/tags\/slug:the-brontes\/help",
                            "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762"
                        }
                    }
                }
            },
            "categories": {
                "Blog Post": {
                    "ID": 38909,
                    "name": "Blog Post",
                    "slug": "blog-post",
                    "description": "",
                    "post_count": 29,
                    "parent": 0,
                    "meta": {
                        "links": {
                            "self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/categories\/slug:blog-post",
                            "help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/categories\/slug:blog-post\/help",
                            "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762"
                        }
                    }
                },
                "books": {
                    "ID": 178,
                    "name": "books",
                    "slug": "books",
                    "description": "",
                    "post_count": 161,
                    "parent": 0,
                    "meta": {
                        "links": {
                            "self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/categories\/slug:books",
                            "help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/categories\/slug:books\/help",
                            "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762"
                        }
                    }
                },
                "Uncategorized": {
                    "ID": 1,
                    "name": "Uncategorized",
                    "slug": "uncategorized",
                    "description": "",
                    "post_count": 1892,
                    "parent": 0,
                    "meta": {
                        "links": {
                            "self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/categories\/slug:uncategorized",
                            "help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/categories\/slug:uncategorized\/help",
                            "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762"
                        }
                    }
                }
            },
            "attachments": {
                "38262": {
                    "ID": 38262,
                    "URL": "https:\/\/longreadsblog.files.wordpress.com\/2016\/08\/charlotte_bronte_portrait.jpg",
                    "guid": "http:\/\/longreadsblog.files.wordpress.com\/2016\/08\/charlotte_bronte_portrait.jpg",
                    "mime_type": "image\/jpeg",
                    "width": 1263,
                    "height": 968
                },
                "38258": {
                    "ID": 38258,
                    "URL": "https:\/\/longreadsblog.files.wordpress.com\/2016\/08\/bronte-charlotte-faircopy.jpg",
                    "guid": "http:\/\/longreadsblog.files.wordpress.com\/2016\/08\/bronte-charlotte-faircopy.jpg",
                    "mime_type": "image\/jpeg",
                    "width": 1595,
                    "height": 2000
                }
            },
            "metadata": [
                {
                    "id": "142142",
                    "key": "_thumbnail_id",
                    "value": "38262"
                },
                {
                    "id": "142314",
                    "key": "_wpas_done_8071423",
                    "value": "1"
                }
            ],
            "meta": {
                "links": {
                    "self": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/posts\/37128",
                    "help": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/posts\/37128\/help",
                    "site": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762",
                    "replies": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/posts\/37128\/replies\/",
                    "likes": "https:\/\/public-api.wordpress.com\/rest\/v1\/sites\/70135762\/posts\/37128\/likes\/"
                }
            },
            "current_user_can": {
                "publish_post": false,
                "delete_post": false,
                "edit_post": false
            },
            "capabilities": {
                "publish_post": false,
                "delete_post": false,
                "edit_post": false
            },
            "pseudo_ID": "134d428b92154c10da1bf01c9b854883",
            "is_external": false,
            "site_name": "Longreads Blog",
            "site_URL": "http:\/\/blog.longreads.com",
            "site_is_private": false,
            "featured_media": {
                "uri": "https:\/\/longreadsblog.files.wordpress.com\/2016\/08\/charlotte_bronte_portrait.jpg",
                "width": 1263,
                "height": 968,
                "type": "image"
            },
            "feed_ID": 22973954
        }
    ]
}