🟢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.

post

/frames/personalized/rankings/fids

Query parameters

aggAgg

weightsWeights

votingVoting

kK

limitLimit

Body

itemsinteger

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://graph.cast.k3l.io/frames/personalized/rankings/fids' \
  --header 'Content-Type: application/json' \
  --data '[1,2]'

200

422

200

No body

Successful Response

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