> ## Documentation Index > Fetch the complete documentation index at: https://docs.sociavault.com/llms.txt > Use this file to discover all available pages before exploring further. # Following > Scrapes accounts that a TikTok user follows 💳 **1 credit** per request ## OpenAPI ````yaml GET /v1/scrape/tiktok/following openapi: 3.1.0 info: title: SociaVault API version: 1.0.0 description: >- # SociaVault API Documentation The SociaVault API provides comprehensive access to social media data extraction across multiple platforms. ## Features - **Multi-Platform Support**: TikTok, Instagram, YouTube, Facebook, Twitter, Reddit, Threads, and more - **Credit-Based System**: Pay-as-you-go pricing with transparent credit costs - **High Performance**: Fast, reliable data extraction - **Comprehensive Data**: Detailed user profiles, videos, posts, comments, and analytics ## Authentication All API requests require authentication using an API key in the `X-API-Key` header: ```bash X-API-Key: sk_live_your_api_key_here ``` Get your API key from the [SociaVault Dashboard](https://sociavault.com/dashboard). ## Credits Each endpoint consumes credits based on data complexity: - Simple requests (profiles): 1 credit - Complex requests (demographics): 20+ credits - Paginated requests: Credits per page Check your credit balance in the dashboard or via the API. ## Support - **Documentation**: https://docs.sociavault.com - **Email**: support@sociavault.com - **Discord**: https://discord.gg/sociavault contact: name: SociaVault Support email: support@sociavault.com url: https://sociavault.com/support license: name: Commercial url: https://sociavault.com/terms servers: - url: https://api.sociavault.com description: Production API security: - ApiKeyAuth: [] tags: - name: account description: Account management and credit balance externalDocs: description: Learn more url: https://docs.sociavault.com/account - name: tiktok description: Scrape TikTok profiles, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok - name: tiktok-shop description: Everything about TikTok Shop externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/tiktok-shop - name: instagram description: Gets Instagram profiles, posts, and reels externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/instagram - name: youtube description: Scrape YouTube channels, videos, and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/youtube - name: linkedin description: Scrape LinkedIn externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedin - name: facebook description: Get public Facebook profiles and posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebook - name: facebookAdLibrary description: Scrapes the Facebook (Meta) Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookAdLibrary - name: facebookMarketplace description: Search Facebook Marketplace and pull full listing details externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/facebookMarketplace - name: googleAdLibrary description: >- Scrape the Google Ad Transparency Library. *This only gets the public ads. Some ads you need to log in for and sadly we can't get those. Also, since there are so many variations, the return types might not all be 100% the same. externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/googleAdLibrary - name: linkedinAdLibrary description: Search the LinkedIn Ad Library externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/linkedinAdLibrary - name: twitter description: Get Twitter profiles, tweets, followers and more externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/twitter - name: reddit description: Scrape Reddit posts and comments externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/reddit - name: threads description: Get Threads posts externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/threads - name: google description: Scrape Google search results externalDocs: description: Learn more url: https://docs.sociavault.com/platforms/google paths: /v1/scrape/tiktok/following: get: tags: - tiktok summary: Following description: Scrapes accounts that a TikTok user follows operationId: tiktok_Following parameters: - name: handle in: query description: TikTok handle required: true schema: type: string example: stoolpresidente - name: min_time in: query description: Used to paginate. Get 'min_time' from previous response. required: false schema: type: integer example: 1605663376 - name: trim in: query description: Set to true to get a trimmed response required: false schema: type: boolean responses: '200': description: >- Successful response **Key Response Fields:** - `data.followings[].unique_id`: User's TikTok username - `data.followings[].nickname`: User's display name - `data.followings[].uid`: User's numeric ID - `data.followings[].sec_uid`: User's secure user ID (use for profile lookups) - `data.followings[].signature`: User's bio - `data.followings[].follower_count`: User's follower count - `data.followings[].following_count`: User's following count - `data.followings[].total_favorited`: Total likes received across all videos - `data.followings[].aweme_count`: Number of videos posted - `data.followings[].favoriting_count`: Number of videos the user has liked - `data.followings[].avatar_larger.url_list[0]`: Profile picture (high-res) - `data.followings[].avatar_medium.url_list[0]`: Profile picture (medium) - `data.followings[].region`: 2-letter country code - `data.followings[].verification_type`: Verification status (`1` = verified) - `data.followings[].create_time`: Account creation Unix timestamp - `data.total`: Total number of accounts followed - `data.has_more`: Whether more results are available - `data.min_time`: Pagination cursor — pass as `min_time` parameter to get the next page content: application/json: examples: full: summary: Full Response value: success: true data: success: true extra: fatal_item_ids: {} logid: 2026020818240892EB5C0C655460834DAD now: 1770575049000 followings: '0': accept_private_policy: false account_labels: null account_region: '' ad_cover_url: null advance_feature_item_order: null advanced_feature_info: null apple_account: 0 authority_status: 0 avatar_168x168: height: 720 uri: >- tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c url_list: '0': >- https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&refresh_token=6af99020&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=tFh1hjjgR3shaUpMvxkZvodeauM%3D '1': >- https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:168:168:q70.heic?dr=9604&idc=no1a&ps=87d6e48a&refresh_token=ec068d1b&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=Xw%2ByWZqY5HjMq2DnZb1V6brydFc%3D '2': >- https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:168:168:q70.webp?dr=9604&idc=no1a&ps=87d6e48a&refresh_token=ffbbecf3&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=zKq4if%2FdFOfqkfeIvtbjW5mWOME%3D url_prefix: null width: 720 avatar_300x300: height: 720 uri: >- tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c url_list: '0': >- https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&refresh_token=432f5620&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=2%2FgZ9nOVFFzzGy6tLJHJUm0J86U%3D '1': >- https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:300:300:q70.heic?dr=9605&idc=no1a&ps=87d6e48a&refresh_token=a2f3c869&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=hi5muNd5bcHKAR5GadNufZl5GyQ%3D '2': >- https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:300:300:q70.webp?dr=9605&idc=no1a&ps=87d6e48a&refresh_token=d5434ba3&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=arFR3G3u7F6H%2FjEdLLKg38Ni%2BK8%3D url_prefix: null width: 720 avatar_larger: height: 720 uri: >- tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c url_list: '0': >- https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=1ad6a8c0&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=CiTPOLq3i2wUVNZRr64JwsTOvcs%3D '1': >- https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:1080:1080:q70.heic?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=abd3c08a&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=f0KU0%2Fk7W5WXLsn%2FmQdUk9jKHPU%3D '2': >- https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:1080:1080:q70.webp?dr=9608&idc=no1a&ps=87d6e48a&refresh_token=24c14081&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=sKeNU9d%2ByshRpcxUejfa40hi20w%3D url_prefix: null width: 720 avatar_medium: height: 720 uri: >- tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c url_list: '0': >- https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=63b82e84&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=WwxYB2bMzVAJjXMeD%2FdxCdALbxg%3D '1': >- https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=6181ddd9&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=I%2FEH5NEJt5XpL6tI5X%2FORJyBw9E%3D '2': >- https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:720:720:q70.webp?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=c879569e&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=vS9WNsFWhk1ORNYPEgqJTF0gLH0%3D url_prefix: null width: 720 avatar_thumb: height: 720 uri: >- tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c url_list: '0': >- https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&refresh_token=a3527369&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=0Sa0%2BGWctktp9QtNlhzydsFXjQ0%3D '1': >- https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=9606&idc=no1a&ps=87d6e48a&refresh_token=8ae81a54&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=rqa4m2Pj6P2we3pKkGSy1IyqROA%3D '2': >- https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:100:100:q70.webp?dr=9606&idc=no1a&ps=87d6e48a&refresh_token=8690cc3b&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=VEIb0QGl7YVBR1vzvyTtJh2hey8%3D url_prefix: null width: 720 avatar_uri: tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c aweme_count: 192 bind_phone: '' bold_fields: null can_message_follow_status_list: null can_set_geofencing: null cha_list: null comment_filter_status: 0 comment_setting: 0 commerce_user_level: 0 cover_url: {} create_time: 1546820065 custom_verify: '' cv_level: '' download_prompt_ts: 0 download_setting: 0 duet_setting: 0 enabled_filter_all_comments: false enterprise_verify_reason: '' events: null fake_data_info: {} favoriting_count: 76423 fb_expire_time: 0 follow_status: 0 follower_count: 132309 follower_status: 0 followers_detail: null following_count: 969 friends_status: 0 geofencing: null google_account: '' has_email: false has_facebook_token: false has_insights: false has_orders: false has_twitter_token: false has_youtube_token: false hide_search: true homepage_bottom_toast: null ins_id: '' is_ad_fake: false is_block: false is_discipline_member: false is_mute: 0 is_mute_lives: 0 is_mute_non_story_post: 0 is_mute_story: 0 is_phone_binded: false is_star: false item_list: null language: en live_agreement: 0 live_commerce: false live_verify: 0 mention_status: 1 mutual_relation_avatars: null need_points: null need_recommend: 0 nickname: lizlanden original_musician: digg_count: 0 music_count: 0 music_used_count: 0 new_release_clip_ids: null platform_sync_info: null prevent_download: false react_setting: 0 region: US relative_users: null reply_with_video_flag: 4 room_id: 0 search_highlight: null sec_uid: >- MS4wLjABAAAAU-sIzbOwfvGSQ1bezj3DfFFszSz4mqutWSpNG6cptGdDWWWmWHzEg8HQTU-kQxzW secret: 0 share_info: now_invitation_card_image_urls: null share_desc: '' share_desc_info: '' share_qrcode_url: height: 720 uri: '' url_list: {} url_prefix: null width: 720 share_title: '' share_title_myself: '' share_title_other: '' share_url: '' share_qrcode_uri: '' shield_comment_notice: 0 shield_digg_notice: 0 shield_edit_field_info: null shield_follow_notice: 0 short_id: '0' show_image_bubble: false signature: |- Tim Tebow lizlanden.co@gmail.com special_account: special_account_list: null special_lock: 1 status: 1 stitch_setting: 0 total_favorited: 2675327 tw_expire_time: 0 twitter_id: '' twitter_name: '' type_label: null uid: '6620791754290315269' unique_id: glizzzerd unique_id_modify_time: 1770575049 user_canceled: false user_mode: 1 user_period: 0 user_profile_guide: null user_rate: 1 user_spark_info: {} user_tags: null verification_type: 1 verify_info: '' video_icon: height: 720 uri: '' url_list: {} url_prefix: null width: 720 white_cover_url: null with_commerce_entry: false with_shop_entry: false youtube_channel_id: '' youtube_channel_title: '' youtube_expire_time: 0 has_more: true log_pb: impr_id: 2026020818240892EB5C0C655460834DAD max_time: 1770575049 min_time: 1734470383 myself_user_id: '0' next_page_token: >- eyJtYXhfY3Vyc29yIjoxNzY5MTE0MjUzLCJtaW5fY3Vyc29yIjoxNzM0NDcwMzgzfQ== offset: 0 rec_has_more: true status_code: 0 status_msg: '' total: 90 credits_used: 1 endpoint: tiktok/following trimmed: summary: Trimmed Response value: success: true data: success: true followings: '0': create_time: 1546820065 follower_count: 132312 following_count: 969 language: en nickname: lizlanden region: US sec_uid: >- MS4wLjABAAAAU-sIzbOwfvGSQ1bezj3DfFFszSz4mqutWSpNG6cptGdDWWWmWHzEg8HQTU-kQxzW signature: |- Tim Tebow lizlanden.co@gmail.com uid: '6620791754290315269' unique_id: glizzzerd avatar_medium: height: 720 uri: >- tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c url_list: '0': >- https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=63b82e84&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=WwxYB2bMzVAJjXMeD%2FdxCdALbxg%3D '1': >- https://p19-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=6181ddd9&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=I%2FEH5NEJt5XpL6tI5X%2FORJyBw9E%3D '2': >- https://p16-common-sign.tiktokcdn-eu.com/tos-maliva-avt-0068/ba32b40a8c022fbb727c156f8a5a140c~tplv-tiktokx-cropcenter-q:720:720:q70.webp?dr=9607&idc=no1a&ps=87d6e48a&refresh_token=c879569e&s=COMMON_RELATION_LIST&sc=avatar&shcp=65db1d19&shp=30310797&t=223449c4&x-expires=1770660000&x-signature=vS9WNsFWhk1ORNYPEgqJTF0gLH0%3D url_prefix: null width: 720 min_time: 1734470383 total: 90 credits_used: 1 endpoint: tiktok/following '400': description: Bad Request - Invalid parameters or missing required fields content: application/json: schema: type: object properties: error: type: string example: 'Missing required parameter: handle' endpoint: type: string credits_required: type: integer required: - error '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: type: object properties: error: type: string example: Invalid API key docs: type: string example: https://docs.sociavault.com/authentication required: - error '402': description: Payment Required - Insufficient credits content: application/json: schema: type: object properties: error: type: string example: Insufficient credits required: type: integer example: 1 description: Credits required for this request available: type: integer example: 0 description: Credits currently available required: - error - required - available '500': description: Internal Server Error - Service configuration or processing error content: application/json: schema: type: object properties: error: type: string example: Service configuration error required: - error components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-API-Key description: |- API key for authentication. Format: `sk_live_xxxxxxxxxxxxx` Get your API key from the [Dashboard](https://sociavault.com/dashboard). ````