Sign in

v52

latestOpenAPI 3.0.3raw.githubusercontent.com2026-07-2113138232.4 KB
trends

Articles in a Trend

Retrieve a list of published articles belonging to a trend.

Article Ordering & Proximity:

  • Articles are mapped to trends based on their embedding distance to the trend's centroid.
  • Returned articles are ordered by proximity/similarity (distance) first (most relevant posts first), and then by overall article engagement score.
  • Supports pagination, each page will contain 10 articles by default.
get/api/trends/{trend_id_or_slug}/articles

Path parameters

trend_id_or_slugstring required

The ID or slug of the trend to retrieve articles for.

Query parameters

pageinteger

Pagination page

per_pageinteger

Page size (the number of items to return per page). The default maximum value can be overridden by "API_PER_PAGE_MAX" environment variable.

Response

A List of Articles in the Trend

type_ofstring required
idinteger required
titlestring required
descriptionstring required
cover_imagestring url nullable required
readable_publish_datestring required
social_imagestring url required
tag_liststring[] required
tagsstring required
slugstring required
pathstring path required
urlstring url required
canonical_urlstring url required
positive_reactions_countinteger required
public_reactions_countinteger required
created_atstring date-time required
edited_atstring date-time nullable required
crossposted_atstring date-time nullable required
published_atstring date-time required
last_comment_atstring date-time required
published_timestampstring date-time required

Crossposting or published date time

reading_time_minutesinteger required

Reading time, in minutes