API Usage Examples

Learn how you can use the TwitterScore API.

You can use either username or twitter id in any query.

1. Get Twitter Score.

https://twitterscore.io/api/v1/get_twitter_score?api_key=API_KEY&username=elonmusk

Answer example:

{
  "success": true,
  "username": "elonmusk",
  "twitter_id": "44196397",
  "twitter_score": 1000
}

---

1. Get account info.

https://twitterscore.io/api/v1/bulk_scores_check?api_key=API_KEY&ids=IDS&size=50

Answer example:

{
  "success": true,
  "username": "elonmusk",
  "name": "Elon Musk",
  "description": "",
  "followers_count": 199987720,
  "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/44196397.jpg"
}

---

1. Twitter Score bulk check.

https://twitterscore.io/api/v1/get_twitter_info?api_key=API_KEY&twitter_id=44196397

Parameters:
1. username (or twitter_id) - compulsory
2. api_key - compulsory
3. size (number of returned items in the list) – default = 10, max = 50
4. page (page number) - default = 1

Answer example:

{
  "success": true,
  "total": 2,
  "page": 1,
  "size": 2,
  "pages": 1,
  "data": [
    {
      "twitter_id": "44196397",
      "username": "elonmusk",
      "twitter_url": "https://x.com/elonmusk",
      "twitter_score": 1000.0
    },
    {
      "twitter_id": "295218901",
      "username": "VitalikButerin",
      "twitter_url": "https://x.com/VitalikButerin",
      "twitter_score": 1000.0
    }
  ]
}

---

1. Get how much score changed for a week/month.

https://twitterscore.io/api/v1/get_twitter_scores_diff?api_key=API_KEY&twitter_id=1492434155405287424

Answer example:

{
  "success": true,
  "today": "2024-10-03",
  "week": {
    "date": "2024-09-26",
    "diff": 8,
    "diff_str": "+8"
  },
  "month": {
    "date": "2024-09-03",
    "diff": 9,
    "diff_str": "+9"
  }
}

---

1. 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=1492434155405287424

Answer example:

{
  "success": true,
  "total": 25,
  "page": 1,
  "size": 25,
  "pages": 1,
  "followers_count": [
    {
      "date": "2024-10-03",
      "followers_count": 59836
    },
    {
      "date": "2024-10-02",
      "followers_count": 59797
    },
    {
      "date": "2024-10-01",
      "followers_count": 59861
    },
    {
      "date": "2024-09-30",
      "followers_count": 59864
    },
    {
      "date": "2024-09-29",
      "followers_count": 59771
    },
    {
      "date": "2024-09-28",
      "followers_count": 59801
    },
    {
      "date": "2024-09-27",
      "followers_count": 59842
    },
    {
      "date": "2024-09-26",
      "followers_count": 59821
    },
    {
      "date": "2024-09-20",
      "followers_count": 59710
    },
    {
      "date": "2024-09-19",
      "followers_count": 59702
    },
    {
      "date": "2024-09-18",
      "followers_count": 59704
    },
    {
      "date": "2024-09-17",
      "followers_count": 59706
    },
    {
      "date": "2024-09-16",
      "followers_count": 59715
    },
    {
      "date": "2024-09-15",
      "followers_count": 59728
    },
    {
      "date": "2024-09-14",
      "followers_count": 59755
    },
    {
      "date": "2024-09-13",
      "followers_count": 59886
    },
    {
      "date": "2024-09-12",
      "followers_count": 59870
    },
    {
      "date": "2024-09-11",
      "followers_count": 59945
    },
    {
      "date": "2024-09-10",
      "followers_count": 59930
    },
    {
      "date": "2024-09-09",
      "followers_count": 59880
    },
    {
      "date": "2024-09-08",
      "followers_count": 59883
    },
    {
      "date": "2024-09-07",
      "followers_count": 59902
    },
    {
      "date": "2024-09-06",
      "followers_count": 59924
    },
    {
      "date": "2024-09-05",
      "followers_count": 59928
    },
    {
      "date": "2024-09-04",
      "followers_count": 59883
    }
  ]
}

