getTrending

POST

/api/trending/find

Find trending users

Request

Authorization

Add parameter in header

apikey

Example:

apikey: ********************

Body Params application/json

Example

{
    "page": 1,
    "limit": 20,
    "ratio": "Likes",
    "protocol": "Lens",
    "categories": [
        0
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://api.handlefinder.xyz/api/trending/find' \
--header 'apikey: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 1,
    "limit": 20,
    "ratio": "Likes",
    "protocol": "Lens",
    "categories": [
        0
    ]
}'

Responses

🟢200OK

application/json

Trending users

Body

Example

{
    "users": [
        {
            "user": {
                "id": "0x13",
                "handle": {
                    "localName": "john.doe"
                },
                "metadata": {
                    "coverPicture": {
                        "optimized": {
                            "uri": "https://example.com/optimized_picture.jpg"
                        }
                    },
                    "displayName": "John Doe",
                    "picture": {
                        "raw": {
                            "uri": "https://example.com/image.jpg"
                        }
                    },
                    "bio": "I love coding and photography."
                },
                "stats": {
                    "followers": 100,
                    "following": 200,
                    "lensClassifierScore": 0.8,
                    "posts": 50
                }
            },
            "topFollowers": [
                {}
            ]
        }
    ],
    "page": 1,
    "total": 50,
    "totalPages": 50
}

🟠401Unauthorized

getTokenPublicationMentions

getTrendingTokensWithStats