Skip to main content
GET
/
services
/
clusters
[
  {
    "clusterId": "<string>",
    "title": "<string>",
    "tldr": "<string>",
    "category": "<string>",
    "createdAt": "<string>",
    "members": [
      {
        "title": "<string>",
        "url": "<string>",
        "clusterId": "<string>",
        "summary": "<string>",
        "pageContent": "<string>",
        "publicationDate": "<string>",
        "sourceType": "<string>",
        "sourceName": "<string>",
        "metadata": {
          "image": "<string>",
          "author": "<string>",
          "published_time": "<string>",
          "modified_time": "<string>",
          "type": "<string>"
        },
        "sourceLogo": "<string>"
      }
    ],
    "thumbnail": "<string>",
    "uniqueSourcesCount": 123,
    "uniqueVideosSourcesCount": 123
  }
]

Query Parameters

categories
string[]

The categories to filter by. If no categories are provided, all clusters will be returned.

sort_by
enum<string>
default:createdAt
Available options:
createdAt,
relevanceScore
order_by
enum<string>
default:desc
Available options:
asc,
desc
min_unique_sources
integer
default:2

The minimum number of unique sources in the cluster

Required range: x >= 0
page
integer
default:1
Required range: x >= 1
per_page
integer
default:10
Required range: 1 <= x <= 30

Response

Successful Response

clusterId
string
required

The cluster id

title
string
required

The title of the cluster (generated by AI)

tldr
string
required

The tldr of the cluster (generated by AI)

category
string
required

The category of the cluster

createdAt
required

The time the cluster was created

members
FeedModel · object[]
required

The list of posts in the cluster

uniqueSourcesCount
integer
required

The number of unique sources in the cluster

uniqueVideosSourcesCount
integer
required

The number of unique video sources in the cluster

thumbnail
string | null

The thumbnail of the cluster

I