Get Profile Statistics

Retrieves key performance statistics for a twitter profile, including views, interactions, follower metrics and more.

curl --location --request GET 'https://public-api.protokols.io/api/v1/profile/elonmusk/stats?timeframe=' \ --header 'authorization: Bearer 99f0c8fbb6df52400c8edac910f9dbb3be93faea06ba928bba24011252409c4a'

{ "data": { "kol_score": 43944, "smart_followers_count": 3458, "followers_count": 221719185, "followers_change": 0.518181, "smart_engagement": 1517, "smart_engagement_change": "32.6049", "engagement_rate": 0.5474615428492378, "avg_views": 34967200, "avg_likes": 176886, "total_account_posts": 270, "total_organic_posts": 27197, "total_posts": 27467, "total_posts_change": 25.955, "total_account_comments": 642, "threads_count": 27197, "total_account_views": 9709100976, "total_organic_views": 985134490, "total_views": 10694235466, "total_views_change": 1.23142, "total_account_interactions": 53153594, "total_organic_interactions": 12686683, "total_interactions": 53153594, "total_interactions_change": 0, "total_account_likes": 47759121, "total_account_retweets": 5393831, "total_account_replies": 642 } }

Request

Path Params

UsernameOrId

string

required

Twitter username or ID

Example:

elonmusk

Query Params

timeframe

string

required

Timeframe for trend statistics (e.g., 24h, 7d, 30d, 90d). If not provided, defaults to '30d'

Header Params

authorization

string

optional

Default:

Bearer {{auth_token}}

Responses

🟢200Success

application/json

Successfully retrieved KOL statistics.

Body

data

object (Profile Stats)

required

kol_score

integer

required

smart_followers_count

integer

required

followers_count

integer

required

followers_change

number

required

smart_engagement

integer

required

smart_engagement_change

number

optional

engagement_rate

number

required

avg_views

number

required

avg_likes

number

required

total_account_posts

integer

required

total_organic_posts

integer

required

total_posts

number

required

total_posts_change

number

required

total_account_comments

integer

required

threads_count

integer

required

total_account_views

integer

required

total_organic_views

integer

required

total_views

number

required

total_views_change

number

required

total_account_interactions

integer

required

total_organic_interactions

integer

required

total_interactions

integer

required

total_interactions_change

integer

required

total_account_likes

integer

required

total_account_retweets

integer

required

total_account_replies

integer

required

🟠404Record not found

🟠400Invalid input