Skip to main content
GET
List articles

Authorizations

Authorization
string
header
required

API key. Read keys (rw_live_...) access GET endpoints. Admin keys (rw_admin_...) access all endpoints.

Query Parameters

page
integer
default:1
Required range: x >= 1
Example:

1

limit
integer
default:20
Required range: 1 <= x <= 50
Example:

20

status
enum<string>
Available options:
unread,
reading,
finished
Example:

"finished"

tag
string
Example:

"technology"

domain
string
Example:

"theatlantic.com"

starred
integer | null

1 for starred only, 0 for unstarred only

Required range: 0 <= x <= 1
Example:

1

sort
enum<string>
default:saved_at
Available options:
saved_at,
finished_at,
title
Example:

"saved_at"

order
enum<string>
default:desc
Available options:
asc,
desc
Example:

"desc"

include_no_body
integer | null
default:0
Required range: 0 <= x <= 1
date
string

Single day (YYYY-MM-DD). Overrides from/to.

Pattern: ^\d{4}-\d{2}-\d{2}$
Example:

"2025-02-17"

from
string

Range start, inclusive (ISO 8601)

Example:

"2025-02-01T00:00:00Z"

to
string

Range end, inclusive (ISO 8601)

Example:

"2025-02-28T23:59:59Z"

Response

Paginated articles

data
object[]
required
pagination
object
required