# @distube/ytsr 中文文档

规范地址：https://npmcn.com/package/%40distube/ytsr/

版本：2\.0\.4
npm 元数据更新时间：2026-10-22T07:54:20.297Z
中文译文更新时间：2026-11-12T12:17:00.115Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40distube/ytsr
原文对照：https://npmcn.com/package/%40distube/ytsr/?lang=original
项目主页：https://github.com/distubejs/ytsr#readme
源码仓库：https://github.com/distubejs/ytsr

弃用说明：Unmaintained\. Use Ytdl\#search from @distube/ytdl-core 5: https://github\.com/distubejs/ytdl-core/blob/main/docs/guides/search\.md

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：45 kB，7 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=14\.0
- 运行依赖：1 个
- 首次发布：2020-10-30T15:26:39.064Z
- 最新版本发布：2024-06-12T01:42:18.364Z
- 近 30 天下载量：4338（2026-10-13 至 2026-11-11，npm 官方下载统计）
- 已发布版本数：36（近 12 个月 0 个）

## 中文简介

Ytsr叉 (法语). 为DisTube.js.org而作.

## 安装

```sh
npm install @distube/ytsr
```

也可以使用：`pnpm add @distube/ytsr`、`yarn add @distube/ytsr`、`bun add @distube/ytsr`

## README

# @distube/ytsr (英语)

