Reading

List articles

GET https://api.rewind.rest/v1/reading/articles

Returns a paginated list of articles, filterable by status, tag, domain, and starred.

Authorization

Authorizationheaderstringrequired

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

Query Parameters

pagequeryinteger

limitqueryinteger

statusqueryenum (string)

Allowed valuesunreadreadingfinished

tagquerystring

domainquerystring

starredqueryinteger

1 for starred only, 0 for unstarred only

sortqueryenum (string)

Allowed valuessaved_atfinished_attitle

orderqueryenum (string)

Allowed valuesascdesc

include_no_bodyqueryinteger

datequerystring

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

fromquerystring

Range start, inclusive (ISO 8601)

toquerystring

Range end, inclusive (ISO 8601)

Response

application/json

Paginated articles

dataarray of objectrequired

properties

paginationobjectrequired

properties

cURL

curl -X GET 'https://api.rewind.rest/v1/reading/articles' \
  -H 'Authorization: Bearer <token>'

200

{
  "data": [
    {
      "id": 0,
      "title": "string",
      "author": "string",
      "url": "string",
      "instapaper_url": "string",
      "instapaper_app_url": "string",
      "domain": "string",
      "site_name": "string",
      "description": "string",
      "word_count": 0,
      "estimated_read_min": 0,
      "status": "string",
      "progress": 0,
      "starred": true,
      "rating": 0,
      "tags": [
        "\u2026"
      ],
      "source": "string",
      "image": {},
      "saved_at": "string",
      "started_at": "string",
      "finished_at": "string"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "total_pages": 8
  }
}