抖音搜索数据

按关键词搜抖音公开视频与图文帖，含达人 42 字段画像、音乐 45 字段、平台三级内容分类与多码率视频源，可选 MP4 下载

最近更新：2026 年 7 月 13 日

§ 01

数据能力与使用场景

按关键词搜抖音公开视频与图文帖，含达人 42 字段画像、音乐 45 字段、平台三级内容分类与多码率视频源，可选 MP4 下载。覆盖抖音国内公开搜索结果，支持中文/英文/#话题/品牌名/emoji 关键词；每条结果自动嵌套达人画像（42 字段）、音乐元数据（45 字段）、视频规格（25 字段）、互动统计（13 计数器）与 23 个权限标志位。

🎬

视频基本信息

id/url/type/awemeTypeLabel/mediaTypeLabel/isStory/text/itemTitle/descLanguage/createTime/createDate，每条视频的稳定标识与文案

👤

达人完整画像

authorMeta 嵌套 42 字段：name/secUid/username/followersCount/verified/verifyType/signature/gender/country/withShopEntry 等

🎵

音乐元数据

musicMeta 45 字段：title/author/isOriginal/isPgc/duration/playUrl/ownerNickname，区分原创 vs 平台曲库（PGC）

📊

互动统计指标

statistics 13 项计数器：diggCount/shareCount/commentCount/collectCount/downloadCount/whatsappShareCount/exposureCount 等

🏷️

创作者话题标签

hashtags[]：达人手填的 #tag，含 id 与 name，如 #咖啡日常 / #自制咖啡

🤖

平台内容分类

videoTags[]：抖音服务器三级分类，如美食→美食教程→饮品教程，level 1/2/3，比 hashtag 更稳定的分类信号

🖼️

封面与幻灯图

videoMeta.cover/originCover/dynamicCover/animatedCover + images[]（图文帖），封面/幻灯片下载免费

🎞️

视频源与码率

videoMeta.duration/width/height/ratio/format/bitRates[]（多档 1080p/720p/540p）+ cdnUrlExpiresAt（链接过期时间戳）

🔗

分享与跨端链接

share.shareUrl/shareUrlSigned/shareTitle/shareLinkDesc（复制打开抖音... 模板）+ url（永久网页链接）

🛒

商业化标识

commerce.isAd/withShopEntry/withFusionShopEntry/withCommerceEntry/commerceUserLevel + permissions.canDownload/canDuet/canStitch 等 23 个权限标志

▸内容运营：监控品牌/竞品关键词下的视频热度、互动趋势与达人分布
▸达人筛选：按话题拉近期视频，比对 diggCount/shareCount 找优质 KOL
▸话题监控：跟踪某 #tag 下的发帖量与热度变化，判断话题生命周期
▸品类地图：用平台三级 videoTags（如美食→美食教程→饮品教程）看清品类内容分布
▸素材归档：批量下载 MP4 与封面图，建立内部素材库或二创原料库

§ 02

数据交付内容

基础视频元数据包

默认包含

每条视频的默认输出：唯一标识、文案、发布时间、城市、所属搜索词与排名。

核心字段：id、url、type、awemeTypeLabel、mediaTypeLabel、text、itemTitle、caption、previewTitle、descLanguage、createTime、createDate、region、city、searchKeyword、searchPosition、inputKeyword

达人画像包

默认包含

每条结果自动嵌套完整达人资料（42 字段），无需额外 add-on；含粉丝数、认证、简介、性别、是否带橱窗。

核心字段：authorMeta

媒体元数据包

默认包含

每条结果自动嵌套视频规格、音乐、互动数据、话题与平台分类；不下载实际文件，元数据本身免费。

核心字段：videoMeta、musicMeta、statistics、hashtags、videoTags

封面与幻灯片下载包

可选增强

开启 shouldDownloadCovers / shouldDownloadSlideshowImages 后，封面 JPEG 和图文帖每页图片会下载到 KV 存储并返回文件引用；下载本身免费，仅占用存储空间。

核心字段：coverFile、slideshowFiles

MP4 视频下载包

可选增强

开启 shouldDownloadVideos 后，每个视频的 MP4 文件下载到 KV 存储并返回文件引用；按成功下载数计费 $0.99/1k，失败下载（videoFile=null）不计费；图文帖无 MP4。

核心字段：videoFile

以下增强包默认关闭，可按需开启。开启后会按实际抓取量额外计费，询价时请注明需求。

