TikTok Follow Graph & Audience Export Scraper: MCP config, n8n workflow and API

{
  "profiles": [
    "natgeo"
  ],
  "listType": "following",
  "maxUsersPerProfile": 3,
  "includeStats": true,
  "includeBioEmail": false,
  "onlyVerified": false,
  "sellerOnly": false,
  "excludePrivate": false,
  "minFollowers": 0,
  "maxFollowers": 0,
  "onlyWithEmail": false,
  "scanLimit": 0
}

---
name: tiktok-follow-graph-and-audience-export-scraper
description: "One record per TikTok follower or following account, with profile identity, exact audience stats, source context, and optional bio email. Runs the Apify Actor nimbryxo-studio/tiktok-follow-graph-and-audience-export-scraper. Use when the user needs TikTok data with fields such as sourceUsername, listType, position, userId, username, displayName and an Apify token is available."
compatibility: "Needs network access, curl, and an APIFY_TOKEN environment variable. Runs are billed to the token owner's Apify account."
metadata:
  actor: "nimbryxo-studio/tiktok-follow-graph-and-audience-export-scraper"
  store-url: "https://apify.com/nimbryxo-studio/tiktok-follow-graph-and-audience-export-scraper"
---

# TikTok Follow Graph & Audience Export Scraper

Use this skill to fetch TikTok data with the Apify Actor `nimbryxo-studio/tiktok-follow-graph-and-audience-export-scraper` and work with the returned rows.

## Before running

1. Check that `APIFY_TOKEN` is set in the environment. Never print it or write it to a file.
2. Build `input.json` from the user's request using the fields below. Keep limits small for a first run.
3. Confirm the search terms or URLs with the user if the request is ambiguous.

## Input fields

| Field | Type | Meaning |
| --- | --- | --- |
| `profiles` | array | TikTok usernames, @handles, or profile URLs. Paste one per line. Examples: natgeo, @sephora, https://www.tiktok.com/@tiktok. |
| `listType` | one of `followers`, `following`, `both` | Choose the side of the follow graph: people who follow the profile, accounts the profile follows, or both lists. |
| `maxUsersPerProfile` | integer | Maximum rows to return for each requested list. Each list gets this cap. The source may return fewer when accounts are private or deleted. |
| `includeStats` | boolean | Add follower, following, likes received, video, likes given, and friend counts for each listed account. |
| `includeBioEmail` | boolean | Add a public email address from the bio when one is present. The field is omitted when the bio has no valid email. |
| `onlyVerified` | boolean | Only include accounts with a TikTok verified badge. |
| `sellerOnly` | boolean | Only include accounts marked as TikTok Shop sellers. |
| `excludePrivate` | boolean | Skip accounts whose profile is private. |
| `minFollowers` | integer | Only include accounts with at least this many followers. 0 = no minimum. |
| `maxFollowers` | integer | Only include accounts with at most this many followers. 0 = no maximum. |
| `bioKeywords` | array | Only include accounts whose bio or display name contains any of these keywords. Matching is case-insensitive. |
| `onlyWithEmail` | boolean | Only include accounts with a public email in the bio. This also fills the bioEmail field. |
| `scanLimit` | integer | Maximum list rows to scan before stopping. Use a higher value to search deeper for rare filters. 0 = automatic (10x the row cap, up to 10,000). |

Example `input.json` (the Actor's published prefill):

```json
{
  "profiles": [
    "natgeo"
  ],
  "listType": "following",
  "maxUsersPerProfile": 3,
  "includeStats": true,
  "includeBioEmail": false,
  "onlyVerified": false,
  "sellerOnly": false,
  "excludePrivate": false,
  "minFollowers": 0,
  "maxFollowers": 0,
  "onlyWithEmail": false,
  "scanLimit": 0
}
```

## Run

```bash
curl -sS -X POST "https://api.apify.com/v2/acts/nimbryxo-studio~tiktok-follow-graph-and-audience-export-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d @input.json > results.json
```

The call waits for the run to finish and returns the dataset items as a JSON array. If the run needs more than 300 seconds the API answers with HTTP 408; then start the run with `POST /v2/acts/nimbryxo-studio~tiktok-follow-graph-and-audience-export-scraper/runs`, poll `GET /v2/actor-runs/{runId}` until `SUCCEEDED`, and read `GET /v2/datasets/{defaultDatasetId}/items`.

## Output

Each item is one record. Published fields include: `sourceUsername`, `listType`, `position`, `userId`, `username`, `displayName`, `verified`, `privateAccount`, `ttSeller`, `followerCount`, `followingCount`, `heartCount`, `videoCount`, `diggCount`, `listTotal`, `profileUrl`, `scrapedAt`.

Summarise what was found, cite the record URLs when present, and say how many items came back. Do not invent values for empty fields.