List articles
Articles from your reading list, a folder, a tag, a feed or Starred, newest first.
GET https://cotlet.dev/api/v1/inoreader/articles
read
Lists articles from one stream, newest first unless oldest_first is set. Set unread_only to leave out articles you read, and since to cover a time window. Pages hold up to 100 articles and 20 by default; pass next_cursor back as cursor until it is null. Oldest-first lookback is limited to about one month.
Parameters
| Name | Type | Description |
|---|---|---|
| stream string | string | Folder or tag name, feed ID from list_subscriptions, or one of: reading_list, starred. Default: reading_list. |
| unread_only boolean | boolean | Leave out articles you have read. |
| since datetime | datetime | Only articles newer than this time. |
| oldest_first boolean | boolean | Oldest first instead of newest first. |
| limit integer | integer | 1 to 100. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
Request
curl https://cotlet.dev/api/v1/inoreader/articles \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("inoreader", "list_articles")const result = await cotlet.call('inoreader', 'list_articles');cotlet call inoreader list_articlesExample response
{
"articles": [
{
"article_id": "1830442176",
"title": "MCP spec adds elicitation",
"feed": "The Changelog Weekly",
"published_at": "2026-10-16T07:12:00Z",
"starred": false,
"read": false,
"tags": [],
"summary": "Servers can now ask the user a question mid-call..."
},
{
"article_id": "1830442190",
"title": "Agents that plan before they browse",
"feed": "Lab Notes",
"published_at": "2026-10-16T08:40:00Z",
"starred": false,
"read": false,
"tags": [],
"summary": "A small planning step cut wasted page loads..."
}
],
"next_cursor": "eyJvZmZzZXQiOjIwfQ"
}