/casts/feed/trending

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.

1. In top_k mode, you specify a top_k along with an impression_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. If impression_count is 0, the same list is returned everytime.

2. In paging mode, you can request for a specific range of items using a simple paging mechanism specified by page_size and page_number. No impression information is taken into consideration when returning the items list.

This API supports the feed_id parameter, a way to specify all filter options through the console without the need to do so in the API calls. See our guide on feed_id for more information. If the same parameters already specified in the feed_id are supplied in the API call, the values in saved in the feed_id will be overridden.