🟢Personalized Recommended Frames

Given a list of FIDs, return a list of frame urls used by the extended trust network

Discover high quality Frames (casts with frames) based on your personalized social graph. This ranking follows an approach very similar to the Global Frame Rankings endpoint described in the previous section, but the difference is that we replace the global graph with a personalized graph specific to the given profile. In other words, Frames are assigned scores that are weighted linear combination of the interactions and trust scores of profiles within a given profile’s personalized (Extended network) trust graph.

/frames/personalized/rankings/fids

Get Personalized Frames For Fids

Given a list of input fids, return a list of frame urls used by the extended trust network of the input fids.

This API takes four optional parameters - agg, weights, 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 voting is used to decide whether there is a single vote per neighbor or multiple votes per neigbor when deriving the frames score.

Parameter k is used to constrain the social graph to k-degrees of separation.

By default, agg=rms, weights=L1C10R5, voting=single, k=2 and limit=100.

POSThttps://graph.cast.k3l.io/frames/personalized/rankings/fids

Query parameters

Body

application/json

itemsinteger

Response

200422

Successful Response

Body

application/json

any

Request

JavaScriptCurlPython

const response = await fetch('https://graph.cast.k3l.io/frames/personalized/rankings/fids', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify([
      1,
      2
    ]),
});
const data = await response.json();

Response

422

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

Query via handles: /frames/personalized/rankings/handles [Try It!]