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. Classifica
Показать схему аргументов
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Default 20, maximum 100; page further with next_cursor."
},
"since": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "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."
},
"where": {
"type": "object",
"properties": {
"match": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "Case-insensitive text match over title and summary. \"a OR b\" matches either."
},
"source": {
"type": "object",
"properties": {
"exclude": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
{
"type": "string",
"maxLength": 500,
"minLength": 1
}
],
"description": "A source id (from any v2 response) or its title. Reads also accept a fragment that matches exactly one title."
},
"maxItems": 100,
"minItems": 1
},
"include": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
{
"type": "string",
"maxLength": 500,
"minLength": 1
}
],
"description": "A source id (from any v2 response) or its title. Reads also accept a fragment that matches exactly one title."
},
"maxItems": 100,
"minItems": 1
}
},
"additionalProperties": false
},
"unread": {
"type": "boolean",
"description": "true = only unread entries, false = only read entries."
},
"collection": {
"type": "array",
"items": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1
},
{
"type": "string",
"maxLength": 100,
"minLength": 1
}
],
"description": "A collection id or its exact name."
},
"maxItems": 20,
"minItems": 1
},
"classification": {
"type": "object",
"required": [
"decision"
],
"properties": {
"decision": {
"anyOf": [
{
"type": "string",
"const": "include"
},
{
"type": "string",
"const": "exclude"
}
]
},
"assessment": {
"anyOf": [
{
"type": "string",
"const": "relevant"
},
{
"type": "string",
"const": "irrelevant"
},
{
"type": "string",
"const": "uncertain"
}
]
}
},
"description": "The Collection filter's binary delivery decision and optional underlying assessment. Requires exactly one Collection.",
"additionalProperties": false
},
"published_after": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "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."
},
"discovered_after": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "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."
},
"published_before": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Relative window (\"7d\", \"36h\", \"45m\", \"2w\"), \"now\", or ISO date."
},
"discovered_before": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Relative window (\"7d\", \"36h\", \"45m\", \"2w\"), \"now\", or ISO date."
}
},
"description": "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.",
"additionalProperties": false
},
"cursor": {
"type": "string",
"maxLength": 500,
"description": "Only a next_cursor from a previous response; omit on the first call."
},
"fields": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string",
"const": "id"
},
{
"type": "string",
"const": "source"
},
{
"type": "string",
"const": "source_id"
},
{
"type": "string",
"const": "collection"
},
{
"type": "string",
"const": "title"
},
{
"type": "string",
"const": "url"
},
{
"type": "string",
"const": "summary"
},
{
"type": "string",
"const": "author"
},
{
"type": "string",
"const": "image_url"
},
{
"type": "string",
"const": "published_at"
},
{
"type": "string",
"const": "discovered_at"
},
{
"type": "string",
"const": "unread"
},
{
"type": "string",
"const": "classification"
},
{
"type": "string",
"const": "feedback"
}
]
},
"maxItems": 14,
"description": "Project only these entry fields. [\"id\"] is the cheap diff shape. Summary is opt-in."
},
"format": {
"anyOf": [
{
"type": "string",
"const": "json"
},
{
"type": "string",
"const": "compact"
}
],
"description": "\"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."
},
"having": {
"type": "object",
"properties": {
"count": {
"type": "object",
"properties": {
"gte": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"lte": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": []
},
"unread": {
"type": "object",
"properties": {
"gte": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"lte": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": []
},
"silent_days": {
"type": "object",
"properties": {
"gte": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"lte": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
}
},
"additionalProperties": []
}
},
"description": "Filter groups/sources on derived values.",
"additionalProperties": []
},
"select": {
"anyOf": [
{
"type": "string",
"const": "entries"
},
{
"type": "string",
"const": "sources"
},
{
"type": "string",
"const": "aggregate"
}
],
"description": "\"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\"."
},
"compare": {
"type": "object",
"required": [
"window",
"baseline"
],
"properties": {
"window": {
"type": "string",
"maxLength": 64
},
"baseline": {
"type": "string",
"maxLength": 64
}
},
"description": "Trend detection for aggregates: counts inside the window vs the prior baseline, e.g. {\"window\":\"7d\",\"baseline\":\"28d\"}.",
"additionalProperties": []
},
"group_by": {
"anyOf": [
{
"type": "string",
"const": "source"
},
{
"type": "string",
"const": "collection"
},
{
"type": "string",
"const": "day"
}
]
},
"order_by": {
"anyOf": [
{
"type": "string",
"const": "-discovered_at"
},
{
"type": "string",
"const": "discovered_at"
},
{
"type": "string",
"const": "-published_at"
},
{
"type": "string",
"const": "published_at"
}
],
"description": "Default -discovered_at: newest arrivals first, so backfilled items never hide."
},
"per_source_limit": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "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."
}
},
"additionalProperties": false
}