Source: https://dinakar-rewind.docs.pageloop.ai/api-reference/reading/listreadingarticles

# List articles

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

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

## Authorization

#### Authorization (header, string, required)

API key. Read keys (rw\_live\_...) access GET endpoints. Admin keys (rw\_admin\_...) access all endpoints.

## Query Parameters

#### page (query, integer)

#### limit (query, integer)

#### status (query, enum (string)) — allowed: unread, reading, finished

#### tag (query, string)

#### domain (query, string)

#### starred (query, integer)

1 for starred only, 0 for unstarred only

#### sort (query, enum (string)) — allowed: saved\_at, finished\_at, title

#### order (query, enum (string)) — allowed: asc, desc

#### include\_no\_body (query, integer)

#### date (query, string)

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

#### from (query, string)

Range start, inclusive (ISO 8601)

#### to (query, string)

Range end, inclusive (ISO 8601)

## Response

#### 200

Paginated articles

#### data (array of object, required)

#### properties

#### id (number, required)

#### title (string, required)

#### author (string, required)

#### url (string, required)

#### instapaper\_url (string, required)

#### instapaper\_app\_url (string, required)

#### domain (string, required)

#### site\_name (string, required)

#### description (string, required)

#### word\_count (number, required)

#### estimated\_read\_min (number, required)

#### status (string, required)

#### progress (number, required)

#### starred (boolean, required)

#### rating (number, required)

#### tags (array of string, required)

#### source (string, required)

#### image (object)

#### saved\_at (string, required)

#### started\_at (string, required)

#### finished\_at (string, required)

#### pagination (object, required)

#### properties

#### page (integer, required)

#### limit (integer, required)

#### total (integer, required)

#### total\_pages (integer, required)

#### 400

Bad request

#### error (string, required)

#### status (integer, required)

#### 401

Unauthorized

#### error (string, required)

#### status (integer, required)

#### Request

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

```javascript JavaScript
const res = await fetch('https://api.rewind.rest/v1/reading/articles', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer <token>',
  },
});
const data = await res.json();
```

```python Python
import requests

res = requests.get(
    'https://api.rewind.rest/v1/reading/articles',
    headers={'Authorization': 'Bearer <token>'}
)
data = res.json()
```

#### Response

```json 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
  }
}
```

```json 400
{
  "error": "Not found",
  "status": 404
}
```

```json 401
{
  "error": "Not found",
  "status": 404
}
```