Affinity

View user's mutuals, ranked by affinity.

Get all mutuals with affinity ranking

post

Retrieve all mutual connections for a Farcaster user, ranked by combined attention + influence scores.

Body

application/json

Request model for all mutuals endpoint.

fidintegerRequired

Farcaster ID to get mutuals for

api_keystringRequired

API key for authentication

Responses

200

Successfully retrieved ranked mutuals

application/json

401

Unauthorized - Invalid API key

404

No mutuals found for the provided FID

422

Validation Error

application/json

500

Internal Server Error

post

/v1/farcaster-connections-all

HTTPcURLJavaScriptPython

POST /v1/farcaster-connections-all HTTP/1.1
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "fid": 1,
  "api_key": "text"
}

{
  "fid": 1,
  "mutuals": [
    {
      "fid": 1,
      "username": "text",
      "pfp_url": "text",
      "rank": 1,
      "combined_score": 1,
      "attention_score": 1,
      "influence_score": 1
    }
  ],
  "count": 1
}