Read the followed-user feed
Retrieve the newest articles from users followed by the authenticated user.
Use this endpoint to retrieve the newest articles written by users the authenticated user follows. The response is an articles array with an articlesCount value; use offset and limit to page through the result.
The feed requires the Authorization: Token <jwt> header described in Authentication and token usage. For the shared response shape, see Response envelopes and resource models, and for paging behavior see Pagination for articles and feeds.
GET /articles/feed
Returns followed-user articles in newest-first order. The endpoint is available at the hosted demo base URL https://api.realworld.show/api.
Returns the most recent articles from users followed by the authenticated user.
/articles/feedToken header for the authenticated user. Replace `demo-jwt-token` with a token issued to your user.
Number of articles to skip before collecting results. The value must be 0 or greater; the default is 0 when omitted.
Number of articles to return. The value must be at least 1; the default is 20 when omitted.
curl --request GET \ --url https://api.realworld.show/api/articles/feed?offset=0&limit=20 \ --header 'Authorization: Token demo-jwt-token'
{
"articles": [
{
"slug": "welcome-to-conduit",
"title": "Welcome to Conduit",
"description": "A short introduction",
"tagList": ["conduit"],
"createdAt": "2026-09-25T09:00:00Z",
"updatedAt": "2026-09-25T09:00:00Z",
"favorited": false,
"favoritesCount": 0,
"author": {
"username": "demo-author",
"bio": null,
"image": null,
"following": true
}
}
],
"articlesCount": 1
}Example request
curl --request GET \
--url 'https://api.realworld.show/api/articles/feed?limit=20&offset=0' \
--header 'Authorization: Token demo-jwt-token'The server returns HTTP 200 and the articles plus articlesCount envelope when the token is valid. An omitted or malformed authentication header is an authentication failure; handle the error using the error envelope and HTTP status behavior.
Response fields
Each feed article includes its slug, title, description, tagList, createdAt, updatedAt, favorited, favoritesCount, and author. The feed article shape does not include the full body; fetch that content with Read an article by slug.
articlesCount reports the total number of matching articles, independent of the current offset and limit. If the authenticated user follows no one, the successful response contains an empty articles array and a count of zero.
Next step
To display an individual feed item with its body, use Read an article by slug. To create content that can appear in another user’s feed, use Create an article.