Custom - 3/7/30/180/360/all days

https://twitterscore.io/api/v1/followers_count_history?api_key=API_KEY&twitter_id=44196397&period=3d

Period values:
3 days = 3d
7 days = 7d or 1w
30 days = 30d or 1m
180 days = 180d or 6m
365 days = 365d or 1y
all time = all

Answer example:

{
  "success": true,
  "total": 3,
  "page": 1,
  "size": 3,
  "pages": 1,
  "followers_count": [
    {
      "date": "2024-10-03",
      "followers_count": 199987720
    },
    {
      "date": "2024-10-02",
      "followers_count": 199881491
    },
    {
      "date": "2024-10-01",
      "followers_count": 199725509
    }
  ]
}

---

1. Get top 5 followers by score.

https://twitterscore.io/api/v1/get_twitter_top_followers?api_key=API_KEY&twitter_id=44196397

Answer example:

{
  "success": true,
  "top_followers": [
    {
      "twitter_id": 811350,
      "username": "alexisohanian",
      "name": "Alexis Ohanian 🇦🇲",
      "twitter_score": 1000,
      "followers_count": 571523,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/811350.jpg"
    },
    {
      "twitter_id": 26377478,
      "username": "laurashin",
      "name": "Laura Shin",
      "twitter_score": 1000,
      "followers_count": 250687,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/26377478.png"
    },
    {
      "twitter_id": 710463119886262300,
      "username": "cburniske",
      "name": "Chris Burniske",
      "twitter_score": 1000,
      "followers_count": 300969,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/710463119886262272.jpg"
    },
    {
      "twitter_id": 14379660,
      "username": "brian_armstrong",
      "name": "Brian Armstrong",
      "twitter_score": 1000,
      "followers_count": 1374700,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/14379660.png"
    },
    {
      "twitter_id": 295218901,
      "username": "VitalikButerin",
      "name": "vitalik.eth",
      "twitter_score": 1000,
      "followers_count": 5433227,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/295218901.jpg"
    }
  ]
}

This request is deprecated. It can be completely replaced by request number 11 - Get paginated list of followers

---

1. Get top followers paginate

https://twitterscore.io/api/v1/top_followers_paginate?twitter_id=44196397&api_key=API_KEY&size=2&page=1

Parameters:
1. username (or twitter_id) - compulsory
2. api_key - compulsory
3. size (number of returned items in the list) – default = 5, max = 25
4. page - default = 1

Answer example:

{
  "success": true,
  "total": 11950,
  "page": 1,
  "size": 2,
  "pages": 5975,
  "top_followers": [
    {
      "twitter_id": 339061487,
      "username": "APompliano",
      "name": "Anthony Pompliano 🌪",
      "twitter_score": 1000,
      "followers_count": 1665993,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/339061487.jpg"
    },
    {
      "twitter_id": 1605,
      "username": "sama",
      "name": "Sam Altman",
      "twitter_score": 1000,
      "followers_count": 3029658,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/1605.jpg"
    }
  ]
}

This request is deprecated. It can be completely replaced by request number 11 - Get paginated list of followers

---

1. Get list of all categories

https://twitterscore.io/api/v1/get_categories?api_key=API_KEY

Answer example:

{
  "success": true,
  "total": 9,
  "page": 1,
  "size": 9,
  "pages": 1,
  "categories": [
    {
      "id": 1,
      "name": "Venture Capitals"
    },
    {
      "id": 2,
      "name": "Founders"
    },
    {
      "id": 3,
      "name": "Projects"
    },
    {
      "id": 4,
      "name": "Exchanges"
    },
    {
      "id": 5,
      "name": "Auditors"
    },
    {
      "id": 7,
      "name": "Media"
    },
    {
      "id": 8,
      "name": "Influencers"
    },
    {
      "id": 9,
      "name": "Angels"
    },
    {
      "id": 10,
      "name": "Trading"
    }
  ]
}

