Get currently trending casts
This API returns a list of trending casts on Farcaster. Our models detect casts that are getting more attention before they become hot and popular.
This API has 2 modes of operation: 1) top_k
(impression) mode and 2) paging
mode. top_k
mode is used if top_k
is specified (and page_size
, page_number
parameters ignored), otherwise paging
mode is used.
-
In
top_k
mode, you specify atop_k
along with animpression_count
.impression_count
specifies the number of items in the returned results to be considered "seen" by the viewing user, and those items will be excluded in subsequent API calls. Ifimpression_count
is 0, the same list is returned everytime. -
In
paging
mode, you can request for a specific range of items using a simple paging mechanism specified bypage_size
andpage_number
. No impression information is taken into consideration when returning the items list.