MP4 视频下载

开启 shouldDownloadVideos 后，每个视频 MP4 文件下载到 KV 存储并返回 videoFile 引用。按成功下载数计费 $0.99/1k。图文帖（awemeTypeLabel=image）无 MP4，应改用幻灯片图片下载（免费）。少量下载会因 CDN 链接过期失败，失败时 videoFile=null，该行元数据照常交付、不收下载费。建议同时开启 shouldDownloadCovers 把封面也存下来。

§ 03

样例数据

商家名称	分类	地址	城市	电话	网站	评分	评论数
—	—	—	Langfang	—	—	—	—
—	—	—	Hunan	—	—	—	—
—	—	—	Inner Mongolia	—	—	—	—
—	—	—	Urumqi	—	—	—	—
—	—	—	Liaoning	—	—	—	—

共 12 条样例，展示前 5 条。完整数据（含所有字段与原始格式）询价后交付。

点击展开完整 JSON 样例

{
  "id": "7510430154377334075",
  "groupId": "7510430154377334075",
  "url": "https://www.douyin.com/video/7510430154377334075",
  "shareUrl": "https://www.iesdouyin.com/share/video/7510430154377334075/?region=US&mid=7510430164313213723&u_code=4f1ih6kb6820&did=MS4wLjABAAAAbzZa_NfAKMkfxtA0gzGzw80B8dNJ7lUBWMUghVFiwY7GFgPmEI5IuiUMULT1orAi&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=2YEaauVJu9HtLY.zFQzrWq3LNqNbX7GqvW4f9nJa1hg-&share_version=160600&ts=1785319499&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
  "type": "video",
  "awemeType": 0,
  "awemeTypeLabel": "video",
  "mediaType": 4,
  "mediaTypeLabel": "video",
  "horizontalType": 0,
  "horizontalTypeLabel": "",
  "isStory": false,
  "text": "咖啡不再傻傻分不清 #咖啡#中国成都国际非遗节 #百young非遗计划",
  "caption": "#咖啡#中国成都国际非遗节",
  "itemTitle": "咖啡不再傻傻分不清",
  "previewTitle": "咖啡不再傻傻分不清 #咖啡#中国成都国际非遗节 #百young非遗计划",
  "descLanguage": "zh",
  "createTime": 1748658290,
  "createDate": "2025-05-31",
  "region": "CN",
  "city": "Langfang",
  "cityCode": "131000",
  "isPinned": false,
  "isAd": false,
  "isPgc": false,
  "isShared": false,
  "is24Story": false,
  "is25Story": false,
  "isFirstVideo": false,
  "isLifeItem": false,
  "isKaraoke": false,
  "isDuetSing": false,
  "isFantasy": false,
  "isInScope": false,
  "isImageBeat": false,
  "isVr": false,
  "authorMeta": {
    "id": "2340191371013143",
    "secUid": "MS4wLjABAAAA7ykAFL0tIPNFsSI-K32TH6nm64EAochAGDbB86EBW-AdIsD7lvMVD17TQumf5gbL",
    "name": "名做茶友会",
    "username": "4151068163",
    "customUsername": "moyedecha",
    "verified": true,
    "verificationReason": null,
    "signature": "极具饱和的每一秒，看到就是赚到～\n一见爱上传统文化，欢迎茶友们一起来分享茶知识！",
    "avatarThumb": "https://p3.douyinpic.com/aweme/100x100/aweme-avatar/tos-cn-avt-0015_64bd8edad60019f1b3e9c8c945b41d9e.jpeg?from=327834062",
    "avatarMedium": "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_64bd8edad60019f1b3e9c8c945b41d9e.jpeg?from=327834062",
    "avatar168": "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_64bd8edad60019f1b3e9c8c945b41d9e~c5_168x168.jpeg?from=327834062",
    "avatar300": "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_64bd8edad60019f1b3e9c8c945b41d9e~c5_300x300.jpeg?from=327834062",
    "avatarLarge": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_64bd8edad60019f1b3e9c8c945b41d9e.jpeg?from=327834062",
    "bgImage": null,
    "followingCount": null,
    "followersCount": 2293814,
    "followersCountStr": null,
    "totalLikesReceived": null,
    "likesGivenCount": null,
    "awemeCount": null,
    "gender": "female",
    "language": "zh-Hans",
    "country": "CN",
    "ipLocation": null,
    "verifyType": 1,
    "customVerifyText": null,
    "enterpriseVerifyReason": null,
    "userAge": null,
    "birthday": null,
    "constellation": 10,
    "isLiving": false,
    "roomId": null,
    "isStar": false,
    "usesSeries": false,
    "withShopEntry": true,
    "commerceUserLevel": null,
    "school": null,
    "customUsernameUpdatedAt": 1785319499,
    "shareUrl": null,
    "shareQrCodeUri": "31c420008c1c1bd89b43b",
    "crossPlatform": null,
    "mcnInfo": null
  },
  "videoMeta": {
    "duration": 36600,
    "width": 1080,
    "height": 1920,
    "ratio": "540p",
    "format": "mp4",
    "isLongVideo": false,
    "isHdr": false,
    "isBytevc1": false,
    "hasWatermark": true,
    "useStaticCover": true,
    "horizontalType": null,
    "cdnUrlExpiresAt": 1785323135,
    "playUrl": "https://v11-colds.douyinvod.com/e6fd57d5ed9ef773dc30303d5c7ef10c/6a69de7f/video/tos/cn/tos-cn-ve-15c000-ce/o4FqgePDGJxQL7lBr0I1M8Q1dC8I3eZgae7D4A/?a=1128&ch=11&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=664&bt=664&cs=2&ds=4&ft=urk.bPIPPT2Nvj6nMwlnwEHhd.yPUrqR3-ApUX&mime_type=video_mp4&qs=0&rc=NDlkMzZnZTw2OWVkZmU6ZEBpam04dnA5cjg5MzMzbGkzNEAxNjJiNDRjNTAxXi4uMi01YSNzYDRqMmRjYnFhLS1kLWJzcw%3D%3D&btag=c0090e00098008&cdn_type=2&cquery=100b_105E_103Q_103R_103S&dy_q=1785319499&feature_id=4fb091d884de9ce11fccc743bd685127&l=20260729180458518F13BE5A3D389A4B97&pwid=282&req_cdn_type=r",
    "downloadUrl": "https://v11-colds.douyinvod.com/a4ee11519d3e11c8d2a1b7b9a8ee64a1/6a69de7f/video/tos/cn/tos-cn-ve-15c000-ce/oMfy6UVAEQCEtswbtxDneoEJOIFc1a9pmFfAch/?a=1128&ch=11&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=1181&bt=1181&cs=0&ds=3&ft=urk.bPIPPT2Nvj6nMwlnwEHhd.yPUrqR3-ApUX&mime_type=video_mp4&qs=0&rc=O2gzZDpkNDw1aGQ7ZGczPEBpam04dnA5cjg5MzMzbGkzNEAzXmM1MjQzNS4xLi0xY15gYSNzYDRqMmRjYnFhLS1kLWJzcw%3D%3D&btag=c0010e00098008&cdn_type=3&cquery=103R_103S_100b_105E_103Q&dy_q=1785319499&feature_id=dc6e471fd69cf67451806384e04f2b47&l=20260729180458518F13BE5A3D389A4B97&pdp=online_ksyun&pwid=282&req_cdn_type=r",
    "playUrlH264": "https://v26-colds.douyinvod.com/9a97d35463ad8222232295d38a317093/6a69de7f/video/tos/cn/tos-cn-ve-15c000-ce/oEQB0LQ3MCGPJlG4IezC08ggIZeDedarZR4A7X/?a=1128&ch=11&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=762&bt=762&cs=0&ds=6&ft=urk.bPIPPT2Nvj6nMwlnwEHhd.yPUrqR3-ApUX&mime_type=video_mp4&qs=0&rc=Zjk6aDw0Z2U2Z2g8ZzpkO0Bpam04dnA5cjg5MzMzbGkzNEAxYDExNjM0XzUxLzA2Ll8uYSNzYDRqMmRjYnFhLS1kLWJzcw%3D%3D&btag=c0050e00098008&cdn_type=2&cquery=105E_103Q_103R_103S_100b&dy_q=1785319499&feature_id=f0150a16a324336cda5d6dd0b69ed299&l=20260729180458518F13BE5A3D389A4B97&pwid=282&req_cdn_type=r",
    "playUrlH265": "https://v11-colds.douyinvod.com/e6fd57d5ed9ef773dc30303d5c7ef10c/6a69de7f/video/tos/cn/tos-cn-ve-15c000-ce/o4FqgePDGJxQL7lBr0I1M8Q1dC8I3eZgae7D4A/?a=1128&ch=11&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=664&bt=664&cs=2&ds=4&ft=urk.bPIPPT2Nvj6nMwlnwEHhd.yPUrqR3-ApUX&mime_type=video_mp4&qs=0&rc=NDlkMzZnZTw2OWVkZmU6ZEBpam04dnA5cjg5MzMzbGkzNEAxNjJiNDRjNTAxXi4uMi01YSNzYDRqMmRjYnFhLS1kLWJzcw%3D%3D&btag=c0090e00098008&cdn_type=2&cquery=100b_105E_103Q_103R_103S&dy_q=1785319499&feature_id=4fb091d884de9ce11fccc743bd685127&l=20260729180458518F13BE5A3D389A4B97&pwid=282&req_cdn_type=r",
    "playUrlLowBitrate": "https://v11-colds.douyinvod.com/1f3d4ca41c1b52b12d1af7f2a6e89d9e/6a69de7f/video/tos/cn/tos-cn-ve-15c000-ce/oAe7QB43earzBCD0PBC6Ifl1ggLnJQAMdZG8oI/?a=1128&ch=11&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=293&bt=293&cs=2&ds=3&ft=urk.bPIPPT2Nvj6nMwlnwEHhd.yPUrqR3-ApUX&mime_type=video_mp4&qs=0&rc=PGhnM2VoZ2dlOjg3Nzg1NUBpam04dnA5cjg5MzMzbGkzNEAvLzZjNmEzXy8xM2E0M2E2YSNzYDRqMmRjYnFhLS1kLWJzcw%3D%3D&btag=c0050e00098008&cdn_type=2&cquery=105E_103Q_103R_103S_100b&dy_q=1785319499&feature_id=769c3afe3ecf8f6d5a978bb46a2550e2&l=20260729180458518F13BE5A3D389A4B97&pwid=282&req_cdn_type=r",
    "bitRates": [
      {
        "quality": "1080_1_1",
        "bitRate": 680086,
        "isH265": true,
        "fps": 30,
        "qualityType": 3,
        "url": "https://v11-colds.douyinvod.com/e6fd57d5ed9ef773dc30303d5c7ef10c/6a69de7f/video/tos/cn/tos-cn-ve-15c000-ce/o4FqgePDGJxQL7lBr0I1M8Q1dC8I3eZgae7D4A/?a=1128&ch=11&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=664&bt=664&cs=2&ds=4&ft=urk.bPIPPT2Nvj6nMwlnwEHhd.yPUrqR3-ApUX&mime_type=video_mp4&qs=0&rc=NDlkMzZnZTw2OWVkZmU6ZEBpam04dnA5cjg5MzMzbGkzNEAxNjJiNDRjNTAxXi4uMi01YSNzYDRqMmRjYnFhLS1kLWJzcw%3D%3D&btag=c0090e00098008&cdn_type=2&cquery=100b_105E_103Q_103R_103S&dy_q=1785319499&feature_id=4fb091d884de9ce11fccc743bd685127&l=20260729180458518F13BE5A3D389A4B97&pwid=282&req_cdn_type=r"
      },
      {
        "quality": "720_1_1",
        "bitRate": 402116,
        "isH265": true,
        "fps": 30,
        "qualityType": 11,
        "url": "https://v26-colds.douyinvod.com/77aadafb744d5aad2eba1ca8b12b9d96/6a69de7f/video/tos/cn/tos-cn-ve-15c000-ce/oIy6VnwOfAIw5cQFQD9oh2CfaEEeFAwsbmBEvt/?a=1128&ch=11&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=392&bt=392&cs=2&ds=3&ft=urk.bPIPPT2Nvj6nMwlnwEHhd.yPUrqR3-ApUX&mime_type=video_mp4&qs=0&rc=ZGQ8NGVkZmdnZGQ5OGY7aEBpam04dnA5cjg5MzMzbGkzNEAvYl5iLjU0Xi4xNWNfY2JfYSNzYDRqMmRjYnFhLS1kLWJzcw%3D%3D&btag=c0050e00098048&cdn_type=3&cquery=100b_105E_103Q_103R_103S&dy_q=1785319499&feature_id=769c3afe3ecf8f6d5a978bb46a2550e2&l=20260729180458518F13BE5A3D389A4B97&pdp=no_detect_popularity&pwid=282&req_cdn_type=r"
      },
      {
        "quality": "720_2_1",
        "bitRate": 300855,
        "isH265": true,
        "fps": 30,
        "qualityType": 12,
        "url": "https://v11-colds.douyinvod.com/1f3d4ca41c1b52b12d1af7f2a6e89d9e/6a69de7f/video/tos/cn/tos-cn-ve-15c000-ce/oAe7QB43earzBCD0PBC6Ifl1ggLnJQAMdZG8oI/?a=1128&ch=11&cr=3&dr=0&lr=all&cd=0%7C0%7C0%7C3&cv=1&br=293&bt=293&cs=2&ds=3&ft=urk.bPIPPT2Nvj6nMwlnwEHhd.yPUrqR3-ApUX&mime_type=video_mp4&qs=0&rc=PGhnM2VoZ2dlOjg3Nzg1NUBpam04dnA5cjg5MzMzbGkzNEAvLzZjNmEzXy8xM2E0M2E2YSNzYDRqMmRjYnFhLS1kLWJzcw%3D%3D&btag=c0050e00098008&cdn_type=2&cquery=105E_103Q_103R_103S_100b&dy_q=1785319499&feature_id=769c3afe3ecf8f6d5a978bb46a2550e2&l=20260729180458518F13BE5A3D389A4B97&pwid=282&req_cdn_type=r"
      }
    ],
    "cover": "https://p3-sign.douyinpic.com/tos-cn-i-0813c000-ce/o4AA1rwAhiITAh99OaBVMnPBXPyDA3QXAiZEh~tplv-dy-resize-walign-adapt-aq:540:q75.heic?lk3s=138a59ce&x-expires=1786528800&x-signature=9U38fxtOT3o6dabmw20nleCHK98%3D&from=327834062&s=PackSourceEnum_SEARCH&se=false&sc=cover&biz_tag=aweme_video&l=20260729180458518F13BE5A3D389A4B97",
    "coverOriginalScale": null,
    "originCover": "https://p3-sign.douyinpic.com/tos-cn-p-0015c000-ce/ocamoEItcADswyAVIPMACTh6feFH9OnERtjbfl~tplv-dy-360p.heic?lk3s=138a59ce&x-expires=1786528800&x-signature=nk1tSXuGsFTgRefXxiKk7C9SbZo%3D&from=327834062&s=PackSourceEnum_SEARCH&se=false&sc=origin_cover&biz_tag=aweme_video&l=20260729180458518F13BE5A3D389A4B97",
    "dynamicCover": "https://p3-sign.douyinpic.com/obj/tos-cn-i-0813c000-ce/o4AA1rwAhiITAh99OaBVMnPBXPyDA3QXAiZEh?lk3s=138a59ce&x-expires=1786528800&x-signature=wQgdeQ2Xes%2BD1daqfMg%2FZ%2BaWDTo%3D&from=327834062_large&s=PackSourceEnum_SEARCH&se=false&sc=dynamic_cover&biz_tag=aweme_video&l=20260729180458518F13BE5A3D389A4B97",
    "animatedCover": "https://p3-sign.douyinpic.com/obj/tos-cn-i-0813c000-ce/o4AA1rwAhiITAh99OaBVMnPBXPyDA3QXAiZEh?lk3s=138a59ce&x-expires=1786528800&x-signature=wQgdeQ2Xes%2BD1daqfMg%2FZ%2BaWDTo%3D&from=327834062_large&s=PackSourceEnum_SEARCH&se=false&sc=dynamic_cover&biz_tag=aweme_video&l=20260729180458518F13BE5A3D389A4B97",
    "bigThumbs": [
      {
        "imgXLen": 10,
        "imgYLen": 4,
        "interval": 1,
        "fext": "jpg",
        "uris": null,
        "imgUrls": null
      }
    ],
    "videoModelMeta": null
  },
  "musicMeta": {
    "id": "7510430164313213723",
    "title": "@名做茶友会创作的原声",
    "author": "名做茶友会",
    "album": null,
    "artists": null,
    "artistUserInfos": null,
    "musicianUserInfos": null,
    "isOriginal": true,
    "isPgc": false,
    "isCommerce": false,
    "isMatchedMetadata": false,
    "matchedPgcSound": null,
    "isRestricted": false,
    "isVideoSelfSee": false,
    "isDelVideo": false,
    "ownerId": "2340191371013143",
    "ownerHandle": "moyedecha",
    "ownerNickname": "名做茶友会",
    "secUid": "MS4wLjABAAAA7ykAFL0tIPNFsSI-K32TH6nm64EAochAGDbB86EBW-AdIsD7lvMVD17TQumf5gbL",
    "authorDeleted": false,
    "duration": 36,
    "startTime": 0,
    "endTime": 0,
    "previewStartTime": 0,
    "previewEndTime": 0,
    "lyricShortPosition": null,
    "position": null,
    "playUrl": "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/7510430171426523913.mp3",
    "coverThumb": "https://p3.douyinpic.com/img/aweme-avatar/tos-cn-avt-0015_64bd8edad60019f1b3e9c8c945b41d9e~c5_168x168.jpeg?from=327834062",
    "coverMedium": "https://p3.douyinpic.com/aweme/720x720/aweme-avatar/tos-cn-avt-0015_64bd8edad60019f1b3e9c8c945b41d9e.jpeg?from=327834062",
    "coverLarge": "https://p3.douyinpic.com/aweme/1080x1080/aweme-avatar/tos-cn-avt-0015_64bd8edad60019f1b3e9c8c945b41d9e.jpeg?from=327834062",
    "strongBeatUrl": "https://sf6-cdn-tos.douyinstatic.com/obj/ies-music/pattern/cf6cdd67a193fd986416215b225d999b.json",
    "schemaUrl": null,
    "status": 1,
    "muteShare": false,
    "musicStatus": 1,
    "musicChartRanks": null,
    "canBackgroundPlay": true,
    "preventDownload": false,
    "tagList": null,
    "userCount": 0,
    "musicCollectCount": 0,
    "externalSongInfo": [],
    "offlineDesc": null,
    "unshelveCountries": null
  },
  "statistics": {
    "diggCount": 2155947,
    "shareCount": 960576,
    "commentCount": 42507,
    "collectCount": 450725,
    "playCount": 0,
    "downloadCount": 2,
    "forwardCount": 0,
    "admireCount": null,
    "whatsappShareCount": 1,
    "liveWatchCount": 0,
    "exposureCount": 0,
    "loseCount": 0,
    "loseCommentCount": 0
  },
  "permissions": {
    "canDuet": true,
    "canStitch": true,
    "canDownload": false,
    "canShare": true,
    "canComment": true,
    "canRepost": true,
    "canSave": true,
    "canShowComment": true,
    "canRecord": true,
    "canReact": true,
    "canMusic": true,
    "canDouplus": true,
    "canDynamicWallpaper": false,
    "allowFriendRecommend": false,
    "allowFriendRecommendGuide": false,
    "allowSelfRecommendToFriend": false,
    "isPrivate": false,
    "isProhibited": false,
    "isInReviewing": false,
    "isDeleted": false,
    "isReviewed": true,
    "withGoods": false,
    "withFusionGoods": false
  },
  "interaction": {
    "canComment": true,
    "canShowComment": true,
    "canShare": true,
    "canForward": true,
    "commentDisabled": false
  },
  "anchors": [],
  "commerce": {
    "isAd": false,
    "adType": 0,
    "isLifeItem": false,
    "originalAnchorType": null,
    "withShopEntry": false,
    "withFusionShopEntry": true,
    "withCommerceEntry": false,
    "withDouEntry": false,
    "withPromotionalMusic": false,
    "commerceUserLevel": 0
  },
  "risk": null,
  "share": {
    "shareUrl": "https://www.iesdouyin.com/share/video/7510430154377334075/",
    "shareUrlSigned": "https://www.iesdouyin.com/share/video/7510430154377334075/?region=US&mid=7510430164313213723&u_code=4f1ih6kb6820&did=MS4wLjABAAAAbzZa_NfAKMkfxtA0gzGzw80B8dNJ7lUBWMUghVFiwY7GFgPmEI5IuiUMULT1orAi&iid=MS4wLjABAAAANwkJuWIRFOzg5uCpDRpMj4OX-QryoDgn-yYlXQnRwQQ&with_sec_did=1&video_share_track_ver=&titleType=title&share_sign=2YEaauVJu9HtLY.zFQzrWq3LNqNbX7GqvW4f9nJa1hg-&share_version=160600&ts=1785319499&from_aid=1128&from_ssr=1&share_track_info=%7B%22link_description_type%22%3A%22%22%7D",
    "shareTitle": "咖啡不再傻傻分不清 #咖啡#中国成都国际非遗节 #百young非遗计划",
    "shareTitleOther": null,
    "shareTitleMyself": null,
    "shareDesc": "在抖音，记录美好生活",
    "shareDescInfo": "#在抖音，记录美好生活#咖啡不再傻傻分不清 #咖啡#中国成都国际非遗节 #百young非遗计划",
    "shareWeiboDesc": "#在抖音，记录美好生活#咖啡不再傻傻分不清 #咖啡#中国成都国际非遗节 #百young非遗计划",
    "shareQuote": null,
    "shareLinkDesc": "1.25 复制打开抖音，看看【名做茶友会的作品】咖啡不再傻傻分不清 # 咖啡# 中国成都国际非遗节... %s [email protected] 03/08 :7pm Euf:/ ",
    "shareSignatureUrl": null,
    "shareSignatureDesc": null,
    "boolPersist": 0,
    "shareTemplate": null
  },
  "xiguaCrossPost": null,
  "aiMetadata": null,
  "images": [],
  "mentions": [],
  "hashtags": [
    {
      "id": "1563924918201346",
      "name": "咖啡"
    },
    {
      "id": "1714017607399431",
      "name": "中国成都国际非遗节"
    },
    {
      "id": "7425561197631522831",
      "name": "百young非遗计划"
    }
  ],
  "videoTags": [
    {
      "name": "美食",
      "level": 1
    },
    {
      "name": "美食教程",
      "level": 2
    },
    {
      "name": "饮品教程",
      "level": 3
    }
  ],
  "chapters": [],
  "series": null,
  "location": null,
  "inputUrl": "咖啡",
  "videoFile": null,
  "coverFile": null,
  "slideshowFiles": null,
  "searchKeyword": "咖啡",
  "searchPosition": 1,
  "inputKeyword": "咖啡"
}

