Global Profile Ranking API

OpenRank APIs for Global Profile Ranking

Global Rankings

List of Available Strategies

  • following: This strategy emphasizes only follows as relevant and meaningful peer-to-peer attestations, disregarding mentions, recasts, replies and likes.

  • engagement: This strategy emphasizes peer-to-peer likes, recasts, replies and mentions in increasing order of importance.

API Docs: https://graph.cast.k3l.io/docs#/

Strategy: Followings

Endpoint: /scores/global/following/rankings

Paramaters: 2 optional parameters (limit, offset).

Example below using curl, returns the Top 100 most popular profiles

curl -X 'GET' \
  'https://graph.cast.k3l.io/scores/global/following/rankings' \
  -H 'accept: application/json'

Example with limit and offset for profiles ranked from 501 to 550 (inclusive)

curl -X 'GET' \
  'https://graph.cast.k3l.io/scores/global/following/rankings?offset=500&limit=50' \
  -H 'accept: application/json'

Strategy: Engagement

Endpoint: /scores/global/engagement/rankings

Parameters: Two optional parameters (limit, offset).

Similarly, returns the Top 100 Highly Engaged Profiles

curl -X 'GET' \
  'https://graph.cast.k3l.io/scores/global/engagement/rankings' \
  -H 'accept: application/json'

Example with limit and offset from 301 to 400 (inclusive)

curl -X 'GET' \
  'https://graph.cast.k3l.io/scores/global/engagement/rankings?offset=300&limit=100' \
  -H 'accept: application/json'

Discovering Global Rank

Endpoint: /scores/global/following/handles

Parameters: An array of Farcaster handles posted to the body of the request

To retrieve the global rank of a specific user, use a query like the following:

curl -X 'POST'
  'https://graph.cast.k3l.io/scores/global/following/handles'
  -H 'accept: application/json' -H 'Content-Type: application/json'
  -d '["dwr.eth"]'

Last updated