🔵Top Frames

Get a list of frame urls that are used by highly ranked profiles.

Discover high quality Frames (casts with frames) based on the ranking of profiles that have casted or engaged with the Frame (cast). The ranking of a Frame depends on a weighted linear combination of the scores of all the profiles that have interacted with the frame (cast) and the parameters of this API are used to control the weights and combination.

Developers can choose their own preferred strategies to rank frames. For simplicity, we have provided a reasonable default parameter setting.

This is a GET request to https://graph.cast.k3l.io/frames/global/rankings with a few optional parameters which are described further below.

/frames/global/rankings

Get Top Frames

Get a list of frame urls that are used by highly ranked profiles. This API takes four optional parameters - agg, weights, details, k and limit. Parameter agg is used to define the aggregation function and can take any of the following values - rms, sumsquare, sum.

Parameter weights is used to define the weights to be assigned to like, cast and recast actions by profiles.

Parameter details is used to specify whether the original cast list should be returned for each frame in the ranking.

(Note: cast hashes and warpcast urls are returned in chronological order ie., oldest first) (NOTE: details=True will result in a few extra hundred milliseconds in response times).

(NOTE: the API returns upto a max of 100 cast hashes and 100 warpcast urls when details=True).

Parameter offset is used to specify how many results to skip and can be useful for paginating through results.

Parameter limit is used to specify the number of results to return.

By default, agg=rms, weights=L1C10R5, details=False, offset=0 and limit=100 i.e., returns top 100 frame urls.

GEThttps://graph.cast.k3l.io/frames/global/rankings

Query parameters

Response

200422

Successful Response

Body

application/json

any

Request

JavaScriptCurlPython

const response = await fetch('https://graph.cast.k3l.io/frames/global/rankings', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

422

{
  "detail": [
    {
      "loc": [
        "text"
      ],
      "msg": "text",
      "type": "text"
    }
  ]
}