共 12 条样例，展示第 1 条。完整数据询价后交付。

§ 04

怎么告诉我们你的需求

你只需要告诉我们下面 5 件事，剩下的配置由我们来完成：

搜什么

目标关键词，可中文/英文/#话题/品牌名/emoji，可多个

例如：美食 / 咖啡 / iphone / #自制咖啡 / 周杰伦

怎么筛

排序方式（综合/最多点赞/最新）+ 发布时间窗口（一天/一周/半年/不限）+ 视频时长（<1分钟/1-5分钟/>5分钟/不限），三选可叠加

例如：最近一周 / 最多点赞 / <1分钟短视频

要多少

每个关键词期望抓取的视频数量，单关键词 0-2000（0=全部可用），实际单关键词一般 300-400 条

例如：每词 500 条，3 个词合计约 1500 条

要什么字段

默认含视频/达人/音乐/统计/标签元数据；另可选封面下载（免费）、幻灯片图下载（免费）、MP4 视频下载（付费 add-on $0.99/1k）

例如：全部元数据 + 封面下载 + MP4 下载

交付格式

Excel/CSV/JSON 任选；MP4 与图片文件单独打包到网盘或对象存储

例如：JSON + MP4 网盘打包

§ 05

套餐与询价

试水版

适合先验证数据质量与小批量达人筛选。单关键词 100-300 条，含全部 60+ 字段元数据与封面图下载（免费）。MP4 下载按 $0.99/1k 单独计。

