Search
K

Profile Scores

Retrieve a list of global profile scores on the Lens ecosystem
The /profile/scores endpoint retrieves a list of numeric profile scores and ranks in relations with all other profiles, ordered by the highest score. Each profile score ranges between 0 and 1, with 0 being the lowest score and 1 being the highest score.
This endpoint also returns a rank position, starting with 1 as the top-ranked profile calculated for the day, and n being the lowest ranked, with n being the number of profiles included in the converged scoring calculations for the day.
This endpoint requires a strategy parameter as described in the Scoring Strategies section. This strategy simplifies the developer experience abstracting away the EigenTrust Local-Trust and Pre-Trust strategies. Each strategy is pre-computed on a daily basis and applied to each Lens profile.
For details on each strategy ID, see Profile Scoring Strategies
The results returned are paginated to 50 profiles per response by default. This can be managed with a limit parameter with pagination alongside an offset parameter (first record at offset position 0). To help with pagination, you can use the Profile Count endpoint to retrieve the total number of profiles available.
By using the date parameter, you can choose a particular day when the strategies were generated. This is helpful to get a snapshot in time of where each profile scores and ranks are, to help develop time series metrics dashboards for each profile to see how their scores trend over time.

API Documentation

get
https://lens-api.k3l.io
/profile/scores
Return a paginated list of all profile scores

Returns the global profile scores, ordered by the highest scoring profiles, according to a given strategy.

Parameters
Query
strategy*
string
The strategy name to use such as 'followship', 'engagement', 'influencer', or 'creator'.
offset
integer
Return results starting from this offset position. Defaults to start at `0`, the first result.
limit
integer
Number of entries to return. Defaults to `50`.
date
string
A date, in `YYYY-MM-DD` format, for which to return the historic result. Defaults to the most recent date.
Responses
200: OK
Query succeeded.
400: Bad Request
Invalid request, ex: wrong parameters.
500: Internal Server Error
Internal server error, not caused by issues with the request.
You can try out this API at this OpenAPI interfacehttps://openapi.lens.k3l.io
Last modified 3mo ago