一个轻量级的ytsr [磁盘Tube](https://distube.js.org/)原样 [ytsr (英语)](https://www.npmjs.com/package/ytsr)。 。 。 .

# 特性

-   在YouTube上搜索视频
-   仅支持 `video` 财务报告和审定财务报表 `playlist` 类型

# 使用量

反应由原ytsr反应修改而来. 见 [示例答复](https://npmcn.com/package/%40distube/ytsr/#readme-example-response) 更多信息.

```js
const ytsr = require('@distube/ytsr');

ytsr('DisTube', { safeSearch: true, limit: 1 }).then(result => {
  let song = result.items[0];
  console.log('ID: ' + song.id);
  console.log('Name: ' + song.name);
  console.log('URL: ' + song.url);
  console.log('Views: ' + song.views);
  console.log('Duration: ' + song.duration);
  console.log('Live: ' + song.isLive);
});

/*
ID: Bk7RVw3I8eg
Name: Disturbed "The Sound Of Silence" 03/28/16
URL: https://www.youtube.com/watch?v=Bk7RVw3I8eg
Views: 114892726
Duration: 4:25
Live: false
*/
```

## API 密码

### ytsr( 清, 选项)

搜索给定的字符串

-   `searchString`
    
    -   搜索字符串或 URL( 从 getFilters ) 到搜索
-   `options`
    
    -   有选项的对象
    -   可能的设置 :
    -   gl \[结 --\] 一个国家的2-数字代码,默认为 `US` - 允许将请求本地化
    -   hl\[标\]-\]. 语言的2-数字代码,默认为 `en` - 允许将请求本地化
    -   utcOffsetminutes \[数量\] - > 从协调世界时算起,默认为 `-300` - 允许将请求本地化
    -   safeSearch \[Boolean\] - > 在Youtube限制模式下拉取项目.
    -   限制 \[整数\] - > 限制所拉项目, 默认值为 100, 设定为无穷值 以获取全部搜索结果列表 - 数字 < 1 导致使用的默认值
    -   类型 \[string\] - > 特定类型项目的过滤器,默认为 `video` - 可能的数值: `video`, (中文(简体) ), `playlist`
    -   备选\[标 −> 需要传递到 Undici 的附加参数 [请求选项](https://github.com/nodejs/undici#undicirequesturl-options-promise),用于执行 https 请求
-   返回承诺
    
-   [示例响应](https://npmcn.com/package/%40distube/ytsr/#readme-example-response)
    

## 更新检查

如果您想要禁用更新检查, 您可以通过提供 `YTSR_NO_UPDATE` env变量.

```
env YTSR_NO_UPDATE=1 node myapp.js
```

## 示例答复

```js
{
  query: 'lofi',
  items: [
    {
      type: 'video',
      name: 'lofi hip hop radio - beats to relax/study to',
      id: 'jfKfPfyJRdk',
      url: 'https://www.youtube.com/watch?v=jfKfPfyJRdk',
      thumbnail: 'https://i.ytimg.com/vi/jfKfPfyJRdk/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLD2EFON1LtcckqLkCokLTCzk0l5Jw',
      thumbnails: [
        {
          url: 'https://i.ytimg.com/vi/jfKfPfyJRdk/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLD2EFON1LtcckqLkCokLTCzk0l5Jw',
          width: 720,
          height: 404
        },
        {
          url: 'https://i.ytimg.com/vi/jfKfPfyJRdk/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLBhesbAXUbF95EBkPgG26L7-14BVA',
          width: 360,
          height: 202
        }
      ],
      isUpcoming: false,
      upcoming: null,
      isLive: true,
      badges: [ 'LIVE' ],
      author: {
        name: 'Lofi Girl',
        channelID: 'UCSJ4gkVC6NrvII8umztf0Ow',
        url: 'https://www.youtube.com/@LofiGirl',
        bestAvatar: {
          url: 'https://yt3.ggpht.com/KNYElmLFGAOSZoBmxYGKKXhGHrT2e7Hmz3WsBerbam5uaDXFADAmT7htj3OcC-uK1O88lC9fQg=s68-c-k-c0x00ffffff-no-rj',
          width: 68,
          height: 68
        },
        avatars: [
          {
            url: 'https://yt3.ggpht.com/KNYElmLFGAOSZoBmxYGKKXhGHrT2e7Hmz3WsBerbam5uaDXFADAmT7htj3OcC-uK1O88lC9fQg=s68-c-k-c0x00ffffff-no-rj',
            width: 68,
            height: 68
          }
        ],
        ownerBadges: [ 'Verified' ],
        verified: true
      },
      description: '',
      views: 20052,
      duration: '',
      uploadedAt: ''
    },
    {
      type: 'video',
      name: 'Nhạc Lofi 2023 - Những Bản Lofi Mix Chill Nhẹ Nhàng Cực Hay - Nhạc Trẻ Lofi Gây Nghiện Hot Nhất 2023',
      id: 'DALtfXfRgcM',
      url: 'https://www.youtube.com/watch?v=DALtfXfRgcM',
      thumbnail: 'https://i.ytimg.com/vi/DALtfXfRgcM/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCvkoLEsxjDDp9AYW5KoIgfwzIZPg',
      thumbnails: [
        {
          url: 'https://i.ytimg.com/vi/DALtfXfRgcM/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCvkoLEsxjDDp9AYW5KoIgfwzIZPg',
          width: 720,
          height: 404
        },
        {
          url: 'https://i.ytimg.com/vi/DALtfXfRgcM/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLAOgaKmx3QAhmc9fkynIpZAeujk8A',
          width: 360,
          height: 202
        }
      ],
      isUpcoming: false,
      upcoming: null,
      isLive: false,
      badges: [],
      author: {
        name: 'Hạ Sang',
        channelID: 'UC8WHyfTblB1QhzlJEZawLQw',
        url: 'https://www.youtube.com/@OrinnHaSang',
        bestAvatar: {
          url: 'https://yt3.ggpht.com/ytc/AL5GRJXaQNKJ-yi0AC_HZMO0XCEGol3Z2vxayyb0A8Z9qg=s68-c-k-c0x00ffffff-no-rj',
          width: 68,
          height: 68
        },
        avatars: [
          {
            url: 'https://yt3.ggpht.com/ytc/AL5GRJXaQNKJ-yi0AC_HZMO0XCEGol3Z2vxayyb0A8Z9qg=s68-c-k-c0x00ffffff-no-rj',
            width: 68,
            height: 68
          }
        ],
        ownerBadges: [ 'Verified' ],
        verified: true
      },
      description: '',
      views: 132032,
      duration: '49:10',
      uploadedAt: '9 days ago'
    },
    {
      type: 'video',
      name: 'Daily Work Space 📂 Lofi Deep Forcus [chill lo-fi hip hop beats]',
      id: 'bHi-1Ekk3KE',
      url: 'https://www.youtube.com/watch?v=bHi-1Ekk3KE',
      thumbnail: 'https://i.ytimg.com/vi/bHi-1Ekk3KE/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCBzHtpgMEjEU1G6WuZvXkOBH_9AA',
      thumbnails: [
        {
          url: 'https://i.ytimg.com/vi/bHi-1Ekk3KE/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCBzHtpgMEjEU1G6WuZvXkOBH_9AA',
          width: 720,
          height: 404
        },
        {
          url: 'https://i.ytimg.com/vi/bHi-1Ekk3KE/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLAQmtYqCoZDR6frLNIyFFpAaK4FJg',
          width: 360,
          height: 202
        }
      ],
      isUpcoming: false,
      upcoming: null,
      isLive: false,
      badges: [ 'CC' ],
      author: {
        name: '𝗖𝗛𝗜𝗟𝗟 𝗩𝗜𝗟𝗟𝗔𝗚𝗘',
        channelID: 'UCsxTsDvh-xQnShEtN1M64zQ',
        url: 'https://www.youtube.com/@Chill_Village',
        bestAvatar: {
          url: 'https://yt3.ggpht.com/1sjrCoAFx_Ak9g77xLRKv5na7Uz3MlvZ1KQQs-uhCtkdxFiLLTasPHH7e_NEuBO9DmPO_m9_=s68-c-k-c0x00ffffff-no-rj',
          width: 68,
          height: 68
        },
        avatars: [
          {
            url: 'https://yt3.ggpht.com/1sjrCoAFx_Ak9g77xLRKv5na7Uz3MlvZ1KQQs-uhCtkdxFiLLTasPHH7e_NEuBO9DmPO_m9_=s68-c-k-c0x00ffffff-no-rj',
            width: 68,
            height: 68
          }
        ],
        ownerBadges: [],
        verified: false
      },
      description: '',
      views: 277853,
      duration: '11:54:57',
      uploadedAt: 'Streamed 1 month ago'
    },
    {
      type: 'video',
      name: 'Chill Lofi Mix [chill lo-fi hip hop beats]',
      id: 'CLeZyIID9Bo',
      url: 'https://www.youtube.com/watch?v=CLeZyIID9Bo',
      thumbnail: 'https://i.ytimg.com/vi/CLeZyIID9Bo/hq720.jpg?sqp=-oaymwExCNAFEJQDSFryq4qpAyMIARUAAIhCGAHwAQH4Af4JgALQBYoCDAgAEAEYRyBlKFkwDw==&rs=AOn4CLDFiqIgoPbZX2JMVNzdtcG2yaymhg',
      thumbnails: [
        {
          url: 'https://i.ytimg.com/vi/CLeZyIID9Bo/hq720.jpg?sqp=-oaymwExCNAFEJQDSFryq4qpAyMIARUAAIhCGAHwAQH4Af4JgALQBYoCDAgAEAEYRyBlKFkwDw==&rs=AOn4CLDFiqIgoPbZX2JMVNzdtcG2yaymhg',
          width: 720,
          height: 404
        },
        {
          url: 'https://i.ytimg.com/vi/CLeZyIID9Bo/hq720.jpg?sqp=-oaymwE9COgCEMoBSFryq4qpAy8IARUAAAAAGAElAADIQj0AgKJDeAHwAQH4Af4JgALQBYoCDAgAEAEYRyBlKFkwDw==&rs=AOn4CLCUPAL7mhZ-wVunrmOhcxcNgptn2Q',
          width: 360,
          height: 202
        }
      ],
      isUpcoming: false,
      upcoming: null,
      isLive: false,
      badges: [ '4K' ],
      author: {
        name: 'Settle',
        channelID: 'UCkKT4qf-TcPFOmpqhTawrGA',
        url: 'https://www.youtube.com/@settlefm',
        bestAvatar: {
          url: 'https://yt3.ggpht.com/dl19pP2rM_VyLyU4p70Rn05zle60B27870wKQkGvELpAiWAgBFSmL_TXX2sskD3IuCACAGb1fg=s68-c-k-c0x00ffffff-no-rj',
          width: 68,
          height: 68
        },
        avatars: [
          {
            url: 'https://yt3.ggpht.com/dl19pP2rM_VyLyU4p70Rn05zle60B27870wKQkGvELpAiWAgBFSmL_TXX2sskD3IuCACAGb1fg=s68-c-k-c0x00ffffff-no-rj',
            width: 68,
            height: 68
          }
        ],
        ownerBadges: [],
        verified: false
      },
      description: '',
      views: 12770763,
      duration: '1:44:52',
      uploadedAt: '7 months ago'
    },
    {
      type: 'video',
      name: 'Nhạc Chill TikTok - Những Bản Lofi Việt Nhẹ Nhàng Cực Chill - Nhạc Lofi Chill Buồn Hot TikTok 2023',
      id: '9L-9votMIrw',
      url: 'https://www.youtube.com/watch?v=9L-9votMIrw',
      thumbnail: 'https://i.ytimg.com/vi/9L-9votMIrw/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAyItNyAF-lnXaNjhfi2HCPLnJEXA',
      thumbnails: [
        {
          url: 'https://i.ytimg.com/vi/9L-9votMIrw/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLAyItNyAF-lnXaNjhfi2HCPLnJEXA',
          width: 720,
          height: 404
        },
        {
          url: 'https://i.ytimg.com/vi/9L-9votMIrw/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLAeqhlXV3SXy92EJixuZYFI1IwcPg',
          width: 360,
          height: 202
        }
      ],
      isUpcoming: false,
      upcoming: null,
      isLive: false,
      badges: [ 'New' ],
      author: {
        name: 'Tiệm Nhạc Lofi',
        channelID: 'UCPEiJSKIdB8SeFt3YRU_fnw',
        url: 'https://www.youtube.com/@TiemNhacLofi',
        bestAvatar: {
          url: 'https://yt3.ggpht.com/N29QluoPr4no-Jm0QPU3B6cbt36Isx7aCOaKShsff7wgbfkoNXwoZ5dTZFXzfKzubXDrRv6ePg=s68-c-k-c0x00ffffff-no-rj',
          width: 68,
          height: 68
        },
        avatars: [
          {
            url: 'https://yt3.ggpht.com/N29QluoPr4no-Jm0QPU3B6cbt36Isx7aCOaKShsff7wgbfkoNXwoZ5dTZFXzfKzubXDrRv6ePg=s68-c-k-c0x00ffffff-no-rj',
            width: 68,
            height: 68
          }
        ],
        ownerBadges: [ 'Verified' ],
        verified: true
      },
      description: '',
      views: 15043,
      duration: '1:01:19',
      uploadedAt: '20 hours ago'
    },
    {
      type: 'video',
      name: '3107-2 - Sau Này Liệu Chúng Ta - Sợ Lắm 2 ft. Hẹn Yêu - Mix Freak D Mashup Lofi Sad Cực Chill - P2',
      id: 'HZ3XumHDDwA',
      url: 'https://www.youtube.com/watch?v=HZ3XumHDDwA',
      thumbnail: 'https://i.ytimg.com/vi/HZ3XumHDDwA/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLD6fCtWBCr8R0j99QxfweAU6hoS_g',
      thumbnails: [
        {
          url: 'https://i.ytimg.com/vi/HZ3XumHDDwA/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLD6fCtWBCr8R0j99QxfweAU6hoS_g',
          width: 720,
          height: 404
        },
        {
          url: 'https://i.ytimg.com/vi/HZ3XumHDDwA/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLC2RqK-3RZA-Uy2znlwr7WAAzSlIA',
          width: 360,
          height: 202
        }
      ],
      isUpcoming: false,
      upcoming: null,
      isLive: false,
      badges: [],
      author: {
        name: 'Pii Music',
        channelID: 'UCsSkCBIqzIpWGbGOKgrZ90w',
        url: 'https://www.youtube.com/@piimusic696',
        bestAvatar: {
          url: 'https://yt3.ggpht.com/ytc/AL5GRJUrah-GzpsEK2TgiIOuFKvctvIRZ_VIsxgxEtS6=s68-c-k-c0x00ffffff-no-rj',
          width: 68,
          height: 68
        },
        avatars: [
          {
            url: 'https://yt3.ggpht.com/ytc/AL5GRJUrah-GzpsEK2TgiIOuFKvctvIRZ_VIsxgxEtS6=s68-c-k-c0x00ffffff-no-rj',
            width: 68,
            height: 68
          }
        ],
        ownerBadges: [ 'Verified' ],
        verified: true
      },
      description: '',
      views: 32680485,
      duration: '40:29',
      uploadedAt: '2 years ago'
    },
    {
      type: 'video',
      name: 'Best of lofi hip hop 2021 ✨ - beats to relax/study to',
      id: 'n61ULEU7CO0',
      url: 'https://www.youtube.com/watch?v=n61ULEU7CO0',
      thumbnail: 'https://i.ytimg.com/vi/n61ULEU7CO0/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLABgYZhkqacI3o5_Pa56YPXWQbhRg',
      thumbnails: [
        {
          url: 'https://i.ytimg.com/vi/n61ULEU7CO0/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLABgYZhkqacI3o5_Pa56YPXWQbhRg',
          width: 720,
          height: 404
        },
        {
          url: 'https://i.ytimg.com/vi/n61ULEU7CO0/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLAg92gxOhLfxYAqrQ-MkqkeHNF6sg',
          width: 360,
          height: 202
        }
      ],
      isUpcoming: false,
      upcoming: null,
      isLive: false,
      badges: [],
      author: {
        name: 'Lofi Girl',
        channelID: 'UCSJ4gkVC6NrvII8umztf0Ow',
        url: 'https://www.youtube.com/@LofiGirl',
        bestAvatar: {
          url: 'https://yt3.ggpht.com/KNYElmLFGAOSZoBmxYGKKXhGHrT2e7Hmz3WsBerbam5uaDXFADAmT7htj3OcC-uK1O88lC9fQg=s68-c-k-c0x00ffffff-no-rj',
          width: 68,
          height: 68
        },
        avatars: [
          {
            url: 'https://yt3.ggpht.com/KNYElmLFGAOSZoBmxYGKKXhGHrT2e7Hmz3WsBerbam5uaDXFADAmT7htj3OcC-uK1O88lC9fQg=s68-c-k-c0x00ffffff-no-rj',
            width: 68,
            height: 68
          }
        ],
        ownerBadges: [ 'Verified' ],
        verified: true
      },
      description: '',
      views: 22469974,
      duration: '6:32:05',
      uploadedAt: '1 year ago'
    },
    {
      type: 'video',
      name: 'Nhạc Chill Nhẹ Nhàng Hot TikTok - Những Bản Nhạc Lofi Chill Nhẹ Nhàng Gây Nghiện Hay Nhất Hiện Giờ ♫',
      id: 'r5YZY2N6UWg',
      url: 'https://www.youtube.com/watch?v=r5YZY2N6UWg',
      thumbnail: 'https://i.ytimg.com/vi/r5YZY2N6UWg/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBUpN6KwhdJBUHFQq7MFei77psLBA',
      thumbnails: [
        {
          url: 'https://i.ytimg.com/vi/r5YZY2N6UWg/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBUpN6KwhdJBUHFQq7MFei77psLBA',
          width: 720,
          height: 404
        },
        {
          url: 'https://i.ytimg.com/vi/r5YZY2N6UWg/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLDJ0TCSg8KQRtEDXzF6vDajQ3ISBQ',
          width: 360,
          height: 202
        }
      ],
      isUpcoming: false,
      upcoming: null,
      isLive: false,
      badges: [ 'CC' ],
      author: {
        name: 'Mặt Trời Khóc',
        channelID: 'UCu-o0KDtNh3zZCfwMnUnyPQ',
        url: 'https://www.youtube.com/@mattroikhoc1289',
        bestAvatar: {
          url: 'https://yt3.ggpht.com/aWhYbRN0K7lLsfYJb5jYWAsG0TjUua-eeS_wvQuT6TVvbDgqGzaHhTk5nSGaLz0n-MRYgk2kGg=s68-c-k-c0x00ffffff-no-rj',
          width: 68,
          height: 68
        },
        avatars: [
          {
            url: 'https://yt3.ggpht.com/aWhYbRN0K7lLsfYJb5jYWAsG0TjUua-eeS_wvQuT6TVvbDgqGzaHhTk5nSGaLz0n-MRYgk2kGg=s68-c-k-c0x00ffffff-no-rj',
            width: 68,
            height: 68
          }
        ],
        ownerBadges: [],
        verified: false
      },
      description: '',
      views: 4008542,
      duration: '1:19:49',
      uploadedAt: '1 month ago'
    },
    {
      type: 'video',
      name: 'Gió Mang Hương Về Giờ Em Ở Đâu ♫ Gió (Jank) ♫ Nhạc Lofi Chill Buồn Tâm Trạng 2023',
      id: 'yhlZooyKMYw',
      url: 'https://www.youtube.com/watch?v=yhlZooyKMYw',
      thumbnail: 'https://i.ytimg.com/vi/yhlZooyKMYw/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCotGZ5FRy1R3o2tZoG4171FIZEcw',
      thumbnails: [
        {
          url: 'https://i.ytimg.com/vi/yhlZooyKMYw/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLCotGZ5FRy1R3o2tZoG4171FIZEcw',
          width: 720,
          height: 404
        },
        {
          url: 'https://i.ytimg.com/vi/yhlZooyKMYw/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLDhBG-HWBfswLQmO6-Sw5sW5ZXLNw',
          width: 360,
          height: 202
        }
      ],
      isUpcoming: false,
      upcoming: null,
      isLive: false,
      badges: [ 'New' ],
      author: {
        name: 'Will M',
        channelID: 'UCbq0B-aH1rxrqvfCH9mStvg',
        url: 'https://www.youtube.com/@will.liuliu',
        bestAvatar: {
          url: 'https://yt3.ggpht.com/bH44QORGWRuj7DAvPfgO5LWoS5f1ZMwZQLR5BW0_mtxCPEYrXXANXVJDX6gQAHiOsjsNB6BOkLc=s68-c-k-c0x00ffffff-no-rj',
          width: 68,
          height: 68
        },
        avatars: [
          {
            url: 'https://yt3.ggpht.com/bH44QORGWRuj7DAvPfgO5LWoS5f1ZMwZQLR5BW0_mtxCPEYrXXANXVJDX6gQAHiOsjsNB6BOkLc=s68-c-k-c0x00ffffff-no-rj',
            width: 68,
            height: 68
          }
        ],
        ownerBadges: [],
        verified: false
      },
      description: '',
      views: 30762,
      duration: '1:19:57',
      uploadedAt: '16 hours ago'
    },
    {
      type: 'video',
      name: 'Phai Dấu Cuộc Tình (Lofi ver) Đạt Long Vinh - Một người ra đi vội vã, Mang theo những dấu yêu xa rời',
      id: 'gxePeTdmlgU',
      url: 'https://www.youtube.com/watch?v=gxePeTdmlgU',
      thumbnail: 'https://i.ytimg.com/vi/gxePeTdmlgU/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBeB4HCgxU4J6pND-vg2DLe1Fpktg',
      thumbnails: [
        {
          url: 'https://i.ytimg.com/vi/gxePeTdmlgU/hq720.jpg?sqp=-oaymwEXCNAFEJQDSFryq4qpAwkIARUAAIhCGAE=&rs=AOn4CLBeB4HCgxU4J6pND-vg2DLe1Fpktg',
          width: 720,
          height: 404
        },
        {
          url: 'https://i.ytimg.com/vi/gxePeTdmlgU/hq720.jpg?sqp=-oaymwEjCOgCEMoBSFryq4qpAxUIARUAAAAAGAElAADIQj0AgKJDeAE=&rs=AOn4CLCibZbbnAwKWTYwsKZZeKEYTMKctg',
          width: 360,
          height: 202
        }
      ],
      isUpcoming: false,
      upcoming: null,
      isLive: false,
      badges: [],
      author: {
        name: 'NHẠC XƯA LOFI',
        channelID: 'UCTSxGcEiXDrL4OkQDS67w4g',
        url: 'https://www.youtube.com/@nhacxualofi',
        bestAvatar: {
          url: 'https://yt3.ggpht.com/a07ixhurnkCWjPjQ6EJZWhmrfl-cae6yKx61f1YKkIXnkiaMAO61gfrm1JhOF0IGg88xKs7X=s68-c-k-c0x00ffffff-no-rj',
          width: 68,
          height: 68
        },
        avatars: [
          {
            url: 'https://yt3.ggpht.com/a07ixhurnkCWjPjQ6EJZWhmrfl-cae6yKx61f1YKkIXnkiaMAO61gfrm1JhOF0IGg88xKs7X=s68-c-k-c0x00ffffff-no-rj',
            width: 68,
            height: 68
          }
        ],
        ownerBadges: [],
        verified: false
      },
      description: '',
      views: 454054,
      duration: '1:00:34',
      uploadedAt: '1 month ago'
    }
  ],
  results: 38772312
}
```

## 常见问题

### @distube/ytsr 是什么？

Ytsr叉 \(法语\)\. 为DisTube\.js\.org而作\.注意：该包已被作者标记为弃用——Unmaintained\. Use Ytdl\#search from @distube/ytdl-core 5: https://github\.com/distubejs/ytdl-core/blob/main/docs/guides/search\.md

### 如何安装 @distube/ytsr？

在项目目录运行 npm install @distube/ytsr，或使用 pnpm add / yarn add / bun add。

### @distube/ytsr 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @distube/ytsr 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @distube/ytsr 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=14\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @distube/ytsr 可以商用吗？

@distube/ytsr 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @distube/ytsr 的下载量有多少？

根据 npm 官方下载统计，@distube/ytsr 在 2026/10/13 – 2026/11/11 这 30 天内被下载 4,338 次，日均约 145 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @distube/ytsr 还在维护吗？

最新版本 2\.0\.4 发布于 2024/06/12（2 年前）；至今共发布 36 个版本，其中过去 12 个月发布了 0 个；首次发布于 2020/10/30。作者已将其标记为弃用，新项目建议寻找替代方案。