询价

标准版

适合日常话题监控、达人筛选、竞品内容追踪。多关键词并发（最多 5 个），含全部元数据 + 封面下载；可选 MP4 下载 add-on。按结果数计价 $4.99/1k。

询价

批量/定制版

适合千条以上规模的内容库搭建、长视频筛选、跨关键词聚合、带 MP4 归档的完整素材库。量大从优，按具体场景与下载量报价。

询价

§ 06

服务流程

咨询

扫码加微信，描述你的数据需求

报价

1 小时内回复，按数据量与复杂度报价

交付

人工跑数据，清洗加工后微信交付

售后

数据有疑问随时找我，支持复购

§ 07

使用注意事项

•多关键词独立搜索后自动跨词去重，同一视频不会重复计费；一次任务最多 5 个关键词并行，建议组合相关词扩大覆盖（如 ["咖啡","拿铁","手冲"]）
•默认 maxResultsPerQuery=100，但实际单关键词一般有 300-400 条独立视频；设 0 表示抓全部可用，设 2000 是硬上限
•抖音视频播放/下载 URL 数小时内过期，videoMeta.cdnUrlExpiresAt 是 Unix 秒级过期时间戳；如需长期保存媒体文件，必须开启对应下载 add-on
•图文帖（awemeTypeLabel="image"）没有 MP4 文件，应开启 shouldDownloadSlideshowImages（免费）下载幻灯片图片，而不是开启 MP4 下载
•hashtags 是达人手填的 #tag，videoTags 是抖音服务器三级分类（如美食→美食教程→饮品教程），后者更稳定，做品类聚合分析时优先用 videoTags

