# ✅ TikTok User Followings Scraper (`datamagnet/tiktok-followings-by-username`) Actor

Collect the followings list for any public TikTok profile using only a username. This actor first resolves the profile, then returns the raw profile data and followings results, with an optional limit so you can control how many records you collect per run.

- **URL**: https://apify.com/datamagnet/tiktok-followings-by-username.md
- **Developed by:** [Datamagnet](https://apify.com/datamagnet) (community)
- **Categories:** Social media, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## TikTok Followings Scraper

TikTok Followings Scraper helps you quickly collect the followings list for any public TikTok profile using only a username. It is built for marketers, researchers, creators, and growth teams who want to understand who a TikTok account follows and what that reveals about its interests, partnerships, and network. The actor returns TikTok profile data and followings results in a clean, ready-to-use format, with an optional limit so you can control how many records you collect in each run. If you need a simple TikTok data collector for audience research, competitor analysis, or lead discovery, this tool gives you a fast and practical way to get started.

### Key Features
- Extract a TikTok profile’s followings list using only a username.
- Collect profile details first, then gather the followings connected to that account.
- Limit each run to the exact number of results you need.
- Return the source data as provided, preserving the original profile and followings fields.
- Support research workflows for marketing, influencer analysis, and competitive intelligence.
- Save time by avoiding manual profile checking and copy-pasting.
- Export results in formats that are easy to review, share, and analyze.

### Use Cases

#### Influencer Research
Brands and agencies use this actor to review the accounts a creator follows and better understand their interests, niche, and likely partnerships. Fields like `nickname`, `unique_id`, `follower_count`, `following_count`, `signature`, and `region` help teams evaluate whether a creator fits a campaign before outreach.

#### Competitor Analysis
Social media managers can compare the followings of competing TikTok profiles to spot patterns in brand relationships, creator circles, and content inspiration. Profile fields such as `aweme_count`, `follower_count`, `following_count`, `verification_type`, and `enterprise_verify_reason` help teams assess account size and credibility while the followings list reveals network connections.

#### Lead Generation
Sales teams and partnership managers can use the followings list to identify accounts that may be relevant prospects, collaborators, or brand partners. The returned profile data, including `nickname`, `ins_id`, `unique_id`, `region`, and `share_info`, makes it easier to qualify accounts and organize outreach lists.

#### Audience and Community Research
Researchers and strategists can study what a TikTok profile follows to infer interests, communities, and content ecosystems around a niche. Data points like `language`, `region`, `signature`, `follower_count`, and `following_count` provide useful context for understanding audience behavior.

#### Brand Safety and Vetting
Teams responsible for partnerships or media buying can review profile metadata before working with an account. Fields such as `status`, `is_block`, `is_ad_fake`, `special_lock`, `verification_type`, and `enterprise_verify_reason` help buyers make more informed decisions about account quality and trust.

### Input

| Field | Type | Required | Description | Example |
|---|---|---:|---|---|
| uniqueId | string | Yes | Enter the TikTok username of the profile you want to look up. | taylorswift |
| max_results | integer | No | Maximum number of followings to collect in this run. | 100 |

### Output

| Field | Type | Description |
|---|---|---|
| accept_private_policy | boolean | Shows whether the account accepts private-policy related settings. |
| account_labels | array or null | Any labels attached to the account, if available. |
| account_region | string | The account’s region setting, if provided. |
| ad_cover_url | string or null | A cover image used for ads, if available. |
| advance_feature_item_order | any or null | Ordering information for advanced profile features, if present. |
| advanced_feature_info | any or null | Extra feature details shown on the profile, if available. |
| apple_account | integer | Indicates whether the account is linked to Apple. |
| authority_status | integer | A status value related to account authority or permissions. |
| avatar_168x168 | object | Profile picture in a smaller display size. |
| avatar_300x300 | object | Profile picture in a medium display size. |
| avatar_larger | object | Profile picture in a larger display size. |
| avatar_medium | object | Profile picture in a medium-large display size. |
| avatar_thumb | object | Profile picture thumbnail. |
| avatar_uri | string | The main image reference for the profile picture. |
| aweme_count | integer | Total number of videos posted by the account. |
| bind_phone | string | Phone number status or linked phone information, if available. |
| bold_fields | any or null | Profile fields highlighted by the source, if any. |
| can_message_follow_status_list | any or null | Messaging permissions related to follow status, if available. |
| can_set_geofencing | any or null | Whether geofencing can be set for the account. |
| cha_list | any or null | Hashtag or challenge-related items connected to the profile, if available. |
| comment_filter_status | integer | Comment filtering status for the account. |
| comment_setting | integer | Comment settings chosen by the account. |
| commerce_user_level | integer | The account’s commerce-related level. |
| cover_url | array | Cover images associated with the profile. |
| create_time | integer | When the account was created, shown as a timestamp. |
| custom_verify | string | Custom verification text, if present. |
| cv_level | string | Creator or commerce level information, if available. |
| download_prompt_ts | integer | Timestamp related to download prompts, if available. |
| download_setting | integer | Whether downloads are allowed for the account’s content. |
| duet_setting | integer | Duet permission setting for the account. |
| enabled_filter_all_comments | boolean | Whether all comments are filtered. |
| enterprise_verify_reason | string | Reason the account is verified as a business or enterprise account. |
| events | any or null | Event-related information connected to the account, if available. |
| fake_data_info | object | Extra source-provided data about the account record. |
| favoriting_count | integer | How many accounts this profile has favorited. |
| fb_expire_time | integer | Expiration time for Facebook-related linking, if available. |
| follow_status | integer | Whether the current viewer follows this account. |
| follower_count | integer | Total number of followers the account has. |
| follower_status | integer | Follower relationship status value. |
| followers_detail | any or null | Detailed follower information, if available. |
| following_count | integer | Total number of accounts this profile follows. |
| friends_status | integer | Mutual-follow relationship status. |
| geofencing | any or null | Location restriction settings, if available. |
| google_account | string | Google account connection information, if present. |
| has_email | boolean | Whether the account has an email linked. |
| has_facebook_token | boolean | Whether Facebook is linked. |
| has_insights | boolean | Whether the account has analytics access. |
| has_orders | boolean | Whether the account has order-related activity. |
| has_twitter_token | boolean | Whether Twitter is linked. |
| has_youtube_token | boolean | Whether YouTube is linked. |
| hide_search | boolean | Whether the account is hidden from search. |
| homepage_bottom_toast | any or null | Homepage message data, if available. |
| ins_id | string | The Instagram handle shown on the profile, if provided. |
| is_ad_fake | boolean | Whether the account is marked as fake advertising. |
| is_block | boolean | Whether the account is blocked. |
| is_discipline_member | boolean | Whether the account is part of a discipline-related program or status. |
| is_mute | integer | Whether the account is muted. |
| is_mute_lives | integer | Whether live content is muted. |
| is_mute_non_story_post | integer | Whether non-story posts are muted. |
| is_mute_story | integer | Whether stories are muted. |
| is_phone_binded | boolean | Whether a phone number is linked. |
| is_star | boolean | Whether the account is marked as a star account. |
| item_list | any or null | Content items attached to the profile, if available. |
| language | string | The account’s main language. |
| live_agreement | integer | Live-stream agreement status. |
| live_commerce | boolean | Whether the account supports live commerce. |
| live_verify | integer | Live verification status. |
| mention_status | integer | Whether the account can be mentioned. |
| mutual_relation_avatars | any or null | Profile images for mutual connections, if available. |
| need_points | any or null | Points-related requirement data, if available. |
| need_recommend | integer | Whether the account needs recommendation support. |
| nickname | string | The display name shown on the profile. |
| original_musician | object | Music-related stats for the account. |
| platform_sync_info | any or null | Cross-platform sync details, if available. |
| prevent_download | boolean | Whether downloads are prevented. |
| react_setting | integer | Reaction settings for the account. |
| region | string | The account’s region code. |
| relative_users | any or null | Related user information, if available. |
| reply_with_video_flag | integer | Whether video replies are enabled. |
| room_id | integer | Live room identifier, if available. |
| search_highlight | any or null | Search highlight data, if available. |
| sec_uid | string | A secure user identifier returned by the source. |
| secret | integer | Whether the account is private or restricted. |
| share_info | object | Share-related metadata for the profile. |
| share_qrcode_uri | string | QR code reference for sharing the profile. |
| shield_comment_notice | integer | Whether comment notices are hidden. |
| shield_digg_notice | integer | Whether like notices are hidden. |
| shield_edit_field_info | any or null | Hidden profile field information, if available. |
| shield_follow_notice | integer | Whether follow notices are hidden. |
| short_id | string | Short numeric ID shown by the source, if available. |
| show_image_bubble | boolean | Whether image bubbles are shown on the profile. |
| signature | string | The bio or profile description. |
| special_account | object | Special account classification details, if available. |
| special_lock | integer | Special account lock status. |
| status | integer | General account status value. |
| stitch_setting | integer | Stitch permission setting for the account. |
| total_favorited | integer | Total number of likes received across the account’s content. |
| tw_expire_time | integer | Expiration time for Twitter-related linking, if available. |
| twitter_id | string | Twitter account ID, if linked. |
| twitter_name | string | Twitter account name, if linked. |
| type_label | any or null | Account type label, if available. |
| uid | string | The main user identifier returned by the source. |
| unique_id | string | The TikTok username for the profile. |
| unique_id_modify_time | integer | Last time the username was changed, shown as a timestamp. |
| user_canceled | boolean | Whether the user canceled the account or profile state. |
| user_mode | integer | User mode value returned by the source. |
| user_period | integer | User period value returned by the source. |
| user_profile_guide | any or null | Profile guidance content, if available. |
| user_rate | integer | User rate value returned by the source. |
| user_spark_info | object | Spark-related account information, if available. |
| user_tags | any or null | Tags attached to the user, if available. |
| verification_type | integer | Verification type for the account. |
| verify_info | string | Verification text shown on the profile. |
| video_icon | object | Video icon image data, if available. |
| white_cover_url | any or null | White cover image reference, if available. |
| with_commerce_entry | boolean | Whether the account has commerce features enabled. |
| with_shop_entry | boolean | Whether the account has shop features enabled. |
| youtube_channel_id | string | YouTube channel ID, if linked. |
| youtube_channel_title | string | YouTube channel title, if linked. |
| youtube_expire_time | integer | Expiration time for YouTube-related linking, if available. |

### Sample Output

```json
{
  "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/99d43f49d3f1749ffa85f5954ca10a8c",
    "url_list": [
      "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/99d43f49d3f1749ffa85f5954ca10a8c~tplv-tiktokx-cropcenter:168:168.webp?dr=14577&refresh_token=491811c8&x-expires=1784620800&x-signature=32SxjZxjihA/xr7w7J6y/yqqcHY=..."
    ],
    "url_prefix": null,
    "width": 720
  },
  "avatar_300x300": {
    "height": 720,
    "uri": "tos-maliva-avt-0068/99d43f49d3f1749ffa85f5954ca10a8c",
    "url_list": [
      "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/99d43f49d3f1749ffa85f5954ca10a8c~tplv-tiktokx-cropcenter:300:300.webp?dr=14577&refresh_token=2bf37d1e&x-expires=1784620800&x-signature=pjJvKpjrS2kLv++GZE2GzkjYxzk=..."
    ],
    "url_prefix": null,
    "width": 720
  },
  "avatar_larger": {
    "height": 720,
    "uri": "tos-maliva-avt-0068/99d43f49d3f1749ffa85f5954ca10a8c",
    "url_list": [
      "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/99d43f49d3f1749ffa85f5954ca10a8c~tplv-tiktokx-cropcenter:1080:1080.webp?dr=14579&refresh_token=75974108&x-expires=1784620800&x-signature=TeFmWYZGBjQCXcRf6JVy9gQPp4I=..."
    ],
    "url_prefix": null,
    "width": 720
  },
  "avatar_medium": {
    "height": 720,
    "uri": "tos-maliva-avt-0068/99d43f49d3f1749ffa85f5954ca10a8c",
    "url_list": [
      "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/99d43f49d3f1749ffa85f5954ca10a8c~tplv-tiktokx-cropcenter:720:720.webp?dr=14579&refresh_token=2c6b1daf&x-expires=1784620800&x-signature=JdkjIxRPEQnuIDFNdZvTe9USzWs=..."
    ],
    "url_prefix": null,
    "width": 720
  },
  "avatar_thumb": {
    "height": 720,
    "uri": "tos-maliva-avt-0068/99d43f49d3f1749ffa85f5954ca10a8c",
    "url_list": [
      "https://p16-common-sign.tiktokcdn.com/tos-maliva-avt-0068/99d43f49d3f1749ffa85f5954ca10a8c~tplv-tiktokx-cropcenter:100:100.webp?dr=14579&refresh_token=2c9f67c5&x-expires=1784620800&x-signature=0LItmmdjWxSY/fqriE05LNGI4DQ=..."
    ],
    "url_prefix": null,
    "width": 720
  },
  "avatar_uri": "tos-maliva-avt-0068/99d43f49d3f1749ffa85f5954ca10a8c",
  "aweme_count": 16089,
  "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": 2,
  "cover_url": [],
  "create_time": 1630264966,
  "custom_verify": "",
  "cv_level": "",
  "download_prompt_ts": 0,
  "download_setting": 0,
  "duet_setting": 3,
  "enabled_filter_all_comments": false,
  "enterprise_verify_reason": "verified account",
  "events": null,
  "fake_data_info": {},
  "favoriting_count": 92,
  "fb_expire_time": 0,
  "follow_status": 0,
  "follower_count": 15449125,
  "follower_status": 0,
  "followers_detail": null,
  "following_count": 48,
  "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": false,
  "homepage_bottom_toast": null,
  "ins_id": "cnn",
  "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": "CNN",
  "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": "GB",
  "relative_users": null,
  "reply_with_video_flag": 4,
  "room_id": 0,
  "search_highlight": null,
  "sec_uid": "MS4wLjABAAAAOVL3gR6qKaY1C7FWW5x3dNZ-IXOYUrMA9PQ4k2kOZU9FNqvxo-xV4p_dUsQxtDUW",
  "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_weibo_desc": ""
  },
  "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": "This is CNN...",
  "special_account": {
    "special_account_list": null
  },
  "special_lock": 1,
  "status": 1,
  "stitch_setting": 3,
  "total_favorited": 898861475,
  "tw_expire_time": 0,
  "twitter_id": "",
  "twitter_name": "",
  "type_label": null,
  "uid": "6971822573634978822",
  "unique_id": "cnn",
  "unique_id_modify_time": 1784534575,
  "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
}
````

### How It Works

1. You enter a TikTok username you want to research.
2. The actor looks up the profile and gathers the account details needed to continue.
3. It then collects the followings list for that profile.
4. If you set a limit, it stops once it reaches that number of results.
5. The finished dataset is returned in a format you can review, download, or reuse.

### Getting Started

Getting started is simple and does not require coding knowledge. Click **Try for free**, enter the TikTok username you want to check, choose how many followings you want to collect, and click **Run**. In a short time, your results will be ready to review and download. You can export the output as JSON, CSV, or Excel, making it easy to share with your team or analyze in your favorite spreadsheet tool.

### Frequently Asked Questions

#### Do I need technical skills?

No. This actor is designed for business users who want results without dealing with complicated setup. Just enter a username, choose an optional result limit, and run it.

#### How fast does it run?

Speed depends on the profile size and how many followings you request. Smaller runs finish quickly, while larger collections may take longer because the actor gathers results in batches until it reaches your limit or runs out of data.

#### What format is the output?

The output is available in JSON, CSV, or Excel. That means you can inspect the raw record details, open the data in a spreadsheet, or move it into your reporting workflow.

#### Is this legal to use?

The actor is intended for lawful research and business use on publicly available profile data. You are responsible for using the results in a way that follows applicable laws, platform rules, and your organization’s policies.

#### Can I schedule it to run automatically?

Yes, you can set it up to run on a schedule if you want regular updates. This is useful for tracking changes over time, monitoring competitor networks, or refreshing research lists without manual work.

# Actor input Schema

## `uniqueId` (type: `string`):

Enter the TikTok username of the profile you want to look up.

## `max_results` (type: `integer`):

Maximum number of followings to collect in this run.

## Actor input object example

```json
{
  "uniqueId": "selenagomez",
  "max_results": 100
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "uniqueId": "selenagomez"
};

// Run the Actor and wait for it to finish
const run = await client.actor("datamagnet/tiktok-followings-by-username").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = { "uniqueId": "selenagomez" }

# Run the Actor and wait for it to finish
run = client.actor("datamagnet/tiktok-followings-by-username").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "uniqueId": "selenagomez"
}' |
apify call datamagnet/tiktok-followings-by-username --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=datamagnet/tiktok-followings-by-username",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "✅ TikTok User Followings Scraper",
        "description": "Collect the followings list for any public TikTok profile using only a username. This actor first resolves the profile, then returns the raw profile data and followings results, with an optional limit so you can control how many records you collect per run.",
        "version": "0.0",
        "x-build-id": "gutaahBlXpI6sPid0"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/datamagnet~tiktok-followings-by-username/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-datamagnet-tiktok-followings-by-username",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/datamagnet~tiktok-followings-by-username/runs": {
            "post": {
                "operationId": "runs-sync-datamagnet-tiktok-followings-by-username",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/datamagnet~tiktok-followings-by-username/run-sync": {
            "post": {
                "operationId": "run-sync-datamagnet-tiktok-followings-by-username",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "uniqueId"
                ],
                "properties": {
                    "uniqueId": {
                        "title": "Username",
                        "type": "string",
                        "description": "Enter the TikTok username of the profile you want to look up."
                    },
                    "max_results": {
                        "title": "Max results",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of followings to collect in this run.",
                        "default": 10
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
