Skip to main content
GET
/
v1
/
reading
/
articles
List articles
curl --request GET \
  --url https://api.rewind.rest/v1/reading/articles \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 42,
      "title": "The Age of AI",
      "author": "Derek Thompson",
      "url": "https://www.theatlantic.com/technology/archive/2025/the-age-of-ai",
      "instapaper_url": "https://www.instapaper.com/read/1234567",
      "instapaper_app_url": "instapaper://read/1234567",
      "domain": "theatlantic.com",
      "site_name": "The Atlantic",
      "description": "How artificial intelligence is reshaping every industry.",
      "word_count": 3200,
      "estimated_read_min": 13,
      "status": "finished",
      "progress": 1,
      "starred": true,
      "rating": null,
      "tags": [
        "technology",
        "ai"
      ],
      "source": "instapaper",
      "image": null,
      "saved_at": "2026-03-18T14:30:00.000Z",
      "started_at": "2026-03-19T08:00:00.000Z",
      "finished_at": "2026-03-19T08:15:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 1523,
    "total_pages": 77
  }
}

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