TikTok Fetch Home Feed

2.07 credits/call
ae_tiktok_fetch_home_feed

Fetch recommended works for a home feed. You may set the number of items (default 15), a region code (default US), and an optional user cookie for personalized recommendations. The result contains the feed data and may include video URLs. Direct video CDN URLs may require the returned `tt_chain_token` as a cookie when requested.

SocialVideo
2.07 credits/call

Pricing

2.07 credits/call
ConditionCharge
Each call2.07 credits/call

2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectNo用于请求首页推荐作品的请求体对象,可包含 count(每页数量)、cookie(可选的用户 Cookie,用于个性化推荐)和 region(可选的地区代码,影响推荐内容所属地区)。/ Object used to request the home feed; it may contain count (number per page), cookie (an optional user Cookie used for personalized recommendations), and region (an optional region code that affects the region of recommended content).—
request_body.countintegerNo每页数量/Number per page15
request_body.cookiestringNo用户自己的cookie,可选参数,用于接口返回数据的个性化推荐。/ User's own cookie, optional parameter, used for personalized recommendations of interface return data.—
request_body.regionstringNo地区代码,可选参数,影响推荐内容所属地区,如 US/GB/JP/KR/SG 等,默认 US。/ Region code, optional, affects the region of recommended content, e.g. US/GB/JP/KR/SG, default US.US

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_tiktok_fetch_home_feed' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "count": 50,
      "region": "US"
    }
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "cookie": "[REDACTED]",
    "log_pb": {
      "impr_id": "20261116020220E4D07A1E2F609A0607B9"
    },
    "statusCode": 10201,
    "statusMsg": "",
    "status_code": 10201,
    "status_msg": ""
  },
  "docs": "https://api.tikhub.io/#/TikTok-Web-API/fetch_home_feed_api_v1_tiktok_web_fetch_home_feed_post",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "params": {}
}

This example shows part of the response. Copied content is valid JSON.