§ 08

常见问题

你们能抓抖音哪些内容？

抖音公开搜索结果里的所有视频与图文帖：视频元数据、达人完整画像、音乐信息、互动统计、话题标签、平台三级内容分类、封面图、多码率视频源，共 60+ 字段。每条结果自动嵌套达人 42 字段、音乐 45 字段。

能按关键词搜吗？支持什么关键词？

支持。中文、英文、#话题标签、品牌名、人名、emoji 都可以（如美食/iphone/#咖啡/周杰伦/🍜）。多关键词独立搜索后自动去重，不会重复计费；单关键词一般返回几百条独立视频。

能按达人筛选吗？

这个 actor 只做关键词搜索，不能直接按达人 secUid 抓。如果你已有达人 ID，可以在询价时说明，我们用对应的达人主页 actor 单独抓取其全部作品与粉丝。

能下载视频 MP4 吗？

可以。开启 MP4 下载 add-on，按成功下载数计费 $0.99/1k；封面图和图文帖幻灯片图下载免费。少量下载会因 CDN 链接过期失败，失败行不收下载费。

视频链接是永久有效的吗？

url（douyin.com/video/...）和 shareUrl 永久有效，可作为长期引用。封面图与头像 URL 一般 14-30 天有效；视频播放/下载 URL 数小时内过期（过期时间在 videoMeta.cdnUrlExpiresAt 字段）。如需长期保存媒体文件，请开启对应的下载 add-on。

