MadFi
Search
K

Suggested Follows

Based on our ML tagging, get a list of recommended profiles for the given profile to follow
For clients, we offer an API that recommends profiles to the logged in profile based - based on our ML tagging.
The API attempt to tag the logged in user and surfaces profiles that have been tagged the same (ex: music, nft, creator economy). If the tagging service is unsuccessful, it returns a list of trending profiles based on engagement over the past 14 days.
For a given profileId, return a list of recommended profiles that have the same ML tags.

GET /suggested_follows

https://api.madfi.xyz/prod/suggested_follows?profileId=0x123
where profileId is the Lens profile is of the logged in user
MUST include the api key in the header for x-api-key
Example response:
{
"suggestedFollows": {
"interest": "ART_ENTERTAINMENT__MUSIC",
"suggestedProfiles": [
"0x012d4e",
"0xb096",
"0xf0ca"
],
"allProfiles": [
"0x01afc5",
"0x017655",
...
],
"promotedProfile": "0x012d4e"
}
}
key
type
description
interest
string
the Lens Profile Interest that is the basis for these recommended profiles
suggestedProfiles
string[]
sample of array of Lens Profile Ids for users tagged with this interest (max 3)
allProfiles
string[]
full array of suggested profiles
promotedProfile
string | undefined
for the given interest - if a profile is currently being promoted, their profile id