API で取得する TikTok のフォロワー数とプロフィール情報
TikTok のビジネス向け API では、GET /business/get/ からアカウントのフォロワー数を followers_count として取得できます。同じリクエストで username、display_name、profile_image、bio_description、is_verified、following_count、total_likes、videos_count も取得でき、いずれも user.info.stats などのスコープが必要です。Display API の /v2/user/info/ は、アプリを認可したユーザーについて同じ数を follower_count として返します。
easyCoexistence は、Claude、ChatGPT、または独自のコードから get_social_insights を使って TikTok アカウントのプロフィールとフォロワー数を読み取ります。
/business/get/ の先頭にある followers_count、following_count、total_likes、videos_count に必要なスコープ。
TikTok がフォロワー数とプロフィール項目を更新する仕組みと、日次指標が通常 24 時間から 48 時間遅れて届くこと。
/v2/user/info/ における Display API での名称と、その独自の user.info.stats スコープ。
/business/get/ で日次の followers_count などの指標を遡れる最長期間。
フィールドを指定しないリクエストが /business/get/ から返す項目:display_name と profile_image。
/business/get/ はどのプロフィール項目を返しますか?
fields に指定した項目が返されます。fields は、クエリ文字列の JSON 配列です。各項目は、アプリを認可する際にアカウント所有者が許可したスコープによって利用可能になります。フィールドを指定しないリクエストでは display_name と profile_image だけが返されます。TikTok は以下のプロフィール項目とカウント項目をリアルタイムで更新します:
フォロワー数はどのように取得しますか?
アカウントのトークンを Access-Token ヘッダーに入れ、business_id(トークン交換で得た open_id)と必要なフィールドを指定して GET /business/get/ を送信します。現在の数は data の先頭にあり、日ごとの数値は metrics に入ります:
curl -G 'https://business-api.tiktok.com/open_api/v1.3/business/get/' \
-H 'Access-Token: <ACCESS_TOKEN>' \
--data-urlencode 'business_id=<OPEN_ID>' \
--data-urlencode 'fields=["display_name","followers_count","following_count","is_verified","daily_new_followers","daily_lost_followers"]'
{
"code": 0,
"message": "OK",
"request_id": "<REQUEST_ID>",
"data": {
"display_name": "<DISPLAY_NAME>",
"followers_count": 13,
"following_count": 2,
"is_verified": false,
"metrics": [
{ "date": "<DATE>", "followers_count": 13, "daily_new_followers": 0, "daily_lost_followers": 0 }
]
}
}フォロワーの推移を日ごとに追うには?
fields に followers_count を指定すると、TikTok は 2 通りの値を返します。data の先頭にある累計値(user.info.stats のもの)と、metrics の各日の値(user.insights のもの)です。start_date と end_date(UTC)で日付を指定でき、最大 60 日前まで遡れます。指定しない場合は、リクエスト日の前日までの 7 日分が返されます。累計値の動きを示す日次フィールドは 3 つあり、Advanced Access または認証済みビジネスアカウントで利用できます:
daily_new_followers:その日に増えたフォロワー数。daily_lost_followers:その日に減ったフォロワー数。daily_total_followers:その日の純増数(増加から減少を引いた値)。
Display API は何を返しますか?
TikTok for Developers のアプリを認可したユーザーについて、同様のプロフィールを返します。取得先は https://open.tiktokapis.com/v2/user/info/ への GET で、fields パラメーターに項目を列挙します。名称とスコープはビジネス向け API と異なり、そのユーザーオブジェクトには日次の履歴がありません:
| API for Business: /business/get/ | Display API: /v2/user/info/ | |
|---|---|---|
| Followers | followers_count | follower_count |
| Following | following_count | following_count |
| Likes | total_likes | likes_count |
| Videos | videos_count | video_count |
| Count scope | user.info.stats | user.info.stats |
| Username scope | user.info.username | user.info.profile |
| Photo | profile_image | avatar_url, avatar_url_100, avatar_large_url |
| Daily history | Up to 60 days in metrics | Not in the user object |
他のアカウントのフォロワー数を読み取れますか?
これら 2 つのエンドポイントでは読み取れません。/business/get/ が応答するのは、アプリを認可したアカウントの business_id に対してのみです。/v2/user/info/ は、呼び出しに使われたトークンのユーザーに対して応答します。TikTok の Research API には /v2/research/user/info/ があり、ユーザー名を指定して follower_count、following_count、likes_count、video_count を返しますが、TikTok が承認した研究者に限られます。
easyCoexistence はプロフィールをどのように読み取りますか?
object_id を指定せず、アカウントに対して get_social_insights を使います。metrics の名称が /business/get/ のフィールドになり、params の start_date と end_date で日付を指定します。返される値は TikTok のデータをそのままです。metrics を空にすると、ユーザー名、表示名、写真、フォロワー数、フォロー数、いいね数、動画数、アカウント単位のフラグ 2 つ、そして日次の動画再生数、プロフィール閲覧数、新規フォロワー数を取得します。list_social_accounts は、アカウントを接続したときに保存されたユーザー名と表示名も表示します。
get_social_insights {
"account_id": "<ACCOUNT_ID>",
"metrics": ["followers_count", "following_count", "total_likes", "videos_count"],
"params": { "start_date": "2026-10-02", "end_date": "2026-10-31" }
}よくある間違い
- user.info.stats がないトークンで followers_count を要求すること。TikTok は、所有者がそのスコープを許可したフィールドだけを返すため、所有者がアプリを再認可する必要があります。
- profile_image を保存しておくこと。これは一時的な URL で、有効期限は x-expires パラメーターにあるため、必要になったときに新しく取得してください。
- /business/get/ から follower_count を読み取ること。これは Display API での名称で、ビジネス向け API では followers_count と呼ばれます。
- 個人アカウントで新規・減少フォロワーを期待すること。TikTok がこれらの日次フィールドを返すのは、Advanced Access または認証済みビジネスアカウントの場合だけです。
followers_count、total_likes、videos_count などの項目を指定し、日次の行には日付を指定すると、TikTok の数値をそのまま返します。料金は接続 1 件あたり月額 US$ 9 から、接続を増やすほど下がり US$ 0.75 まで。最初の 3 日間は無料トライアルです。
よくある質問
TikTok API でフォロワー数の推移を最大 60 日分まで追えますか?
はい。metrics で日ごとの followers_count を取得できます。Advanced Access または認証済みビジネスアカウントであれば、日次の新規、減少、純増のフォロワー数も取得できます。
TikTok のフォロワー数にはどのスコープが必要ですか?
user.info.stats です。どちらの API でも必要で、/business/get/ の followers_count と、Display API の /v2/user/info/ の follower_count を利用できるようにします。
個人の TikTok アカウントでもフォロワー数を取得できますか?
はい。followers_count はアカウントの種類ではなく、スコープによって決まります。Advanced Access または認証済みビジネスアカウントが必要なのは、一部の日次フィールドだけです。
TikTok のフォロワー数はどのくらいの頻度で更新されますか?
トップレベルの followers_count はリアルタイムで更新されます。metrics の日次の行は通常、UTC で 24 時間から 48 時間遅れて届きます。
続きを読む
最初のチャンネルを 2 分で接続しましょう。
プラットフォームの審査を待つ必要はありません。WhatsApp、Instagram、TikTok などのチャンネルを接続して、AI に投稿、返信、レポートを任せてみてください。
- 3 日間無料
- いつでも解約可能
- 公式 API のみ使用
- 24/7 監視
確認日