Overview

Get started with the Glanced API. Create an API token, authenticate with Bearer, and explore every endpoint.

The Glanced API lets you read and manage your library programmatically: your items, subscriptions, folders, tags, saved searches, and stories. Every endpoint in this reference is generated from the official API schema, so what you read here matches what the API serves.

The API is under active development and may change. Reach out if you build something against it so breaking changes can reach you first.

Requires a Plus subscription.

Authentication

All API requests authenticate with a Bearer token in the Authorization header. Tokens start with glanced_live_.

Create or revoke tokens in the app under Automation → API Keys. You can hold up to five at a time, and they don't expire, so revoke any you stop using.

curl -H 'Authorization: Bearer glanced_live_...' \
  'https://api.glanced.io/v1/items?limit=1'

Treat API tokens like passwords. They can read and modify everything in your library.

Base URL

All requests go to https://api.glanced.io. Paths are versioned under /v1.

Pagination

List endpoints page by cursor or by offset. Each endpoint page documents which mode it uses.

Cursor pagination. List items and subscriptions with order_by=recent return a pagination.next_cursor:

{
	"pagination": { "has_more": true, "next_cursor": "eyJ..." }
}

Pass next_cursor back as the cursor query parameter, and keep going while has_more is true.

Offset pagination. The other list endpoints page with limit and offset, and pagination echoes them back.

Errors and rate limits

Every failed request returns a JSON body you can read, and each endpoint declares the statuses it can actually return. See Errors. Requests are rate limited per token. See Rate limits.

Google Reader compatible API

Glanced also speaks the Google Reader API, and it's fully supported: readers like NetNewsWire and Reeder work out of the box. In your client, set the server to https://api.glanced.io, enter any username or email, and use an API token as the password.