{"id":14979797,"url":"https://github.com/valmisson/ytubes","last_synced_at":"2025-10-28T19:32:03.843Z","repository":{"id":45187275,"uuid":"415115280","full_name":"valmisson/ytubes","owner":"valmisson","description":"Search for videos, playlists, channels, movies. live and musics on youtube without api key.","archived":false,"fork":false,"pushed_at":"2023-12-27T06:02:39.000Z","size":131,"stargazers_count":15,"open_issues_count":1,"forks_count":2,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-01T05:16:57.877Z","etag":null,"topics":["channel","crawler","live","movie","nodejs","playlist","scraper","search","typescript","videos","youtube","youtube-api","youtube-music","youtube-search","ytube"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/ytubes","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/valmisson.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-10-08T20:12:14.000Z","updated_at":"2024-12-25T20:41:46.000Z","dependencies_parsed_at":"2024-08-30T16:20:46.015Z","dependency_job_id":null,"html_url":"https://github.com/valmisson/ytubes","commit_stats":{"total_commits":28,"total_committers":1,"mean_commits":28.0,"dds":0.0,"last_synced_commit":"263bae7721501f5b11e3dc155d8a47075c12da5b"},"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valmisson%2Fytubes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valmisson%2Fytubes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valmisson%2Fytubes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valmisson%2Fytubes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/valmisson","download_url":"https://codeload.github.com/valmisson/ytubes/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238710373,"owners_count":19517690,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["channel","crawler","live","movie","nodejs","playlist","scraper","search","typescript","videos","youtube","youtube-api","youtube-music","youtube-search","ytube"],"created_at":"2024-09-24T14:00:41.949Z","updated_at":"2025-10-28T19:32:03.474Z","avatar_url":"https://github.com/valmisson.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ytubes\n\n[![npm][npm-shields]](https://www.npmjs.com/package/ytubes)\n[![license][license-shields]](https://github.com/valmisson/ytubes/blob/main/LICENSE)\n\nSearch for videos, shorts, playlists, channels, movies, live and musics on youtube without api key.\n\n## Install\n\n```bash\nyarn add ytubes\n```\n\n## Usage\n\n```js\nimport ytubes from 'ytubes'\n\nconst videos = await ytubes.getVideo('Amor e fé', { max: 1, language: 'pt-BR' })\n```\n\n### Typescript\n\n```ts\nimport * as ytubes from 'ytubes'\n```\n\n## Functions\n\n### getVideo(query, options)\n\nReturns the details of all videos found\n\n```js\nconst video = await ytubes.getVideo('Amor e fé')\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e\n\n  ```js\n  [\n    {\n      id: 'iZq0u3quAqo',\n      type: 'video',\n      title: 'Hungria Hip Hop - Amor e Fé (Official Music Video) #CheiroDoMato',\n      views: 291003057,\n      duration: '5:24',\n      uploaded: '1 year ago',\n      link: 'https://www.youtube.com/watch?v=iZq0u3quAqo',\n      shareLink: 'https://youtu.be/iZq0u3quAqo',\n      channel: 'https://www.youtube.com/channel/UCAI8SmRbXgSpP8Zo3xZbxzQ',\n      thumbnail: 'https://i.ytimg.com/vi/iZq0u3quAqo/maxresdefault.jpg'\n    },\n    ...\n  ]\n  ```\n\u003c/details\u003e\n\n### getShorts(query, options)\n\nReturns the details of all shorts found\n\n```js\nconst video = await ytubes.getShorts('Beat Tribo da Periferia')\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e\n\n  ```js\n  [\n    {\n      id: 'RV9JhsBN26s',\n      type: 'shorts',\n      title: 'Beat Insônia Tribo da periferia \u0026 Hungria - cover beat #shorts',\n      views: 2286,\n      link: 'https://www.youtube.com/shorts/RV9JhsBN26s',\n      channel: 'https://www.youtube.com/@g-ruahiphop',\n      thumbnail: 'https://i.ytimg.com/vi/RV9JhsBN26s/maxresdefault.jpg'\n    },\n    ...\n  ]\n  ```\n\u003c/details\u003e\n\n### getPlaylist(query, options)\n\nReturns the details of all playlist found\n\n```js\nconst playlist = await ytubes.getPlaylist('Tribo da Periferia - As Melhores')\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e\n\n  ```js\n  [\n    {\n      id: 'PL7V1hXWh2rMr4pz6lCkzHMHMLU3-BfQ2S',\n      type: 'playlist',\n      title: 'AS MELHORES - TRIBO DA PERIFERIA',\n      videoCount: 49,\n      link: 'https://www.youtube.com/playlist?list=PL7V1hXWh2rMr4pz6lCkzHMHMLU3-BfQ2S',\n      channel: 'https://www.youtube.com/channel/UCe5pPUSFEajlij-LrxUl19A',\n      thumbnail: 'https://i.ytimg.com/vi/crfRRVISmsw/maxresdefault.jpg',\n      preview: [\n        {\n          id: 'YrQLmElRT-E',\n          title: 'Tribo da Periferia - Imprevisível (Official Music Video)',\n          duration: '4:09',\n          link: 'https://www.youtube.com/watch?v=YrQLmElRT-E',\n          shareLink: 'https://youtu.be/YrQLmElRT-E',\n          thumbnail: 'https://i.ytimg.com/vi/YrQLmElRT-E/maxresdefault.jpg'\n        },\n        ...\n      ]\n    },\n    ...\n  ]\n  ```\n\u003c/details\u003e\n\n### getChannel(query, options)\n\nReturns the details of all channel found\n\n```js\nconst channel = await ytubes.getChannel('Hungria Hip Hop')\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e\n\n  ```js\n  [\n    {\n      id: 'UCAI8SmRbXgSpP8Zo3xZbxzQ',\n      type: 'channel',\n      name: 'OficialHungria',\n      verified: true\n      link: 'https://www.youtube.com/c/OficialHungria',\n    },\n    ...\n  ]\n  ```\n\u003c/details\u003e\n\n### getChannelVideos(query, options)\n\nReturns the details of all channel videos\n\n```js\nconst channel = await ytubes.getChannelVideos('@eminem')\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e\n\n  ```js\n  [\n    {\n      id: 'lexLAjh8fPA',\n      type: 'video',\n      title: 'Eminem - Like Toy Soldiers (Official Music Video)',\n      views: 455969481,\n      duration: '5:22',\n      uploaded: '13 years ago',\n      link: 'https://www.youtube.com/watch?v=lexLAjh8fPA',\n      shareLink: 'https://youtu.be/lexLAjh8fPA',\n      channel: 'https://www.youtube.com/@eminem',\n      thumbnail: 'https://i.ytimg.com/vi/lexLAjh8fPA/maxresdefault.jpg'\n    },\n    ...\n  ]\n  ```\n\u003c/details\u003e\n\n### getChannelShorts(query, options)\n\nReturns the details of all channel shorts\n\n```js\nconst channel = await ytubes.getChannelShorts('@eminem')\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e\n\n  ```js\n  [\n    {\n      id: 'By7NMf3C7xk',\n      type: 'shorts',\n      title: 'Eminem | Fortnite’s The Big Bang Event',\n      views: '684K views',\n      link: 'https://www.youtube.com/shorts/By7NMf3C7xk',\n      channel: 'https://www.youtube.com/@eminem',\n      thumbnail: 'https://i.ytimg.com/vi/By7NMf3C7xk/maxresdefault.jpg'\n    },\n    ...\n  ]\n  ```\n\u003c/details\u003e\n\n### getChannelLives(query, options)\n\nReturns the details of all channel lives\n\n```js\nconst channel = await ytubes.getChannelLives('@MusicLabChill')\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e\n\n  ```js\n  [\n    {\n      id: '9ZJT08MsRAs',\n      type: 'live',\n      live: true,\n      title: '🎧Music for Maximum Productivity — Chillout Radio 24/7',\n      link: 'https://www.youtube.com/watch?v=9ZJT08MsRAs',\n      shareLink: 'https://youtu.be/9ZJT08MsRAs',\n      channel: 'https://www.youtube.com/@MusicLabChill',\n      thumbnail: 'https://i.ytimg.com/vi/9ZJT08MsRAs/maxresdefault.jpg',\n      views: 29\n    },\n    ...\n  ]\n  ```\n\u003c/details\u003e\n\n### getChannelPlaylists(query, options)\n\nReturns the details of all channel playlists\n\n```js\nconst channel = await ytubes.getChannelPlaylists('@eminem')\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e\n\n  ```js\n  [\n    {\n      id: 'FLfM3zsQsOnfWNUppiycmBuw',\n      type: 'playlist',\n      title: 'Favorites',\n      videoCount: 32,\n      link: 'https://www.youtube.com/playlist?list=FLfM3zsQsOnfWNUppiycmBuw',\n      channel: 'https://www.youtube.com/@eminem',\n      thumbnail: 'https://i.ytimg.com/vi/XbGs_qK2PQA/maxresdefault.jpg',\n      preview: 'https://www.youtube.com/watch?v=XbGs_qK2PQA\u0026list=FLfM3zsQsOnfWNUppiycmBuw'\n    }\n    ...\n  ]\n  ```\n\u003c/details\u003e\n\n### getMovie(query, options)\n\nReturns the details of all movies found\n\n```js\nconst movie = await ytubes.getMovie('filmes de ação')\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e\n\n  ```js\n  [\n    {\n      id: 'MuTYo9tofSY',\n      type: 'video',\n      title: 'Thor Ragnarok Full Video - Voiced Motion Comic (Marvel Comics)',\n      views: 7119537,\n      duration: '1:33:17',\n      uploaded: '4 years ago',\n      link: 'https://www.youtube.com/watch?v=MuTYo9tofSY',\n      shareLink: 'https://youtu.be/MuTYo9tofSY',\n      channel: 'https://www.youtube.com/user/boscheinen',\n      thumbnail: 'https://i.ytimg.com/vi/MuTYo9tofSY/maxresdefault.jpg'\n    },\n    ...\n  ]\n  ```\n\u003c/details\u003e\n\n### getLive(query, options)\n\nReturns the details of all lives found\n\n```js\nconst live = await ytubes.getLive('Music for Work')\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e\n\n  ```js\n  [\n    {\n      id: '4kLviL8XwAI',\n      type: 'live',\n      live: true,\n      title: 'Music for Work — Programming, Hacking, Coding Radio',\n      link: 'https://www.youtube.com/watch?v=4kLviL8XwAI',\n      shareLink: 'https://youtu.be/4kLviL8XwAI',\n      channel: 'https://www.youtube.com/@MusicLabChill',\n      thumbnail: 'https://i.ytimg.com/vi/4kLviL8XwAI/maxresdefault.jpg',\n      views: 79\n    },\n    ...\n  ]\n  ```\n\u003c/details\u003e\n\n### getMusic(query, options)\n\nReturns the details of all musics found\n\n```js\nconst music = await ytubes.getMusic(\"2Pac - Pac's Life\")\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e\n\n  ```js\n  [\n    {\n      id: 'A1HvFGTB7NE',\n      type: 'music',\n      title: \"Pac's Life (feat. T.I. \u0026 Ashanti)\",\n      artist: '2Pac',\n      album: \"Pac's Life\",\n      duration: '3:37',\n      link: 'https://music.youtube.com/watch?v=A1HvFGTB7NE',\n      videoLink: 'https://www.youtube.com/watch?v=A1HvFGTB7NE',\n      channel: 'https://music.youtube.com/channel/UC5RrGzC-JXglhFW5NhT4r6w',\n      thumbnail: 'https://i.ytimg.com/vi/A1HvFGTB7NE/maxresdefault.jpg',\n      explicit: true\n    },\n    ...\n  ]\n  ```\n\u003c/details\u003e\n\n### search(query, options)\n\nReturns the details of seach\n\n```js\nconst videos = await ytubes.search('beautiful', { type: 'video' })\n```\n\n\u003cdetails\u003e\n  \u003csummary\u003eOutput\u003c/summary\u003e\n\n  ```js\n  [\n    {\n      id: '_FE194VN6c4',\n      type: 'video',\n      title: 'Snoop Dogg - Beautiful (Official Music Video) ft. Pharrell Williams',\n      views: 160183177,\n      duration: '5:29',\n      uploaded: '12 years ago',\n      link: 'https://www.youtube.com/watch?v=_FE194VN6c4',\n      shareLink: 'https://youtu.be/_FE194VN6c4',\n      channel: 'https://www.youtube.com/channel/UC-OO324clObi3H-U0bP77dw',\n      thumbnail: 'https://i.ytimg.com/vi/_FE194VN6c4/maxresdefault.jpg'\n    },\n    ...\n  ]\n  ```\n\u003c/details\u003e\n\n## Functions options\n\n| Property | Default | Description |\n|----------|---------|-------------|\n| `max` | `30` | Set the maximum amount of results to return. |\n| `language` | `en` | Set the language that you would like for results to be returned in. |\n| | | \u0026#11206; Option available only in `search`. |\n| `type` | `video` | Set the type of search on Youtube. The supported types are `video`, `shorts`, `playlist`, `channel`, `channelVideos`, `channelShorts`, `channelLives`, `channelPlaylists`, `movie`, `live`, and `music`. |\n\n\n## Note\n\nYou should keep in mind that this library does not use an official YouTube API and a change may cause an error in the search.\n\n## License\n[MIT](LICENSE)\n\nCopyright (c) 2021 Valmisson Grizorte\n\n[npm-shields]: https://img.shields.io/npm/v/ytubes.svg\n[license-shields]: https://img.shields.io/badge/license-MIT-green\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalmisson%2Fytubes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvalmisson%2Fytubes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalmisson%2Fytubes/lists"}