Glanced
Glanced

Stories

List stories, ranked groups of articles collected by Glanced.

List stories

GET
/v1/stories

Authorization

Bearer
AuthorizationBearer <token>

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

In: header

Query Parameters

limit?Limit

Number of stories (biggest clusters) 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/stories"
{  "data": [    {      "label": "string",      "item_count": 0,      "latest_published_at": "2019-08-24T14:15:22Z",      "items": [        {          "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",          "title": "string",          "feeds": [            {              "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",              "title": "string",              "source_type": "feed",              "website": "string"            }          ],          "published_at": "2019-08-24T14:15:22Z",          "is_read": false,          "media_url": "string",          "ai_summary": "string"        }      ]    }  ]}

How is this guide?

Record playback progress POST

Record episode playback position. Last-write-wins across devices (send the client's clock as client_timestamp). Marks the episode read once within 5% of its duration.

List stories GET

Grouped same-event articles across the user's sources (story clusters), biggest clusters first. Each story carries the user's subset of its articles.