TikTok Trending Feed
tiktok.feed.trending
Get a page of TikTok's US For You feed for a visitor, from many creators.
At a glance
- Endpoint ID
tiktok.feed.trending- Price
- 0.75–1 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.feed.trending", "input": { "count": 5 }}'
import jsonimport osimport requestspayload = json.loads(r'''{ "capability": "tiktok.feed.trending", "input": { "count": 5 }}''')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.feed.trending", "input": { "count": 5 }}),});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 |
|---|---|---|---|---|
count |
integer | no | TikTok can return more or fewer records. From 1 to 35. | 5 |
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.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.followingUser followingtiktok.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.