TikTok Get Video By Share URL

2.07 credits/call
ae_tiktok_get_video_by_share_url

## Purpose Retrieve data for a single short-form video identified by its share URL. ## Input - `share_url` (required, string): The video's URL or share link. ## Return The response includes the video result in `data`, which may be null, along with response metadata such as status and request or time information. The interface does not specify the exact fields contained in `data`.

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.

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_tiktok_get_video_by_share_url' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "share_url": "https://www.tiktok.com/@tiktok/video/7702947070604332319?_r=1&u_code=elge0102iael21&preview_pb=0&sharer_language=en&_d=elh71682182bg2&share_item_id=7702947070604332319&source=h5_m"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "code": 200,
  "data": {
    "aweme_detail": {
      "added_sound_music_info": {
        "allow_offline_music_to_detail_page": false,
        "audition_duration": 43,
        "author": "TikTok",
        "author_deleted": false,
        "avatar_medium": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a",
          "url_list": [
            "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:720:720:q70.heic?dr=8836&refresh_token=452e60da&x-expires=1793869200&x-signature=r80llCUROrl%2BmyFfzwVCDH%2FBsY0%3D&t=223449c4&ps=87"
          ],
          "width": 720
        },
        "avatar_thumb": {
          "data_size": 0,
          "height": 720,
          "uri": "tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a",
          "url_list": [
            "https://p19-common-sign.tiktokcdn-us.com/tos-useast5-avt-0068-tx/ba67b11de451691939223e9d978e613a~tplv-tiktokx-cropcenter-q:100:100:q70.heic?dr=8835&refresh_token=1e2ce898&x-expires=1793869200&x-signature=8gaAxDTrZRNKBiJelJ2A%2FRwB8us%3D&t=223449c4&ps=87d6"
          ],
          "width": 720
        }
      }
    }
  },
  "docs": "https://api.tikhub.io/#/TikTok-App-V3-API/fetch_one_video_by_share_url_api_v1_tiktok_app_v3_fetch_one_video_by_share_url_get",
  "message": "Request successful. This request will incur a charge."
}

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