数据量上限是多少？

单关键词最多 2000 条，设 0 表示抓全部可用；实际单关键词一般能拿到 300-400 条独立视频。可一次传多个关键词（最多 5 个并行）扩大覆盖。

抓取抖音数据合规吗？

只抓取公开搜索结果，不涉及登录态内容。结果包含达人公开画像属个人数据，请确保你的使用场景符合《个人信息保护法》及适用法规（如 GDPR、CCPA），数据用途合规由客户负责。

交付时效多久？

数据是实时抓取的（无缓存）。100-500 条量级一般 1-3 小时交付；1000+ 条或带 MP4 下载按量加时。导出格式 Excel/CSV/JSON 任选，MP4 与图片文件单独打包到网盘或对象存储。

§ 09

完整技术参数

展开输入参数

FIELD	TYPE	DESCRIPTION
keywords	array	搜索关键词列表，支持中文/英文/#话题/品牌名/emoji。每个关键词独立搜索后自动跨词去重，不会重复计费。
maxResultsPerQuery	integer	每个关键词抓多少条。默认 100，最大 2000，设 0 抓全部可用。成本按条线性计算，单关键词实际一般能拿到 300-400 条独立视频。
sort	string	结果排序方式：general（综合/相关度）/most_liked（最多点赞）/latest（最新发布）。默认综合排序。
publishTime	string	发布时间窗口过滤：unlimited（不限）/one_day（一天内）/one_week（一周内）/half_year（半年内）。默认不限。
duration	string	视频时长过滤：unlimited（不限）/under_1m（<1分钟）/one_to_five（1-5分钟）/over_5m（>5分钟）。默认不限；抖音大部分内容 <60s。
shouldDownloadVideos	boolean	是否下载 MP4 到 KV 存储。每成功下载 1k 加收 $0.99。图文帖无 MP4，请改用幻灯片下载。少量下载会因 CDN 过期失败，失败行不收下载费。
shouldDownloadCovers	boolean	是否下载封面图（JPEG）到 KV 存储。免费。
shouldDownloadSlideshowImages	boolean	是否下载图文帖的每页幻灯片图到 KV 存储。免费。对纯视频帖无效。
videoKvStoreName	string	自定义 KV 存储名（仅小写字母/数字/横线），把下载的 MP4/封面/幻灯片存到持久化存储便于跨任务复用；留空用任务默认存储（任务结束即清理）。