🟢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

post

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.

Query parameters

aggany ofOptionalDefault: sumsquare

string · enumOptionalPossible values:

or

nullOptional

weightsany ofOptionalDefault: L1C10R5

stringOptional

or

nullOptional

votingany ofOptionalDefault: single

string · enumOptionalPossible values:

or

nullOptional

kinteger · max: 5OptionalDefault: 2

limitany ofOptionalDefault: 100

integer · max: 1000Optional

or

nullOptional

Body

integer[]Optional

Responses

200

Successful Response

application/json

Responseany

422

Validation Error

application/json

post

HTTPcURLJavaScriptPython

POST /frames/personalized/rankings/fids HTTP/1.1
Host: graph.cast.k3l.io
Content-Type: application/json
Accept: */*
Content-Length: 5

[
  1,
  2
]

No content

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