TikTok User Following
tiktok.user.following
List the accounts a public account follows, page by page.
At a glance
- Endpoint ID
tiktok.user.following- Price
- 0.75 credits per call; failed calls are free
- Runs for up to
- 45 seconds
Request
Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.
curl --request POST \ --url https://data.upscrape.com/execute \ --header "Authorization: Bearer $UPSCRAPE_API_KEY" \ --header "Content-Type: application/json" \ --header "Prefer: wait=30" \ --data '{ "capability": "tiktok.user.following", "input": { "count": 5, "handle": "tiktok" }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "tiktok.user.following", "input": { "count": 5, "handle": "tiktok" }}''')response = requests.post( "https://data.upscrape.com/execute", headers={ "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}", "Content-Type": "application/json", "Prefer": "wait=30", }, json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))
const response = await fetch("https://data.upscrape.com/execute", { method: "POST", headers: { "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`, "Content-Type": "application/json", "Prefer": "wait=30", }, body: JSON.stringify({ "capability": "tiktok.user.following", "input": { "count": 5, "handle": "tiktok" }}),});if (!response.ok) { throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));
Input
| Field | Type | Required | What it does | Example |
|---|---|---|---|---|
handle |
string | one of | Account handle. | tiktok |
sec_uid |
string | one of | ||
count |
integer | no | TikTok can return more or fewer records. From 1 to 35. | 5 |
cursor |
integer | no | Continuation cursor returned by a previous request. At least 0. | |
target_user_id |
string | no | Target user identifier. |
Response
A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.
No sample response is published for this endpoint yet.
If a call fails
A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.
Other TikTok endpoints
tiktok.collection.videosCollection videostiktok.comment.repliesComment repliestiktok.feed.trendingTrending feedtiktok.hashtag.postsHashtag videostiktok.live.getLive room detailtiktok.music.infoSong detailtiktok.music.postsSong videostiktok.post.getVideo detailtiktok.profile.getUser profile detailtiktok.search.suggestionsSuggestions searchtiktok.shop.product.getShop product detailtiktok.shop.productsShop store productstiktok.shop.reviewsShop product reviewstiktok.shop.searchShop product searchtiktok.user.followersUser followerstiktok.user.liveUser live statustiktok.user.videosUser videostiktok.video.commentsVideo commentstiktok.video.transcriptVideo transcript
Something missing or unclear? Ask the team that builds the TikTok endpoints.