/v1/tiktok/user/followers
Followers
Scrapes followers of a TikTok account
| Credit cost | Default: 1 credit How charges are determinedCost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute. |
|---|---|
| Cache support | Not specified in the published contract. |
| Pagination | No explicit pagination metadata in the published contract. Consult the parameters and response fields below. |
Parameters
| Name | Location / required | Schema |
|---|---|---|
handleTikTok handle | query / optional |
|
user_idUser id. Use this for faster response times. | query / optional |
|
trimSet to true to get a trimmed response | query / optional |
|
min_timeUsed to paginate. Get 'min_time' from previous response. | query / optional |
|
Request examples
Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.
cURL
curl --request GET 'https://api.fetchproof.com/v1/tiktok/user/followers' \
--header 'x-api-key: YOUR_API_KEY'JavaScript
const response = await fetch("https://api.fetchproof.com/v1/tiktok/user/followers", {
method: 'GET',
headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());Python
import os
import requests
response = requests.get("https://api.fetchproof.com/v1/tiktok/user/followers",
headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)Responses
200Success. Envelope: success / credits_remaining / credits_charged.
application/json
object
successrequired
boolean
credits_remainingrequired
integer
credits_chargedrequired
integer
extraoptional
object
fatal_item_idsrequired
array
logidrequired
string
nowrequired
integer
followersrequired
array
Array items
object
accept_private_policyoptional
boolean
account_labelsoptional
null
account_regionoptional
string
ad_cover_urloptional
null
advance_feature_item_orderoptional
null
advanced_feature_infooptional
null
apple_accountoptional
integer
authority_statusoptional
integer
avatar_168x168optional
object
heightrequired
integer
urirequired
string
url_listrequired
array
Array items
string
url_prefixrequired
null
widthrequired
integer
data_sizeoptional
integer
avatar_300x300optional
object
heightrequired
integer
urirequired
string
url_listrequired
array
Array items
string
url_prefixrequired
null
widthrequired
integer
data_sizeoptional
integer
avatar_largeroptional
object
heightrequired
integer
urirequired
string
url_listrequired
array
Array items
string
url_prefixrequired
null
widthrequired
integer
data_sizeoptional
integer
avatar_mediumrequired
object
heightrequired
integer
urirequired
string
url_listrequired
array
Array items
string
url_prefixrequired
null
widthrequired
integer
data_sizeoptional
integer
avatar_thumboptional
object
heightrequired
integer
urirequired
string
url_listrequired
array
Array items
string
url_prefixrequired
null
widthrequired
integer
data_sizeoptional
integer
avatar_urioptional
string
aweme_countoptional
integer
bind_phoneoptional
string
bold_fieldsoptional
null
can_message_follow_status_listoptional
array
Array items
integer
can_set_geofencingoptional
null
cha_listoptional
null
comment_filter_statusoptional
integer
comment_settingoptional
integer
commerce_user_leveloptional
integer
cover_urloptional
array
create_timerequired
integer
custom_verifyoptional
string
cv_leveloptional
string
download_prompt_tsoptional
integer
download_settingoptional
integer
duet_settingoptional
integer
enabled_filter_all_commentsoptional
boolean
enterprise_verify_reasonoptional
string
eventsoptional
null
fake_data_infooptional
object
favoriting_countoptional
integer
fb_expire_timeoptional
integer
follow_statusoptional
integer
follower_countrequired
integer
follower_statusoptional
integer
followers_detailoptional
null
following_countrequired
integer
friends_statusoptional
integer
geofencingoptional
null
google_accountoptional
string
has_emailoptional
boolean
has_facebook_tokenoptional
boolean
has_insightsoptional
boolean
has_ordersoptional
boolean
has_twitter_tokenoptional
boolean
has_youtube_tokenoptional
boolean
hide_searchoptional
boolean
homepage_bottom_toastoptional
null
ins_idoptional
string
is_ad_fakeoptional
boolean
is_blockoptional
boolean
is_discipline_memberoptional
boolean
is_muteoptional
integer
is_mute_livesoptional
integer
is_mute_non_story_postoptional
integer
is_mute_storyoptional
integer
is_phone_bindedoptional
boolean
is_staroptional
boolean
item_listoptional
null
languagerequired
string
live_agreementoptional
integer
live_commerceoptional
boolean
live_verifyoptional
integer
mention_statusoptional
integer
mutual_relation_avatarsoptional
null
need_pointsoptional
null
need_recommendoptional
integer
nicknamerequired
string
original_musicianoptional
object
digg_countrequired
integer
music_countrequired
integer
music_used_countrequired
integer
new_release_clip_idsrequired
null
platform_sync_infooptional
null
prevent_downloadoptional
boolean
react_settingoptional
integer
regionrequired
string
relative_usersoptional
null
reply_with_video_flagoptional
integer
room_idoptional
integer
search_highlightoptional
null
sec_uidrequired
string
secretoptional
integer
share_infooptional
object
now_invitation_card_image_urlsrequired
null
share_descrequired
string
share_desc_inforequired
string
share_qrcode_urlrequired
object
heightrequired
integer
urirequired
string
url_listrequired
array
url_prefixrequired
null
widthrequired
integer
share_titlerequired
string
share_title_myselfrequired
string
share_title_otherrequired
string
share_urlrequired
string
share_qrcode_urioptional
string
shield_comment_noticeoptional
integer
shield_digg_noticeoptional
integer
shield_edit_field_infooptional
null
shield_follow_noticeoptional
integer
short_idoptional
string
show_image_bubbleoptional
boolean
signaturerequired
string
special_accountoptional
object
special_account_listrequired
null
special_lockoptional
integer
statusoptional
integer
stitch_settingoptional
integer
story_statusoptional
integer
total_favoritedoptional
integer
tw_expire_timeoptional
integer
twitter_idoptional
string
twitter_nameoptional
string
type_labeloptional
null
uidrequired
string
unique_idrequired
string
unique_id_modify_timeoptional
integer
user_canceledoptional
boolean
user_modeoptional
integer
user_now_pack_infooptional
object
user_periodoptional
integer
user_profile_guideoptional
null
user_rateoptional
integer
user_spark_infooptional
object
user_tagsoptional
null
verification_typeoptional
integer
verify_infooptional
string
video_iconoptional
object
heightrequired
integer
urirequired
string
url_listrequired
array
url_prefixrequired
null
widthrequired
integer
white_cover_urloptional
null
with_commerce_entryoptional
boolean
with_shop_entryoptional
boolean
youtube_channel_idoptional
string
youtube_channel_titleoptional
string
youtube_expire_timeoptional
integer
is_mute_thoughtoptional
integer
has_moreoptional
boolean
log_pboptional
object
impr_idrequired
string
max_timeoptional
integer
min_timerequired
integer
myself_user_idoptional
string
next_page_tokenoptional
string
offsetoptional
integer
status_codeoptional
integer
status_msgoptional
string
totalrequired
integer