List story clusters

Story clusters with flexible sorting, filtering, and offset pagination. Returns real total counts.

get/api/stories

Request

  • Base URL: https://techsnif.com
  • URL: https://techsnif.com/api/stories
  • Auth: none declared

Query parameters

limitinteger
offsetinteger
sort'rank' | 'newest'
tierinteger

Headline tier: 1=standard, 2=major, 3=top story

publisherstring

Case-insensitive partial match on lead publisher

platform'x' | 'bluesky' | 'linkedin' | 'forums' | 'hn' | 'threads' | 'mastodon' | 'other'

Only clusters with discussion on this platform

has_discussion'true'

Only clusters with any social discussion

sincestring date-time

ISO 8601 date — only clusters seen since this time

untilstring date-time

ISO 8601 date, only clusters last seen at or before this time. Combine with since for archive range queries.

topicstring

Topic slug (e.g. ai, security)

entitystring

Entity slug (company, person, or product), only clusters mentioning this entity. Discover slugs via /api/entities.

Response

Story cluster list

totalinteger

Total matching clusters (for pagination)

limitinteger
offsetinteger

Changes

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