---

1. Get list of all tags and tag's category

https://twitterscore.io/api/v1/get_tags?api_key=API_KEY&size=3&page=1

Parameters:
1. api_key - compulsory
2. size (number of returned items in the list) – default = 10, max = 25
3. page - default = 1

Answer example:

{
  "success": true,
  "total": 59,
  "page": 1,
  "size": 3,
  "pages": 20,
  "tags": [
    {
      "id": 1,
      "name": "a16z",
      "tag_categories": [
        {
          "id": 1,
          "name": "Tier 1 VC"
        }
      ]
    },
    {
      "id": 2,
      "name": "Coinbase",
      "tag_categories": [
        {
          "id": 1,
          "name": "Tier 1 VC"
        }
      ]
    },
    {
      "id": 3,
      "name": "Paradigm",
      "tag_categories": [
        {
          "id": 1,
          "name": "Tier 1 VC"
        }
      ]
    }
  ]
}

---

1. Get number of followers in each category

https://twitterscore.io/api/v1/get_categorized_followers_count?twitter_id=44196397&api_key=API_KEY

Answer example:

{
  "success": true,
  "categories": [
    {
      "name": "All",
      "cnt": 11950,
      "id": null
    },
    {
      "name": "Projects",
      "id": 3,
      "cnt": 2921
    },
    {
      "name": "Venture Capitals",
      "id": 1,
      "cnt": 291
    },
    {
      "name": "Influencers",
      "id": 8,
      "cnt": 1058
    },
    {
      "name": "Founders",
      "id": 2,
      "cnt": 3221
    },
    {
      "name": "Angels",
      "id": 9,
      "cnt": 373
    },
    {
      "name": "Media",
      "id": 7,
      "cnt": 216
    },
    {
      "name": "Exchanges",
      "id": 4,
      "cnt": 71
    },
    {
      "name": "Trading",
      "id": 10,
      "cnt": 15
    },
    {
      "name": "Auditors",
      "id": 5,
      "cnt": 4
    },
    {
      "name": "NoCategory",
      "id": 0,
      "cnt": 4490
    }
  ]
}

---

1. Get the number of tagged subscribers in each category

https://twitterscore.io/api/v1/get_tagged_followers_count?api_key=API_KEY&twitter_id=44196397

Answer example:

