Articles and interactions

List and filter articles

Retrieve global articles with tag, author, favorite, offset, and limit filters.

Use GET /articles to retrieve the global article collection. Authentication is optional: omit the token for a public list, or send a valid token when the response should evaluate user-specific fields such as favorited.

The endpoint returns an articles array and an articlesCount integer. articlesCount is the total number of matching articles, while limit and offset control the returned page. See Pagination for articles and feeds for shared paging guidance.

GET /articles

GET/articles

tagstringquery

Filter by tag.

authorstringquery

Filter by author username.

favoritedstringquery

Filter by articles favorited by this username.

offsetintegerquery

Number of matching items to skip. Minimum: 0.

limitintegerquery

Number of matching items to return. Minimum: 1. Default: 20.

Response

200Matching articles and the total count.

401The supplied token is unauthorized, if authentication was attempted.

422A generic request or parameter error.

$_cURL

curl --request GET \
  --url https://api.realworld.show/api/articles?tag=api&author=ada&favorited=ada&offset=0&limit=10

{ "articles": [ { "slug": "how-to-build-a-client", "title": "How to build a client", "description": "A practical guide", "tagList": ["api"], "createdAt": "2026-09-25T09:00:00Z", "updatedAt": "2026-09-25T09:00:00Z", "favorited": false, "favoritesCount": 0, "author": { "username": "ada", "bio": null, "image": null, "following": false } } ], "articlesCount": 1 }

The list representation includes article metadata and the author profile. The Hurl suite verifies that list items do not include the full body; request GET /articles/{slug} when you need the complete article.

Filter results

Use one or more query parameters. Encode values when they contain spaces or reserved characters.

Query parameter	Example	Result
`tag`	`tag=api`	Articles whose tag list contains `api`.
`author`	`author=ada`	Articles authored by `ada`.
`favorited`	`favorited=ada`	Articles favorited by `ada`.
`offset`	`offset=20`	Skip the first 20 matching items.
`limit`	`limit=10`	Return at most 10 matching items.

The Hurl suite verifies author and tag filters by creating an article with test tags, then checking that filtered responses contain the expected article and articlesCount. It also verifies the same list shape with and without authentication.

Examples

List the first page without authentication:

~~~bash curl --request GET \ --url 'https://api.realworld.show/api/articles?limit=10&offset=0'~~ ~

Filter by author and tag:

~~~bash curl --request GET \ --url 'https://api.realworld.show/api/articles?author=ada&tag=api&limit=20'~~ ~

Use a token when you need personalized favorite state:

~~~bash curl --request GET \ --url 'https://api.realworld.show/api/articles?favorited=ada' \ --header 'Authorization: Token <jwt>'~~ ~

On success, read articlesCount before rendering page controls and use each article's slug to open its detail resource. For the shared error format, see Error envelope and HTTP status behavior; for related authenticated results, see Read the followed-user feed.