Douyin Fetch One Video By Share URL

2.07 credits/call
ae_douyin_fetch_one_video_by_share_url

Retrieve data for one Douyin video from its share link. Input: - share_url (required, string): The video's share URL, for example https://v.douyin.com/e3x2fjE/. Result: - Returns the video's data when available. The exact data fields are not specified by the response schema. - Deleted, restricted, or otherwise unavailable videos may still return HTTP 200 with filter_detail. Check the returned content rather than treating HTTP success as proof that the video is accessible. This tool looks up a single video; it does not perform keyword searches or batch lookups.

VideoSocial
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.

This price applies to a normal successful call that retrieves data for a single Douyin video through a share link. If the work is deleted, restricted, or otherwise unavailable, an HTTP success status alone does not confirm that it is accessible.

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
share_urlstringYes分享链接/Share link—

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_douyin_fetch_one_video_by_share_url' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "share_url": "https://v.douyin.com/KUcpDC16idg/"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "aweme_detail": {
      "activity_video_type": 0,
      "authentication_token": "MS4wLjAAAAAAyoEM9YbgbaiP1A9CK-LkaaARvrXTWKOWq2qU0n9r3dw6dmnwhrsbDJ8b5-bDBV9Pzkw--uPdT0aAYNDs_XWOdzRRXqOyJG-AyyEW6qSfOBA2ngiuiso1mNclY5XwFgciX9CovNVW3k-swFTmgzzcjI5pvF3UIBHRI3qkIRhYF7dJ9SojbsDdgK_YQMr9igu_fcEuKfQrugzem3m6cM14gjqUgK3DZQHcCBlBGyMc3WN6SLniJvkP",
      "author": {
        "avatar_thumb": {
          "height": 720,
          "uri": "100x100/aweme-avatar/tos-cn-avt-0015_12c2470a2849580fd1921e753107bbd2",
          "url_list": [
            "https://p3-pc.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_12c2470a2849580fd1921e753107bbd2.jpeg?from=327834062"
          ],
          "width": 720
        },
        "close_friend_type": 0,
        "contacts_status": 2,
        "cover_url": [
          {
            "height": 720,
            "uri": "c8510002be9a3a61aad2",
            "url_list": [],
            "width": 720
          }
        ],
        "create_time": 0,
        "favoriting_count": 14
      },
      "author_mask_tag": 0,
      "author_user_id": 1888303172058442,
      "aweme_acl": {
        "download_mask_panel": {
          "code": 1,
          "show_type": 0
        }
      }
    }
  },
  "docs": "https://api.tikhub.io/#/Douyin-Web-API/fetch_one_video_by_share_url_api_v1_douyin_web_fetch_one_video_by_share_url_get",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功,本次请求将被计费。",
  "request_id": "2e88a768-d7a0-42a6-89c9-e3c2c0228fba"
}

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