{"success": true, "data": [{"tag_category_id": 1, "tag_category_name": "Tier 1 VC", "tags": [{"tag_id": 1, "tag_name": "a16z", "cnt": 65}, {"tag_id": 2, "tag_name": "Coinbase", "cnt": 50}, {"tag_id": 11, "tag_name": "binance", "cnt": 22}, {"tag_id": 4, "tag_name": "Sequoia", "cnt": 20}, {"tag_id": 3, "tag_name": "Paradigm", "cnt": 16}, {"tag_id": 7, "tag_name": "Delphi Digital", "cnt": 9}, {"tag_id": 5, "tag_name": "Multicoin Capital", "cnt": 9}, {"tag_id": 23, "tag_name": "Electric Capital", "cnt": 8}, {"tag_id": 32, "tag_name": "Fabric Ventures", "cnt": 7}, {"tag_id": 10, "tag_name": "Blockchain Capital", "cnt": 6}, {"tag_id": 24, "tag_name": "Galaxy Digital", "cnt": 6}, {"tag_id": 57, "tag_name": "IDEO Ventures", "cnt": 6}, {"tag_id": 31, "tag_name": "IOSG VC", "cnt": 6}, {"tag_id": 15, "tag_name": "Pantera Capital", "cnt": 6}, {"tag_id": 28, "tag_name": "Tribe Capital", "cnt": 5}, {"tag_id": 27, "tag_name": "eGirl Capital", "cnt": 5}, {"tag_id": 8, "tag_name": "Animoca Brands", "cnt": 4}, {"tag_id": 35, "tag_name": "Jump Capital", "cnt": 4}, {"tag_id": 29, "tag_name": "Sfermion", "cnt": 4}, {"tag_id": 16, "tag_name": "Arrington Capital", "cnt": 3}, {"tag_id": 9, "tag_name": "Polychain", "cnt": 1}]}, {"tag_category_id": 2, "tag_category_name": "Tier 2 VC", "tags": [{"tag_id": 25, "tag_name": "Dragonfly Capital", "cnt": 16}, {"tag_id": 14, "tag_name": "CoinFund", "cnt": 9}, {"tag_id": 42, "tag_name": "Social Capital", "cnt": 8}, {"tag_id": 40, "tag_name": "Variant", "cnt": 8}, {"tag_id": 30, "tag_name": "YGG Ventures", "cnt": 8}, {"tag_id": 41, "tag_name": "Union Square Ventures", "cnt": 7}, {"tag_id": 37, "tag_name": "ParaFi Capital", "cnt": 6}, {"tag_id": 47, "tag_name": "The Spartan Group", "cnt": 6}, {"tag_id": 36, "tag_name": "CMS Holdings", "cnt": 5}, {"tag_id": 43, "tag_name": "Huobi Ventures", "cnt": 5}, {"tag_id": 39, "tag_name": "Sino Global Capital", "cnt": 5}, {"tag_id": 26, "tag_name": "Mechanism Capital", "cnt": 4}, {"tag_id": 46, "tag_name": "OKX Ventures", "cnt": 4}, {"tag_id": 12, "tag_name": "Solana Ventures", "cnt": 4}, {"tag_id": 44, "tag_name": "Winklevoss Capital", "cnt": 4}, {"tag_id": 49, "tag_name": "Metapurse", "cnt": 3}, {"tag_id": 45, "tag_name": "Not3Lau Capital", "cnt": 3}, {"tag_id": 48, "tag_name": "Hypersphere", "cnt": 2}, {"tag_id": 34, "tag_name": "Republic Labs", "cnt": 2}]}, {"tag_category_id": 3, "tag_category_name": "Ecosystems", "tags": [{"tag_id": 22, "tag_name": "Ethereum", "cnt": 92}, {"tag_id": 13, "tag_name": "Solana", "cnt": 82}, {"tag_id": 53, "tag_name": "Aptos", "cnt": 27}, {"tag_id": 21, "tag_name": "Cosmos", "cnt": 21}, {"tag_id": 20, "tag_name": "Polkadot", "cnt": 21}, {"tag_id": 50, "tag_name": "Kusama Network", "cnt": 6}, {"tag_id": 54, "tag_name": "Sui Network", "cnt": 6}, {"tag_id": 52, "tag_name": "StarkWare", "cnt": 4}, {"tag_id": 55, "tag_name": "LayerZero", "cnt": 3}, {"tag_id": 58, "tag_name": "Eigen Layer", "cnt": 2}, {"tag_id": 59, "tag_name": "Optimism", "cnt": 1}, {"tag_id": 51, "tag_name": "zkSync", "cnt": 1}]}, {"tag_category_id": 4, "tag_category_name": "Other", "tags": [{"tag_id": 17, "tag_name": "NFT influencer", "cnt": 721}, {"tag_id": 6, "tag_name": "NFT", "cnt": 135}, {"tag_id": 18, "tag_name": "nansen_ai", "cnt": 41}, {"tag_id": 19, "tag_name": "FTX", "cnt": 12}, {"tag_id": 33, "tag_name": "Coingecko", "cnt": 5}]}]}

---

