API Documentation

The goal of Followays is to provide the most important metrics about a variety of social accounts via the simple API.

Use cases

• tracking the growth of your social accounts
• assessing the influencers' audience size

Social services supported

• Twitter (X) (twitter): number of followers, number of following, number of posts (Tweets) - by Twitter handle
• YouTube (youtube): number of subscribers, number of videos - by YouTube channel handle
• Telegram (telegram): number of group members - by group t.me/ name
• more to come...

Endpoints

Get full data for a single account

GET /profiles/[SERVICE]/[HANDLE]

Example request:

GET /profiles/twitter/nytimes (get all data for The New York Times Twitter account)

Example response:

1{
2  "service": "twitter",
3  "handle": "nytimes",
4  "profileUrl": "https://twitter.com/nytimes",
5  "current": {
6    "date": "2024-04-19T12:46:42.453Z",
7    "followersCount": 55222668,
8    "followingCount": 879,
9    "postsCount": 540061
10  },
11  "previous": [
12    {
13      "date": "2024-04-18T12:46:42.453Z",
14      "followersCount": 55222600,
15      "followingCount": 800,
16      "postsCount": 540000
17    },
18    // ...up to 30 days of historical data
19  ]
20}

Get current data for multiple accounts

GET /profiles/SERVICE]?handles=[HANDLE1],[HANDLE2],...

You can provide up to 25 comma-separated handles in the request.

Example request:

GET /profiles/youtube?handles=MrBeast,5MinuteCraftsYouTube
(get current data for two channels by their @-handles)

Example response:

1{
2  "service": "youtube",
3  "counts": {
4    "MrBeast": {
5      "date": "2024-04-19T12:52:38.311Z",
6      "followersCount": 252000000,
7      "postsCount": 786
8    },
9    "5MinuteCraftsYouTube": {
10      "date": "2024-04-19T12:52:46.522Z",
11      "followersCount": 80600000,
12      "postsCount": 6968
13    }
14  }
15}

Notes

• The data is cached & revalidated daily.
• A given social account is being tracked since the first API request that concerns it.
• The historical data is kept for 30 days.
• YouTube provides only rounded estimates of the number of followers.