API Documentation
By utilizing the TwitterScore API, you have the ability to access and leverage any information from the platform to your advantage. The limits on requests are based on your subscription plan.
USERNAME = username of X (Twitter) account.
API_KEY = TwitterScore API key.
TWITTER_ID = X (Twitter) ID. You can get from 1 request.
Api Guide:
You can use either username or twitter id in any query.
Get Twitter Score.
https://twitterscore.io/api/v1/get_twitter_score?api_key=API_KEY&username=USERNAME
Answer Data: (Username, Twitter_id, Twitter Score)
Twitter Score bulk check.
https://twitterscore.io/api/v1/bulk_scores_check?api_key=API_KEY&ids=IDS&size=50
Answer Data: (Twitter ID, Username, Twitter Url, Twitter Score)
Get account info.
https://twitterscore.io/api/v1/get_twitter_info?api_key=API_KEY&twitter_id=TWITTER_ID
Answer Data: (Username, Name, Description, Followers Count, PFP Link)
Get how much score changed for a week/month.
https://twitterscore.io/api/v1/get_twitter_scores_diff?api_key=API_KEY&twitter_id=TWITTER_ID
Answer Data: (Twitter score changed for a week, for a month)
Get how much followers count changed for a week / month.
https://twitterscore.io/api/v1/get_followers_diff?api_key=API_KEY&twitter_id=TWITTER_ID
Answer Data: (Followers count diff for a week and for a month, with reference dates.)
Get history of followers count (for 3 / 7 / 30 / 180 / 360 / all days).
Default - 30 days
https://twitterscore.io/api/v1/followers_count_history?api_key=API_KEY&twitter_id=TWITTER_ID
Custom - 3/7/30/180/360/all days
https://twitterscore.io/api/v1/followers_count_history?api_key=API_KEY&twitter_id=TWITTER_ID&period=1w
Or
https://twitterscore.io/api/v1/followers_count_history?api_key=API_KEY&twitter_id=TWITTER_ID&period=all&page=PAGE
Answer Data: (Returns the number of subscribers for each day. You can read page by page by passing parameters: page)
Get list of all categories
https://twitterscore.io/api/v1/get_categories?api_key=API_KEY
Answer Data: (Returns a list of all categories: id, name)
Get list of all tags and tag's category
https://twitterscore.io/api/v1/get_tags?api_key=API_KEY
Answer Data: (Returns a list of all tags with their category)
Get number of followers in each category
https://twitterscore.io/api/v1/get_categorized_followers_count?username=USERNAME&api_key=API_KEY
Answer Data: (Number of followers in each category)
Get the number of tagged subscribers in each category
https://twitterscore.io/api/v1/get_tagged_followers_count?api_key=API_KEY&username=USERNAME
Answer Data: (Returns the number of tagged subscribers in each category)
Get paginated list of followers (filtered by size, tag, category, tag 's category).
Get list of all followers
https://twitterscore.io/api/v1/get_followers?api_key=API_KEY&twitter_id=TWITTER_ID
You can read page by page by passing parameters: page and size:
https://twitterscore.io/api/v1/get_followers?API_KEY&twitter_id=TWITTER_ID&size=SIZE&page=PAGE
Answer Data: (Returns a list of all followers sorted by twitter score)
Get list of followers filtred by category
https://twitterscore.io/api/v1/get_followers?API_KEY&twitter_id=TWITTER_ID&category_id=CATEGORY_ID
Answer Data: (Returns a list of all followers in specified category sorted by twitter score. You can read page by page by passing parameters: page and size)
Get list of followers filtred by tag
https://twitterscore.io/api/v1/get_followers?API_KEY&twitter_id=TWITTER_ID&tag_id=TAG_ID
Answer Data: (Returns a list of all followers with specified tag sorted by twitter score. You can read page by page by passing parameters: page and size)
Get list of followers filtred by tag 's category
https://twitterscore.io/api/v1/get_followers?API_KEY&twitter_id=TWITTER_ID&tag_category_id=TAG_CATEGORY_ID
Answer Data: (Returns a list of all followers in specified tag's category sorted by twitter score. You can read page by page by passing parameters: page and size)
Get friendship History.
Get friendship History - followed
https://twitterscore.io/api/v1/friendshipHistory/followed?username=USERNAME&api_key=API_KEY&date=DATE&tag_ids=TAG_IDS&size=SIZE
Answer Data: (Returns a list of followed accounts on a specified date. Could be filtred by tag id.)
Get friendship History - following
https://twitterscore.io/api/v1/friendshipHistory/following?username=USERNAME&api_key=API_KEY&date=DATE&tag_ids=TAG_IDS&size=SIZE
Answer Data: (Returns a list of following accounts on a specified date. Could be filtred by tag id.)
Check your API limits.
https://twitterscore.io/api/v1/limits?api_key=API_KEY
Answer Data: (Returns a stats of your API subscription.)
NEW ENDPOINTS 🔥
Get aggregated TwitterScore sum of smart followers.
https://twitterscore.io/api/v1/get_followers_score_sum?api_key=API_KEY&twitter_id=TWITTER_ID
Answer Data: (Returns the sum of TwitterScore across all smart followers of the account (filterable by tags / categories), plus basic profile info.)
Get top accounts by mentions over a period (SMART MENTIONS PAGE).
https://twitterscore.io/api/v1/get_smart_mentions?api_key=API_KEY
Answer Data: (Returns top accounts ranked by how often they were mentioned over the selected period (1/7/30 days). Same data that powers the /smart-mentions/ page. Each row includes mention totals, unique mentioners count, deltas vs previous period, top_mentioner snapshot and mentioners_list preview.)
Get list of unique mentioners for an account.
https://twitterscore.io/api/v1/get_mentioners?api_key=API_KEY&twitter_id=TWITTER_ID
Answer Data: (Returns account profile info + list of unique accounts that mentioned it over the selected period. Corresponds to the "Unique Mentions" column on the Smart Mentions page.)
Get smart mentions feed for an account.
https://twitterscore.io/api/v1/get_mentions_feed?api_key=API_KEY&username=USERNAME
Answer Data: (Returns a paginated feed of tweets that mention the specified account. Each mention includes post text, engagement metrics (favorites/retweets/replies/ views), author info with twitter_score + categories + tags, and attached media/ URLs.)
Get trending accounts.
https://twitterscore.io/api/v1/get_trending?api_key=API_KEY
Answer Data: (Returns the list of trending accounts over the selected period (3/7/30 days) with follower and twitter_score deltas. Same data that powers the /trending/ page.)
Get top researched accounts (last 24 hours).
https://twitterscore.io/api/v1/get_top_researched?api_key=API_KEY
Answer Data: (Returns the top 10 crypto accounts by search/lookup activity over the last 24 hours. Same data that powers the /topResearched/ page.)
Get tokenless projects.
https://twitterscore.io/api/v1/get_tokenless?api_key=API_KEY
Answer Data: (Returns a paginated list of tokenless crypto accounts ranked by followers growth. Same data that powers the Airdrop page. Each item includes twitter_score, current/previous follower counts with delta.)
Get Smart Follows accounts.
https://twitterscore.io/api/v1/get_alpha?api_key=API_KEY
Answer Data: (Returns a paginated list of accounts ranked by new alpha followers gained over a configurable period. Same data that powers the Alpha page.)
DEPRECATED
Get top 5 followers by score.
https://twitterscore.io/api/v1/get_twitter_top_followers?api_key=API_KEY&twitter_id=TWITTER_ID
Answer Data: (Top 5 followers by score, usernames, names, score, followers count, PFP Link)
This request is deprecated. It can be completely replaced by request - Get paginated list of followers
Get top followers paginate
https://twitterscore.io/api/v1/top_followers_paginate?username=USERNAME&api_key=API_KEY&size=SIZE&page=PAGE
Answer Data: (Paginated list of top followers)
This request is deprecated. It can be completely replaced by request - Get paginated list of followers
If you can't find the feature you need here, feel free to contact us. We'll work together to find a solution for your problem.
Last updated