Get Publication Feed | Captain Docs

import requests
url = "https://host.com/v2/datasets/odyssey/publications/feed"
querystring = {"since":"since","until":"until","cursor":"cursor","page_size":"1","publications":"[\"publications\"]","publication":"[\"publication\"]","sector":"sector","has_entities":"true","fields":"fields","title_only":"true"}
payload = {}
headers = {"Content-Type": "application/json"}
response = requests.get(url, json=payload, headers=headers, params=querystring)
print(response.json())

{
  "articles": [
    {
      "id": "a1b2c3d4e5f6g7h8i9j0",
      "title": "Breakthrough in Renewable Energy Technology Announced",
      "url": "https://www.technewsdaily.com/articles/renewable-energy-breakthrough-2024",
      "publication": "Tech News Daily",
      "published_at": "2024-06-10T08:30:00Z",
      "enrichment_status": "complete",
      "sector": "Energy",
      "authors": [
        "Jane Smith",
        "Robert Johnson"
      ],
      "summary": "Researchers have developed a new solar panel that significantly increases energy conversion efficiency, promising a major impact on sustainable energy solutions.",
      "entities": [
        {
          "type": "Organization",
          "name": "SolarTech Innovations"
        },
        {
          "type": "Person",
          "name": "Dr. Emily Carter"
        }
      ]
    }
  ],
  "has_more": true,
  "next_cursor": "eyJwYWdlIjoxLCJ0aW1lc3RhbXAiOiIyMDI0LTA2LTEwVDA4OjMwOjAwWiJ9",
  "page_size": 1
}

Chronological, cursor-paginated stream of articles.

Always-live (CAP-418): every read synthesizes the feed on-read via the aggregate_feed engine (combined-batch GN fan-out + native RSS, merge/dedupe, recency sort). fields=ids is the cheap title-only mode; fields=full marks not-yet-enriched articles enrichment_status="pending" (it does not enrich a whole page inline — hydrate individual articles via the point lookup, which is the lazy Ex-Res trigger). The aggregated listing is never cached; only the per-article work is. since/until window by time; page via next_cursor.

WS-4 filters: publications= is a cheap pre-enrichment publisher allowlist; sector= / has_entities= are post-enrichment, so they hydrate the page on demand (page clamped low + per-request enrichment budget + wall-clock deadline → partial page + cursor when a bound is hit).

Chronological, cursor-paginated stream of articles. Always-live (CAP-418): every read synthesizes the feed on-read via the aggregate_feed engine (combined-batch GN fan-out + native RSS, merge/dedupe, recency sort). `fields=ids` is the cheap title-only mode; `fields=full` marks not-yet-enriched articles `enrichment_status="pending"` (it does not enrich a whole page inline — hydrate individual articles via the point lookup, which is the lazy Ex-Res trigger). The aggregated listing is never cached; only the per-article work is. `since`/`until` window by time; page via `next_cursor`. WS-4 filters: `publications=` is a cheap pre-enrichment publisher allowlist; `sector=` / `has_entities=` are post-enrichment, so they hydrate the page on demand (page clamped low + per-request enrichment budget + wall-clock deadline → partial page + cursor when a bound is hit).

Query parameters

sincestringOptional

Start boundary: items at/after this ISO-8601 UTC timestamp

untilstringOptional

End boundary: items strictly before this ISO-8601 UTC timestamp

cursorstringOptional

Opaque next_cursor from a prior page; supersedes until

page_sizeintegerOptional1-500Defaults to 100

publicationsstringOptional

Pre-enrichment allowlist: only articles from these publishers (registrable domain, canonical slug, or catalog name)

publicationstringOptional

Singular alias of publications (accepted for compatibility; merged with publications)

sectorstringOptional

Filter to articles whose enriched sector matches (hydrates the page on demand; page is clamped + budgeted). Tolerant of case, separators, and shorthand (e.g. fintech matches Financial Services)

has_entitiesbooleanOptional

Filter to articles that did/didn’t resolve any entity (hydrates the page on demand; page is clamped + budgeted)

fieldsstringOptionalformat: "^(ids|full)$"Defaults to full

‘ids’ = title-only (no Ex-Res); ‘full’ = entity-linked

title_onlybooleanOptional

Alias for fields=ids: titles + ids only, no entity-linking

Response

Successful Response

articleslist of maps from strings to any

has_morebooleanDefaults to false

next_cursorstring

page_sizeinteger

Chronological, cursor-paginated stream of articles.