# API endpoints

All endpoints are `GET`, under `https://twitterscore.io/api/v1/`, and return JSON. Click an endpoint for parameters, examples and errors.

## Scores

- [`bulk_scores_check`](/developers/endpoints/bulk_scores_check/): Twitter Scores for up to 50 accounts in one request
- [`get_twitter_score`](/developers/endpoints/get_twitter_score/): Twitter Score of a single account
- [`get_twitter_scores_diff`](/developers/endpoints/get_twitter_scores_diff/): Change of an account's Twitter Score over the last 7 and 30 days

## Accounts

- [`get_twitter_info`](/developers/endpoints/get_twitter_info/): Profile fields, tags and categories of a single account
- [`limits`](/developers/endpoints/limits/): Current plan limits and monthly usage for the calling API account

## Followers

- [`followers_count_history`](/developers/endpoints/followers_count_history/): Daily follower-count snapshots for an account over a period
- [`get_categorized_followers_count`](/developers/endpoints/get_categorized_followers_count/): Number of monitored followers per account category
- [`get_followers`](/developers/endpoints/get_followers/): Paginated list of an account's smart followers, filterable by category, tag or tag-category.
- [`get_followers_diff`](/developers/endpoints/get_followers_diff/): Follower-count change over the last week and last month
- [`get_followers_score_sum`](/developers/endpoints/get_followers_score_sum/): Aggregated Twitter Score sum and count of an account's smart followers, optionally filtered by tags/categories.
- [`get_tagged_followers_count`](/developers/endpoints/get_tagged_followers_count/): Number of monitored followers per tag, grouped by tag category
- [`get_twitter_top_followers`](/developers/endpoints/get_twitter_top_followers/) _(deprecated)_: Top 5 followers of an account ranked by Twitter Score
- [`top_followers_paginate`](/developers/endpoints/top_followers_paginate/) _(deprecated)_: Paginated list of an account's followers ranked by Twitter Score

## Mentions

- [`get_mentioners`](/developers/endpoints/get_mentioners/): Paginated list of unique accounts that mentioned a target account in a period, with the target's profile.
- [`get_mentions_feed`](/developers/endpoints/get_mentions_feed/): Paginated feed of tweets that mention an account, with engagement metrics and enriched author data.
- [`get_smart_mentions`](/developers/endpoints/get_smart_mentions/): Leaderboard of accounts most mentioned by smart accounts over the last 1, 7 or 30 days (Smart Mentions page).

## Lists

- [`get_alpha`](/developers/endpoints/get_alpha/) _(deprecated)_: Legacy alias of get_smart_follows (Smart Follows / former Alpha ranking)
- [`get_smart_follows`](/developers/endpoints/get_smart_follows/): Accounts ranked by smart-follower momentum (Smart Follows page) over 1, 7 or 30 days
- [`get_tokenless`](/developers/endpoints/get_tokenless/): Crypto projects without a token, ranked by Twitter Score or follower growth
- [`get_top_researched`](/developers/endpoints/get_top_researched/): Top 10 accounts by search or profile-open activity on TwitterScore over the last 24 hours.
- [`get_trending`](/developers/endpoints/get_trending/): Trending accounts ranked by Twitter Score or follower change over 3, 7 or 30 days

## History

- [`friendshipHistory/followed`](/developers/endpoints/friendshipHistory_followed/): Monitored accounts that followed or unfollowed a given account (follow/unfollow log, incoming)
- [`friendshipHistory/following`](/developers/endpoints/friendshipHistory_following/): Accounts a given account started or stopped following (follow/unfollow log, outgoing)

## Reference

- [`get_categories`](/developers/endpoints/get_categories/): List of account categories
- [`get_tags`](/developers/endpoints/get_tags/): List of account tags with their tag categories