/v1/tiktok/get-trending-feed

GET

Trending Feed

Get the trending feed from TikTok.

Credit cost	Default: 1 credit How charges are determined Cost is decided per call, not per endpoint: the same operation can cost different amounts depending on what it returns. A call that fails costs 0 credits. A result served from cache costs 0 credits. `default` is the cost when no rule matches. Rules are evaluated in order and the first whose conditions all hold wins. A `when` condition is one of: `param` (the request parameter is true), `outcome` (the classifier's outcome), `empty` / `nonEmpty` (a response field is empty and absent, or a non-empty array or string), `flag` (a response field is exactly true). A cost of `{ perStartedMinute: n, of: [fields] }` is n x max(1, ceil(seconds / 60)), so even a short result bills at least one minute.
Cache support	Not specified in the published contract.
Pagination	No explicit pagination metadata in the published contract. Consult the parameters and response fields below.

Parameters

Name	Location / required	Schema
`region` Proxy country. Affects regional content availability, not where posts were created.	query / required	`string`
`trim` Set to true to get a trimmed response.	query / optional	`boolean`

Request examples

Replace placeholder values and supply your own API key. For operations with a request body, populate the body using the schema above.

cURL

curl --request GET 'https://api.fetchproof.com/v1/tiktok/get-trending-feed?region=YOUR_REGION' \
  --header 'x-api-key: YOUR_API_KEY'

JavaScript

const response = await fetch("https://api.fetchproof.com/v1/tiktok/get-trending-feed?region=YOUR_REGION", {
  method: 'GET',
  headers: { 'x-api-key': process.env.FETCHPROOF_API_KEY }
});
console.log(await response.text());

Python

import os
import requests

response = requests.get("https://api.fetchproof.com/v1/tiktok/get-trending-feed?region=YOUR_REGION",
    headers={"x-api-key": os.environ["FETCHPROOF_API_KEY"]})
print(response.text)

Responses

200Success. Envelope: success / credits_remaining / credits_charged.

application/json

object

successrequired

boolean

credits_remainingrequired

integer

credits_chargedrequired

integer

aweme_listrequired

array

Array items

object

aweme_idrequired

string

descrequired

string

desc_languageoptional

string

regionrequired

string

statisticsrequired

object

aweme_idrequired

string

comment_countrequired

integer

digg_countrequired

integer

download_countrequired

integer

play_countrequired

integer

share_countrequired

integer

forward_countrequired

integer

lose_countoptional

integer

lose_comment_countoptional

integer

whatsapp_share_countrequired

integer

collect_countrequired

integer

repost_countrequired

integer

videorequired

object

play_addrrequired

object

urirequired

string

url_listrequired

array

Array items

string

widthoptional

integer

heightoptional

integer

url_keyoptional

string

url_prefixoptional

null

data_sizeoptional

integer

file_hashoptional

string

coveroptional

object

urirequired

string

url_listrequired

array

Array items

string

widthoptional

integer

heightoptional

integer

url_prefixoptional

null

download_addroptional

object

urirequired

string

url_listrequired

array

Array items

string

widthoptional

integer

heightoptional

integer

data_sizeoptional

integer

url_prefixoptional

null

has_watermarkoptional

boolean

durationoptional

integer

origin_coveroptional

object

urirequired

string

url_listrequired

array

Array items

string

dynamic_coveroptional

object

urirequired

string

url_listrequired

array

Array items

string

bit_rateoptional

array

Array items

object

HDR_bitrequired

string

HDR_typerequired

string

bit_raterequired

integer

dub_infosrequired

null

fpsrequired

integer

gear_namerequired

string

is_bytevc1required

integer

play_addrrequired

object

data_sizerequired

integer

file_csrequired

string

file_hashrequired

string

heightrequired

integer

urirequired

string

url_keyrequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

quality_typerequired

integer

video_extrarequired

string

image_post_infooptional

object

imagesoptional

array

Array items

object

display_imagerequired

object

urirequired

string

url_listrequired

array

Array items

string

widthrequired

integer

heightrequired

integer

url_prefixrequired

null

previewoptional

object

datarequired

string

preview_typerequired

integer

meta_keyrequired

string

bitrate_imagesoptional

array

ocr_languageoptional

string

owner_watermark_imageoptional

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

thumbnailoptional

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

user_watermark_imageoptional

object

heightrequired

integer

urirequired

string

url_listrequired

array

Array items

string

url_prefixrequired

null

widthrequired

integer

titlerequired

string

post_extrarequired

string

image_post_coveroptional

object

bitrate_imagesrequired

array

display_imagerequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

url_prefixrequired

null

widthrequired

integer

owner_watermark_imagerequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

url_prefixrequired

null

widthrequired

integer

thumbnailrequired

object

heightrequired

integer

urirequired

string

url_listrequired

array

url_prefixrequired

null

widthrequired

integer

music_volumeoptional

number

translation_infooptional

object

image_major_languagerequired

string

target_languagerequired

string

translatablerequired

boolean

authorrequired

object

uidrequired

string

short_idoptional

string

nicknamerequired

string

signatureoptional

string

avatar_thumboptional

object

urirequired

string

url_listrequired

array

Array items

string

widthrequired

integer

heightrequired

integer

url_prefixoptional

null

avatar_mediumoptional

object

urirequired

string

url_listrequired

array

Array items

string

widthrequired

integer

heightrequired

integer

url_prefixoptional

null

regionoptional

string

languageoptional

string

sec_uidoptional

string

social_infooptional

string

eventsoptional

null

follow_statusoptional

integer

is_blockoptional

boolean

custom_verifyoptional

string

unique_idoptional

string

is_discipline_memberoptional

boolean

secretoptional

integer

type_labeloptional

array

relative_usersoptional

null

cha_listoptional

null

avatar_largeroptional

object

urirequired

string

url_listrequired

array

Array items

string

heightrequired

integer

widthrequired

integer

create_timerequired

integer

is_adrequired

boolean

is_eligible_for_commissionrequired

boolean

create_time_utcrequired

string

{
  "format": "date-time"
}

urlrequired

string

author_user_idoptional

string

musicoptional

object

idrequired

integer

id_strrequired

string

albumrequired

string

titlerequired

string

authorrequired

string

play_urlrequired

object

urirequired

string

url_listrequired

array

Array items

string

cover_largerequired

object

urirequired

string

url_listrequired

array

Array items

string

heightrequired

integer

widthrequired

integer

cover_mediumrequired

object

urirequired

string

url_listrequired

array

Array items

string

heightrequired

integer

widthrequired

integer

cover_thumbrequired

object

urirequired

string

url_listrequired

array

Array items

string

heightrequired

integer

widthrequired

integer

is_original_soundrequired

boolean

is_commerce_musicrequired

boolean

durationrequired

integer

duration_high_precisionrequired

object

audition_duration_precisionrequired

integer

duration_precisionrequired

integer

shoot_duration_precisionrequired

integer

video_duration_precisionrequired

integer

share_infooptional

object

share_urlrequired

string

poi_dataoptional

object

address_inforequired

object

anchorsoptional

null

commerce_infooptional

null

item_comment_settingsoptional

integer

is_paid_partnershipoptional

null

shop_product_urloptional

null

401Invalid or missing x-api-key

402No credits remaining

403Upstream denied (age gate, audience controls)

404Resource or endpoint not found

429Rate limited