Glanced
Glanced

List items

Get user's items with optional filters and search using cursor-based pagination.

GET
/v1/items
AuthorizationBearer <token>

API key (glanced_live_…). Required on operations marked with this scheme; rejected elsewhere.

In: header

Query Parameters

cursor?|

Pagination cursor for fetching next page of items. Use for infinite scroll pagination.

subscription_ids?array<>|

Filter by subscription IDs

is_read?|

Filter by read state: 'read' for read items, 'unread' for unread items. If not provided, shows all items

tag_ids?array<>|

Filter by tag IDs.

folder_ids?array<>|

Filter by folder IDs

is_saved?|

Filter by saved state: 'true' for saved items, 'false' for items not saved. If not provided, shows all items

q?|

Search query string for full-text search

from_date?|

Filter items published on or after this date (ISO 8601)

to_date?|

Filter items published on or before this date (ISO 8601)

item_type?|

Filter by item type: 'article' or 'episode'. If not provided, shows all items

order_by?|

Sort order: 'newest' (default), 'oldest', or 'recently_played' (by last_played_at; episodes only). Only affects episodes (item_type=episode); articles and mixed lists always return newest-first.

in_progress?|

Filter to in-progress episodes (started, not completed). Episodes only.

limit?Limit

Number of items to return

Range1 <= value <= 100
Default50

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/items"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "title": "string",      "feeds": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "title": "string",          "source_type": "feed",          "website": "string"        }      ],      "item_type": "article",      "media_url": "string",      "published_at": "2019-08-24T14:15:22Z",      "canonical_url": "string",      "is_read": false,      "is_saved": false,      "summary": "string",      "audio_url": "string",      "duration_seconds": 0,      "episode_number": 0,      "episode_type": "full",      "playback_position": 0,      "last_played_at": "2019-08-24T14:15:22Z",      "artwork_url": "string",      "explicit": true,      "description": "string"    }  ],  "pagination": {    "total": 0,    "limit": 0,    "offset": 0,    "has_more": true,    "next_cursor": "string"  }}

How is this guide?