Douyin Multi Video Information (V2)

Docs ↗
https://api.sandbase.ai/v1/api/douyin/app-v3/multi-video-v2

Returns metadata and details for multiple Douyin videos in a single batch request using an array provided in the request payload.

Price
$0.07USD / call
Method
POST
Response
JSON
Parameters
1 required · 0 optional

Playground

Input
Enter a JSON array.
OutputExample
Responseoutputs · 162.8 KB · 2,934 lines
[
  {
    "data": {
      "aweme_details": [
        {
          "activity_video_type": -1,
          "admire_auth": {
            "admire_button": 1,
            "author_can_admire": 0,
            "exit_admire_in_aweme_post": 0,
            "is_admire": 0,
            "is_click_admire_icon_recently": 0,
            "is_fifty_admire_author_stable_fans": 0,
            "is_iron_fans_in_aweme_post": 0,
            "is_show_admire_button": 0,
            "is_show_admire_tab": 0
          },
          "anchors": null,
          "authentication_token": "MS4wLjAAAAAA-Mt_dU_sswEoq7VXcXWSFwjmYqgSuNVbaJiXQZ4Vst8_97vdrFDfnvyft-fDIWn_r8HqvPsE96fYa-YlHTIB2ljZdHG1JaoKVCATy2Qoxtt1AyYAzMTC66X9PRoskYuWepFx3t4P22XduViRcBdi3gWwH9LC2C4ehHlARCd2pQCMjgQEN1zWrq90smGZ8A5dMvuUOID7SQP42ADNY2M7osDrYV7AMFwIoX0CqjC7EcIhg5P6_492T0eCcw-rXO1U",
          "author": {
            "accept_private_policy": false,
            "account_region": "",
            "ad_cover_url": null,
            "allow_story_normal_like": false,
            "apple_account": 0,
            "authority_status": 0,
            "avatar_168x168": {
              "height": 720,
              "uri": "168x168/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223",
              "url_list": [
                "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223~c5_168x168.webp?from=327834062",
                "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223~c5_168x168.jpeg?from=327834062"
              ],
              "width": 720
            },
            "avatar_300x300": {
              "height": 720,
              "uri": "300x300/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223",
              "url_list": [
                "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223~c5_300x300.webp?from=327834062",
                "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223~c5_300x300.jpeg?from=327834062"
              ],
              "width": 720
            },
            "avatar_larger": {
              "height": 720,
              "uri": "1080x1080/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223",
              "url_list": [
                "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223.webp?from=327834062",
                "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223.jpeg?from=327834062"
              ],
              "width": 720
            },
            "avatar_medium": {
              "height": 720,
              "uri": "720x720/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223",
              "url_list": [
                "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223.webp?from=327834062",
                "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223.jpeg?from=327834062"
              ],
              "width": 720
            },
            "avatar_thumb": {
              "height": 720,
              "uri": "100x100/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223",
              "url_list": [
                "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223.webp?from=327834062",
                "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223.jpeg?from=327834062"
              ],
              "width": 720
            },
            "avatar_uri": "aweme-avatar/tos-cn-avt-0015_51b6f98712281e77d7cf627ab393c223",
            "aweme_control": {
              "can_comment": true,
              "can_forward": true,
              "can_share": true,
              "can_show_comment": true
            },
            "aweme_count": 12,
            "aweme_hotsoon_auth": 1,
            "aweme_hotsoon_auth_relation": 1,
            "awemehts_greet_info": "",
            "ban_user_functions": [],
            "bind_phone": "",
            "birthday": "",
            "can_set_geofencing": null,
            "card_entries": null,
            "card_entries_not_display": null,
            "card_sort_priority": null,
            "cf_list": null,
            "cha_list": null,
            "close_friend_type": 0,
            "comment_filter_status": 0,
            "comment_setting": 0,
            "commerce_user_level": 0,
            "constellation": 0,
            "contacts_status": 2,
            "contrail_list": null,
            "cover_url": [
              {
                "height": 720,
                "uri": "c8510002be9a3a61aad2",
                "url_list": [
                  "https://p3-sign.douyinpic.com/obj/c8510002be9a3a61aad2?lk3s=138a59ce&x-expires=1792065600&x-signature=3YDiGehzxDjyGpTTC7INcXcgIeA%3D&from=327834062"
                ],
                "width": 720
              }
            ],
            "create_time": 0,
            "custom_verify": "",
            "cv_level": "",
            "data_label_list": null,
            "display_info": null,
            "download_prompt_ts": 0,
            "download_setting": -1,
            "duet_setting": 0,
            "enable_nearby_visible": false,
            "endorsement_info_list": null,
            "enterprise_verify_reason": "",
            "favoriting_count": 0,
            "fb_expire_time": 0,
            "follow_status": 0,
            "follower_count": 0,
            "follower_list_secondary_information_struct": null,
            "follower_request_status": 0,
            "follower_status": 0,
            "followers_detail": null,
            "following_count": 0,
            "gender": 2,
            "geofencing": [],
            "google_account": "",
            "has_email": false,
            "has_facebook_token": false,
            "has_insights": false,
            "has_orders": false,
            "has_twitter_token": false,
            "has_unread_story": false,
            "has_youtube_token": false,
            "hide_location": false,
            "hide_others_recommend_interest": 0,
            "hide_search": true,
            "hide_self_recommend_interest": 0,
            "homepage_bottom_toast": null,
            "im_role_ids": null,
            "ins_id": "",
            "interest_tags": null,
            "is_ad_fake": false,
            "is_binded_weibo": false,
            "is_block": false,
            "is_blocked_v2": false,
            "is_blocking_v2": false,
            "is_cf": 0,
            "is_discipline_member": false,
            "is_gov_media_vip": false,
            "is_mix_user": true,
            "is_not_show": false,
            "is_phone_binded": false,
            "is_star": false,
            "is_verified": true,
            "item_list": null,
            "ky_only_predict": 0,
            "language": "zh-Hans",
            "link_item_list": null,
            "live_agreement": 0,
            "live_agreement_time": 0,
            "live_commerce": false,
            "live_high_value": 0,
            "live_status": 0,
            "live_verify": 0,
            "location": "",
            "mate_add_permission": 0,
            "max_follower_count": 0,
            "need_points": null,
            "need_recommend": 0,
            "neiguang_shield": 0,
            "new_story_cover": null,
            "nickname": "设计师阿煜",
            "offline_info_list": null,
            "personal_tag_list": null,
            "platform_sync_info": null,
            "prevent_download": false,
            "react_setting": 0,
            "reflow_page_gid": 0,
            "reflow_page_uid": 0,
            "region": "CN",
            "relative_users": null,
            "risk_notice_text": "",
            "room_id": 0,
            "school_category": 0,
            "school_id": "",
            "school_name": "",
            "school_poi_id": "",
            "school_type": 0,
            "search_impr": {
              "entity_id": "3964161607609179"
            },
            "sec_uid": "MS4wLjABAAAAO--XH--qql8MqtQOynr8IvoD3nriLQfJum_SBV4vspcq6KNC_iwWnEPpawpr24M2",
            "secret": 0,
            "share_info": {
              "share_desc": "",
              "share_desc_info": "",
              "share_qrcode_url": {
                "height": 720,
                "uri": "",
                "url_list": [],
                "width": 720
              },
              "share_title": "",
              "share_title_myself": "",
              "share_title_other": "",
              "share_url": "",
              "share_weibo_desc": ""
            },
            "share_qrcode_uri": "",
            "shield_comment_notice": 0,
            "shield_digg_notice": 0,
            "shield_follow_notice": 0,
            "short_id": "34859148268",
            "show_image_bubble": false,
            "show_nearby_active": false,
            "signature": "Ai知识分享",
            "signature_display_lines": 5,
            "signature_extra": null,
            "special_follow_status": 0,
            "special_lock": 1,
            "special_people_labels": null,
            "status": 1,
            "stitch_setting": 0,
            "story25_comment": 0,
            "story_count": 0,
            "story_interactive": 0,
            "story_open": false,
            "story_ttl": 0,
            "sync_to_toutiao": 0,
            "text_extra": null,
            "total_favorited": 297,
            "tw_expire_time": 0,
            "twitter_id": "",
            "twitter_name": "",
            "type_label": null,
            "uid": "3964161607609179",
            "unique_id": "34859148268",
            "unique_id_modify_time": 1790857310,
            "user_age": -1,
            "user_canceled": false,
            "user_mode": 0,
            "user_not_see": 0,
            "user_not_show": 1,
            "user_period": 0,
            "user_permissions": null,
            "user_rate": 1,
            "user_tags": null,
            "verification_type": 1,
            "verify_info": "",
            "video_icon": {
              "height": 720,
              "uri": "",
              "url_list": [],
              "width": 720
            },
            "weibo_name": "",
            "weibo_schema": "",
            "weibo_url": "",
            "weibo_verify": "",
            "white_cover_url": null,
            "with_commerce_entry": false,
            "with_dou_entry": false,
            "with_fusion_shop_entry": false,
            "with_shop_entry": false,
            "youtube_channel_id": "",
            "youtube_channel_title": "",
            "youtube_expire_time": 0
          },
          "author_mask_tag": 0,
          "author_user_id": 3964161607609179,
          "aweme_acl": {
            "download_mask_panel": {
              "code": 1,
              "show_type": 0
            }
          },
          "aweme_control": {
            "can_comment": true,
            "can_forward": true,
            "can_share": true,
            "can_show_comment": true
          },
          "aweme_id": "7687107502068026650",
          "aweme_listen_struct": {
            "listen_diversion": {
              "extra": [
                {
                  "key": "new_guide_prefix",
                  "val": "下载汽水"
                },
                {
                  "key": "old_guide_prefix",
                  "val": "打开汽水"
                }
              ],

Examples

Select an example to load its inputs and result into the playground.

API README

Douyin Multi Video Information (V2) API

Fetch detailed information for multiple Douyin videos at once by providing a list in the body parameter.

Use cases

  • Retrieve metadata for multiple Douyin videos simultaneously.
  • Monitor video statistics and details across a batch of posts.
  • Populate media libraries with bulk Douyin video information.

Request

curl -X POST "https://api.sandbase.ai/v1/api/douyin/app-v3/multi-video-v2" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"body": "<body>"}'

Parameters

NameTypeRequiredDescription
bodyarrayYes—

Notes

  • Requires an array of video identifiers passed in the body parameter.

Pricing

Flat price per call. Failed calls, including lookups whose target does not exist, are not charged.

Explore more

Related APIs

All APIs
APIPriceResponse
Douyin$0.07 per callJSON
Douyin$0.0015 per callJSON
Douyin$0.0015 per callJSON
Douyin$0.0015 per callJSON
Douyin$0.0015 per callJSON
Douyin$0.0015 per callJSON

Questions

FAQ

How do I use the Douyin Multi Video Information (V2) API?

Send a POST request to https://api.sandbase.ai/v1/api/douyin/app-v3/multi-video-v2 with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the Douyin Multi Video Information (V2) API cost?

$0.07 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the Douyin Multi Video Information (V2) API accept?

Required: body (array). The Parameters table and the Playground on this page list every field.

What does the Douyin Multi Video Information (V2) API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a Douyin developer account or API key?

No. Douyin Multi Video Information (V2) runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for Douyin API access separately.