Feeds

Query followed feeds: entries, source health, or aggregates

Read followed feeds. "What's new?" is {"since":"1d"}: newest published first, one line per entry with format:"compact". Other arguments are optional; add where.collection, where.source.include/exclude, where.unread, or where.match when requested. per_source_limit produces a bounded fair sample across pages; omit it to retrieve every matching article. select:"sources" returns fetch_status and last_fetched_at separately from publisher activity (health, silent_days, entries_7d/28d). Quiet publishers can have working feeds. select:"aggregate" returns grouped counts with optional trends. Classification-filtered queries report classification_coverage: pending articles have not been assessed, not rejected. Times accept "7d"/"36h"/"now" or ISO dates.

POST

https://api.smry.ai

feeds

query

Query followed feeds: entries, source health, or aggregates

curl --request POST \
  --url https://api.smry.ai/v1/feeds/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://api.smry.ai/v1/feeds/query"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://api.smry.ai/v1/feeds/query', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "feed_query",
  "select": "<string>",
  "classification_coverage": {
    "collection_id": 123,
    "filter_revision": 123,
    "status": "pending",
    "total": 123,
    "classified": 123,
    "pending": 123,
    "degraded": 123
  }
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

Authorizations

Authorization

string

header

required

Clerk OAuth 2.0 Authorization Code flow with PKCE. Request the minimum scope required by the operation.

Body

application/json

since

string

The "what's new" shorthand: entries published after this time (falling back to discovery time when the feed gives none), newest published first. {"since":"1d"} is the whole catch-up call. Entries only.

Required string length: 1 - 64

select

"entries" = rows · "sources" = per-source health (where.collection/source only; use having for health filters; stalled = nothing published in 14 days and nothing delivered in 7, quiet = nothing delivered in 7) · "aggregate" = counts. Default "entries".

Allowed value: "entries"

where

object

Entry selection predicate: fields AND together; omit a field to not filter on it. Source queries/mutations accept only collection and source; use query having for source-health filters.

Hide child attributes

where.discovered_after

string

When smry first saw the entry. Backfill makes old posts look new here, so use it for diffs, not for "what's new". Relative window ("7d", "36h", "45m", "2w"), "now", or ISO date.

Required string length: 1 - 64

where.discovered_before

string

Relative window ("7d", "36h", "45m", "2w"), "now", or ISO date.

Required string length: 1 - 64

where.published_after

string

When the source published the entry (entries with no publish date are excluded; use top-level since to include them). Relative window ("7d", "36h", "45m", "2w"), "now", or ISO date.

Required string length: 1 - 64

where.published_before

string

Relative window ("7d", "36h", "45m", "2w"), "now", or ISO date.

Required string length: 1 - 64

where.collection

(integer | string)[]

Required array length: 1 - 20 elements

A collection id or its exact name.

Required range: x >= 1

where.source

object

Hide child attributes

where.source.include

(integer | string)[]

Required array length: 1 - 100 elements

A source id (from any v2 response) or its title. Reads also accept a fragment that matches exactly one title.

Required range: x >= 1

where.source.exclude

(integer | string)[]

Required array length: 1 - 100 elements

A source id (from any v2 response) or its title. Reads also accept a fragment that matches exactly one title.

Required range: x >= 1

where.unread

boolean

true = only unread entries, false = only read entries.

where.classification

object

The Collection filter's binary delivery decision and optional underlying assessment. Requires exactly one Collection.

Hide child attributes

where.classification.decision

required

Allowed value: "include"

where.classification.assessment

Allowed value: "relevant"

where.match

string

Case-insensitive text match over title and summary. "a OR b" matches either.

Required string length: 1 - 500

limit

integer

Default 20, maximum 100; page further with next_cursor.

Required range: 1 <= x <= 100

cursor

string

Only a next_cursor from a previous response; omit on the first call.

Maximum string length: 500

per_source_limit

integer

Fair sample: at most this many entries per source across the result set, before pagination. Omit for an exhaustive stream. omitted.by_per_source_limit reports articles outside this sample.

Required range: 1 <= x <= 20

order_by

Default -discovered_at: newest arrivals first, so backfilled items never hide.

Allowed value: "-discovered_at"

fields

string[]

Project only these entry fields. ["id"] is the cheap diff shape. Summary is opt-in.

Maximum array length: 14

Allowed value: "id"

format

"compact" returns token-lean text lines (#entry_id [source · s<source_id> · collection] date title / url) in text; entries is then an empty array and fields is ignored.

Allowed value: "json"

group_by

Allowed value: "source"

compare

object

Trend detection for aggregates: counts inside the window vs the prior baseline, e.g. {"window":"7d","baseline":"28d"}.

Hide child attributes

compare.window

string

required

Maximum string length: 64

compare.baseline

string

required

Maximum string length: 64

having

object

Filter groups/sources on derived values.

Hide child attributes

having.count

object

Hide child attributes

having.count.gte

integer

Required range: x >= 0

having.count.lte

integer

Required range: x >= 0

having.unread

object

Hide child attributes

having.unread.gte

integer

Required range: x >= 0

having.unread.lte

integer

Required range: x >= 0

having.silent_days

object

Hide child attributes

having.silent_days.gte

integer

Required range: x >= 0

having.silent_days.lte

integer

Required range: x >= 0

Response

entries: {total, returned, omitted:{by_limit}, next_cursor, entries[] | text} · sources: {total, returned, omitted:{by_having,by_limit}, next_cursor, sources[]} · aggregate: {group_by, total_entries, groups[]}. Filtered queries include classification_coverage. Source fetch_status and last_fetched_at describe fetching; legacy health describes publisher activity, so stalled does not mean fetching failed.

object

string

required

Allowed value: "feed_query"

select

string

required

classification_coverage

object

Coverage before the classification decision and pagination. Pending articles are not excluded; retry the query after classification catches up. Degraded assessments used the filter's uncertainty policy.

Hide child attributes

classification_coverage.collection_id

integer

required

classification_coverage.filter_revision

integer

required

classification_coverage.status

enum<string>

required

Available options:

pending,

complete,

degraded

classification_coverage.total

integer

required

classification_coverage.classified

integer

required

classification_coverage.pending

integer

required

classification_coverage.degraded

integer

required

Last modified on September 13, 2026

Query followed feeds: entries, source health, or aggregates

curl --request POST \
  --url https://api.smry.ai/v1/feeds/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

import requests

url = "https://api.smry.ai/v1/feeds/query"

payload = {}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({})
};

fetch('https://api.smry.ai/v1/feeds/query', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "object": "feed_query",
  "select": "<string>",
  "classification_coverage": {
    "collection_id": 123,
    "filter_revision": 123,
    "status": "pending",
    "total": 123,
    "classified": 123,
    "pending": 123,
    "degraded": 123
  }
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

{
  "error": "cursor: expected a next_cursor from a previous response.",
  "code": "invalid_request",
  "field": "where.published_after",
  "hint": "<string>",
  "retryable": true,
  "retryAfter": 123,
  "details": "<string>"
}

Overview

Account

Articles

Library

Feeds

Collections

Consumers

Monitors

Query followed feeds: entries, source health, or aggregates

Authorizations

Body

Response