Browse, search, or sync items

get/v1/items

Request

  • Base URL: https://hottub.news
  • URL: https://hottub.news/v1/items
  • Auth: none declared

Query parameters

qstring

All words must appear in title or summary

langstring

Comma-separated ISO 639-1

countrystring

Comma-separated ISO 3166-1 alpha-2 (publisher's country)

topicstring
sourcestring

Source ids or publisher domains

kindstring

article, press_release, official, community, research, sponsored

sincestring

RFC 3339, date, unix seconds, or age like 6h

untilstring
afterinteger

Sync cursor: items with seq > after, oldest first

beforestring

Paging cursor from next

limitinteger
sponsored'include' | 'exclude' | 'only'
categorystring

Comma-separated IPTC top-level categories

sentimentstring

negative, neutral, positive

politicalboolean
tone_minnumber
tone_maxnumber
match'hybrid' | 'keyword' | 'semantic'

How q= matches

collapse'story'

One item per story

per_sourceinteger

At most N items per publisher (browse only)

sort'newest' | 'hot' | 'positive' | 'negative'
format'json' | 'ndjson' | 'lines' | 'md' | 'rss' | 'jsonfeed'

Response

A page of items

schema'hottub-news/list/v1' required
item_schemastring
countinteger required
cursorinteger
nextstring
sponsoredinteger required

Changes

No recorded changes to this operation across all 1 revision of this API.