1. Get paginated list of followers (filtered by size, tag, category, tag 's category).

https://twitterscore.io/api/v1/get_followers?api_key=API_KEY&twitter_id=44196397

Parameters:
1. username (or twitter_id) - compulsory
2. api_key - compulsory
3. category_id - you can filter followers by category id
4. tag_id - you can filter followers by tag id
5. tag_category_id - you can filter followers by tag category id
6. size (number of returned items in the list) – default = 10, max = 25
7. page - default = 1

Get top 3 followers

https://twitterscore.io/api/v1/get_followers?api_key=API_KEY&twitter_id=44196397&size=3

Answer example:

{
  "success": true,
  "total": 11950,
  "page": 1,
  "size": 3,
  "pages": 3984,
  "top_followers": [
    {
      "twitter_id": "315991624",
      "username": "FEhrsam",
      "name": "Fred Ehrsam",
      "twitter_score": 1000,
      "followers_count": 221126,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/315991624.jpg",
      "tags": [
        {
          "id": 3,
          "name": "Paradigm"
        }
      ],
      "categories": [
        {
          "id": 2,
          "name": "Founders"
        },
        {
          "id": 9,
          "name": "Angels"
        }
      ]
    },
    {
      "twitter_id": "1110877798820777986",
      "username": "SBF_FTX",
      "name": "SBF",
      "twitter_score": 1000,
      "followers_count": 973217,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/1110877798820777986.jpg",
      "tags": [
        {
          "id": 19,
          "name": "FTX"
        }
      ],
      "categories": [
        {
          "id": 2,
          "name": "Founders"
        },
        {
          "id": 9,
          "name": "Angels"
        }
      ]
    },
    {
      "twitter_id": "5943622",
      "username": "pmarca",
      "name": "Marc Andreessen 🇺🇸",
      "twitter_score": 1000,
      "followers_count": 1459570,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/5943622.jpg",
      "tags": [
        {
          "id": 1,
          "name": "a16z"
        }
      ],
      "categories": [
        {
          "id": 2,
          "name": "Founders"
        },
        {
          "id": 9,
          "name": "Angels"
        }
      ]
    }
  ]
}

Get followers from category "Founders"

https://twitterscore.io/api/v1/get_followers?api_key=API_KEY&twitter_id=44196397&category_id=2&size=2

Answer example:

{
  "success": true,
  "total": 3221,
  "page": 1,
  "size": 2,
  "pages": 1611,
  "top_followers": [
    {
      "twitter_id": "61417559",
      "username": "ErikVoorhees",
      "name": "Erik Voorhees",
      "twitter_score": 1000,
      "followers_count": 695472,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/61417559.jpg",
      "tags": [],
      "categories": [
        {
          "id": 2,
          "name": "Founders"
        },
        {
          "id": 9,
          "name": "Angels"
        }
      ]
    },
    {
      "twitter_id": "183749519",
      "username": "paulg",
      "name": "Paul Graham",
      "twitter_score": 1000,
      "followers_count": 1919821,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/183749519.jpg",
      "tags": [],
      "categories": [
        {
          "id": 2,
          "name": "Founders"
        }
      ]
    }
  ]
}

Get followers with tag "Coinbase"

https://twitterscore.io/api/v1/get_followers?api_key=API_KEY&twitter_id=44196397&tag_id=2&size=2

Answer example:

{
  "success": true,
  "total": 50,
  "page": 1,
  "size": 2,
  "pages": 25,
  "top_followers": [
    {
      "twitter_id": "14379660",
      "username": "brian_armstrong",
      "name": "Brian Armstrong",
      "twitter_score": 1000,
      "followers_count": 1374700,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/14379660.png",
      "tags": [
        {
          "id": 2,
          "name": "Coinbase"
        }
      ],
      "categories": [
        {
          "id": 2,
          "name": "Founders"
        },
        {
          "id": 9,
          "name": "Angels"
        }
      ]
    },
    {
      "twitter_id": "857994826230374401",
      "username": "katie_haun",
      "name": "Kathryn Haun",
      "twitter_score": 785.0869353078496,
      "followers_count": 112413,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/857994826230374401.jpg",
      "tags": [
        {
          "id": 2,
          "name": "Coinbase"
        }
      ],
      "categories": [
        {
          "id": 2,
          "name": "Founders"
        },
        {
          "id": 9,
          "name": "Angels"
        }
      ]
    }
  ]
}

Get followers from tag's category "Ecosystems"

https://twitterscore.io/api/v1/get_followers?api_key=API_KEY&twitter_id=44196397&tag_category_id=3&size=2

Answer example:

{
  "success": true,
  "total": 266,
  "page": 1,
  "size": 2,
  "pages": 133,
  "top_followers": [
    {
      "twitter_id": "295218901",
      "username": "VitalikButerin",
      "name": "vitalik.eth",
      "twitter_score": 1000,
      "followers_count": 5433227,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/295218901.jpg",
      "tags": [
        {
          "id": 22,
          "name": "Ethereum"
        }
      ],
      "categories": [
        {
          "id": 2,
          "name": "Founders"
        }
      ]
    },
    {
      "twitter_id": "2362854624",
      "username": "ethereumJoseph",
      "name": "Joseph Lubin",
      "twitter_score": 968.9533256881957,
      "followers_count": 314525,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/2362854624.jpg",
      "tags": [
        {
          "id": 22,
          "name": "Ethereum"
        }
      ],
      "categories": [
        {
          "id": 2,
          "name": "Founders"
        },
        {
          "id": 9,
          "name": "Angels"
        }
      ]
    }
  ]
}

Get followers from category "Projects" with tag "Binance"

https://twitterscore.io/api/v1/get_followers?api_key=API_KEY&twitter_id=44196397&category_id=3&tag_id=11&size=2

Answer example:

{
  "success": true,
  "total": 6,
  "page": 1,
  "size": 2,
  "pages": 3,
  "top_followers": [
    {
      "twitter_id": "877807935493033984",
      "username": "binance",
      "name": "Binance",
      "twitter_score": 873.0048340629618,
      "followers_count": 13253444,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/877807935493033984.jpg",
      "tags": [
        {
          "id": 11,
          "name": "binance"
        }
      ],
      "categories": [
        {
          "id": 1,
          "name": "Venture Capitals"
        },
        {
          "id": 3,
          "name": "Projects"
        },
        {
          "id": 4,
          "name": "Exchanges"
        }
      ]
    },
    {
      "twitter_id": "1400391752368992260",
      "username": "Web3WithBinance",
      "name": "Binance Web3",
      "twitter_score": 153.20173604090135,
      "followers_count": 1890922,
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/1400391752368992260.jpg",
      "tags": [
        {
          "id": 11,
          "name": "binance"
        }
      ],
      "categories": [
        {
          "id": 3,
          "name": "Projects"
        }
      ]
    }
  ]
}

---

1. 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

Parameters:
1. username (or twitter_id) - compulsory
2. date (YYYY-MM-DD) - compulsory
3. api_key - compulsory
4. tag_id (comma-separated string of tag ids e.g. 1,2,3,4)- you can filter accounts by tag id
5. page - default = 1
6. size (number of returned items in the list) – default = 10, min = 1, max = 25

Answer example:

{
  "success": true,
  "total": 9,
  "page": 1,
  "size": 5,
  "pages": 2,
  "data": [
    {
      "action": "Followed",
      "twitter_id": "266386822",
      "username": "alextreece1",
      "name": "Alex Treece",
      "twitter_score": 56.4774201772411,
      "followers_count": 1785,
      "description": "Product lead @Coinbase / @CoinbaseWallet | prev Co-founder at @ZaboAPI (acq by Coinbase)  | Views are my own",
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/266386822.jpg",
      "tags": [
        {
          "id": 2,
          "name": "Coinbase"
        }
      ],
      "created_at": "2022-02-02"
    },
    {
      "action": "Followed",
      "twitter_id": "7769022",
      "username": "scottshapiro",
      "name": "Scott Shapiro 🛡 shapiro.eth",
      "twitter_score": 86.852315072177,
      "followers_count": 3790,
      "description": "@coinbase Product Director, Trading",
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/7769022.png",
      "tags": [
        {
          "id": 2,
          "name": "Coinbase"
        }
      ],
      "created_at": "2022-02-02"
    },
    {
      "action": "Followed",
      "twitter_id": "11256152",
      "username": "mittal",
      "name": "Alex Mittal",
      "twitter_score": 55.2633650866795,
      "followers_count": 4604,
      "description": "Co-Founder @fundersclub. Seed investor @coinbase @Instacart @flexport @GitLab @webflow @Rippling @EquipmentShare & others defining the future.",
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/11256152.jpeg",
      "tags": [
        {
          "id": 2,
          "name": "Coinbase"
        }
      ],
      "created_at": "2022-02-02"
    },
    {
      "action": "Followed",
      "twitter_id": "1026411197669625858",
      "username": "BinanceHelpDesk",
      "name": "Binance Customer Support",
      "twitter_score": 51.1801590269018,
      "followers_count": 194016,
      "description": "Official @Binance customer support. We’re here to help!\nAny questions, drop us a DM. Include your case ID if you have one. \n24/7 live chat in 17 languages.",
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/1026411197669625858.jpg",
      "tags": [
        {
          "id": 11,
          "name": "binance"
        }
      ],
      "created_at": "2022-02-02"
    },
    {
      "action": "Followed",
      "twitter_id": "359126146",
      "username": "faryarshirzad",
      "name": "Faryar Shirzad 🛡️",
      "twitter_score": 128.066111127964,
      "followers_count": 7888,
      "description": "Chief Policy Officer @Coinbase. Immigrant. Love America 🇺🇸",
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/359126146.jpg",
      "tags": [
        {
          "id": 2,
          "name": "Coinbase"
        }
      ],
      "created_at": "2022-02-02"
    }
  ]
}

Get friendship History - following

https://twitterscore.io/api/v1/friendshipHistory/following?username=USERNAME&api_key=API_KEY&date=DATE&size=SIZE

Answer example:

{
  "success": true,
  "total": 6,
  "page": 1,
  "size": 3,
  "pages": 2,
  "data": [
    {
      "action": "Following",
      "twitter_id": "1680096747316723712",
      "username": "shanhaiwoo",
      "name": "ShanhaiWoo 山海坞",
      "twitter_score": 7.070666427685702,
      "followers_count": 592,
      "description": "An ideal place constructed by each member with their most romantic desire for what the community ought to be. 共建最浪漫愿景的理想之地。",
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/1680096747316723712.jpg",
      "created_at": "2024-11-07"
    },
    {
      "action": "Following",
      "twitter_id": "1658531764296376322",
      "username": "themu_xyz",
      "name": "the-mu📍ChiangMai",
      "twitter_score": 5.213843163418756,
      "followers_count": 2402,
      "description": "Connecting minds to learn and build practical solutions for real-world problems.",
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/1658531764296376322.jpg",
      "created_at": "2024-11-07"
    },
    {
      "action": "Following",
      "twitter_id": "1630710109713354753",
      "username": "EIPFun",
      "name": "EIP Fun",
      "twitter_score": 10.159905533794912,
      "followers_count": 1440,
      "description": "Ethereum standards education & research | Serve Ethereum builders & Scale community. Supported by @EthPanda_org and @LXDAO_Official. TG: https://t.co/0xrLbMYdbH",
      "profile_image": "https://twitterscore.s3.amazonaws.com/media/profiles/1630710109713354753.jpg",
      "created_at": "2024-11-07"
    }
  ]
}

---

1. Check your API limits.

https://twitterscore.io/api/v1/limits?api_key=API_KEY

Answer example:

{"user_id": 20991, "rates": [{"period": "month", "total": 200000, "used": 10700, "remaining": 189300, "reset_time_at": "2025-05-12T18:27:41.280"}, {"period": "minute", "total": 60}]}

---

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.