{"id":15007597,"url":"https://github.com/grkndev/twitcher","last_synced_at":"2026-03-09T18:05:53.743Z","repository":{"id":206636358,"uuid":"717355720","full_name":"grkndev/Twitcher","owner":"grkndev","description":"A great library that will allow you to use the Twitch API service. All you need to do is use your Token and Client Id information.","archived":false,"fork":false,"pushed_at":"2023-11-27T11:06:02.000Z","size":27,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-12T06:15:04.914Z","etag":null,"topics":["api","clip","clipr","data","javascript","nodejs","npm","npm-package","npmjs","streamers","streaming","twitch","twitch-api","twitch-bot","twitchtv","twtich-clip","user"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grkndev.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":null,"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},"funding":{"github":["gweepcreative","rabelcode"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2023-11-11T08:07:50.000Z","updated_at":"2024-01-06T13:02:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"3231cbb2-2875-43e4-910d-f4597889d63c","html_url":"https://github.com/grkndev/Twitcher","commit_stats":null,"previous_names":["gweepcreative/twitcher","grkndev/twitcher"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grkndev%2FTwitcher","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grkndev%2FTwitcher/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grkndev%2FTwitcher/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grkndev%2FTwitcher/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grkndev","download_url":"https://codeload.github.com/grkndev/Twitcher/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243165538,"owners_count":20246725,"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":["api","clip","clipr","data","javascript","nodejs","npm","npm-package","npmjs","streamers","streaming","twitch","twitch-api","twitch-bot","twitchtv","twtich-clip","user"],"created_at":"2024-09-24T19:12:00.937Z","updated_at":"2026-03-09T18:05:53.696Z","avatar_url":"https://github.com/grkndev.png","language":"JavaScript","funding_links":["https://github.com/sponsors/gweepcreative","https://github.com/sponsors/rabelcode"],"categories":[],"sub_categories":[],"readme":"# Installing\n```\nnpm install twitcher\n```\nor\n```\nyarn add twitcher\n```\n\n# Setup\n### Step 1:\n\u003e Get your app information from https://dev.twitch.tv/console\n\u003e If you don't have an app, create one\n\n### Step 2:\n\u003e Get Copy your application's **CLIENT_ID** and **CLIENT_SECRET** information\n\n## Paste the information you obtained\n```js\nimport Twtitcher from \"twitcher\"\nconst client = new Twitcher({\n  token:\"\", client_id:\"YOUR CLIENT ID\", client_secret:\"YOUR CLIENT SECRET\"\n});\n```\n## Then run the application to get your Token information\n```js\nconst token = client.getToken()\n```\n\n### Send the TOKEN you received to the client\n```js\nconst client = new Twitcher({\n  token:\"YOUR TOKEN\", client_id:\"YOUR CLIENT ID\", client_secret:\"YOUR CLIENT SECRET\"\n});\n```\n\n## And u r Ready!\n\u003chr /\u003e\n\n# Functions\n## getToken()\n\u003e Return your token information\n\n## getClip(clipURL)\n\u003e Paramaters\n- ClipURL: Twitch Clip URL\n\n\u003e Response\n- Clip Data\n\n### Example Usage\n```js\nimport Twitcher from \"twitcher\"\nlet client = new Twitcher({\n    token:\"YOUR TOKEN\",\n    client_id:\"YOUR CLIENT ID\",\n})\nlet clip = await client.getClip(\"https://clips.twitch.tv/NimbleDeadYamBIRB-drT9My-tdEwUBsZq\")\nconsole.log(clip)\n```\n\n### Example Response\n```js\n{\n  success: true,\n  streamer: {\n    id: '51950404',\n    login: 'wtcn',\n    display_name: 'wtcN',\n    type: '',\n    broadcaster_type: 'partner',\n    description: 'for business inquiries : ilaydaparlak@bigbosslayf.com',\n    profile_image_url: 'https://static-cdn.jtvnw.net/jtv_user_pictures/28b40271-8bb1-4a27-9ad7-8e9a55e06180-profile_image-300x300.png',\n    offline_image_url: 'https://static-cdn.jtvnw.net/jtv_user_pictures/dd103946-4760-46c0-8f4a-838df780baaf-channel_offline_image-1920x1080.jpeg',\n    view_count: 0,\n    created_at: '2013-11-22T07:16:15Z'\n  },\n  creator: {\n    id: '571983883',\n    login: 'gweepcreative',\n    display_name: 'GweepCreative',\n    type: '',\n    broadcaster_type: '',\n    description: 'Md. Backend Developer  //   @Discord Employee',\n    profile_image_url: 'https://static-cdn.jtvnw.net/jtv_user_pictures/f618ba01-c0cb-45b1-930d-64a01b5568c9-profile_image-300x300.png',\n    offline_image_url: 'https://static-cdn.jtvnw.net/jtv_user_pictures/fd7758e3-fdc6-4b28-9883-1da2fe560513-channel_offline_image-1920x1080.png',\n    view_count: 0,\n    created_at: '2020-08-24T06:51:19Z'\n  },\n  clip: {\n    id: 'NimbleDeadYamBIRB-drT9My-tdEwUBsZq',\n    url: 'https://clips.twitch.tv/NimbleDeadYamBIRB-drT9My-tdEwUBsZq',\n    video_url: 'https://clips-media-assets2.twitch.tv/Xmupnna0_TMvrXRMFAbGag/40984345048-offset-2692.mp4',\n    embed_url: 'https://clips.twitch.tv/embed?clip=NimbleDeadYamBIRB-drT9My-tdEwUBsZq',\n    video_id: '',\n    game_id: '516575',\n    language: 'en',\n    title: 'neeğğğğ?? (obbserver feritin aklıyla oynuyor)',\n    view_count: 230,\n    created_at: '2023-08-12T19:37:17Z',\n    thumbnail_url: 'https://clips-media-assets2.twitch.tv/Xmupnna0_TMvrXRMFAbGag/40984345048-offset-2692-preview-480x272.jpg',\n    duration: 28,\n    vod_offset: null,\n    is_featured: false\n  }\n}\n```\n\n## getGameByName(game_name)\n\u003e Paramaters\n- game_name(string): Twitch game name\n\n\u003e Response\n- Game Data\n\n### Example Usage\n```js\nimport Twitcher from \"twitcher\"\nlet client = new Twitcher({\n    token:\"YOUR TOKEN\",\n    client_id:\"YOUR CLIENT ID\",\n})\nlet game = await client.getGameByName(\"Fortnite\")\nconsole.log(game)\n```\n\n### Example Response\n```js\n{\n  success: true,\n  data: [\n    {\n      id: '33214',\n      name: 'Fortnite',\n      box_art_url: 'https://static-cdn.jtvnw.net/ttv-boxart/33214-{width}x{height}.jpg',\n      igdb_id: '1905'\n    }\n  ]\n}\n```\n\n## getGameById(game_id)\n\u003e Paramaters\n- game_id(Number): Twitch game id\n\n\u003e Response\n- Game Data\n\n### Example Usage\n```js\nimport Twitcher from \"twitcher\"\nlet client = new Twitcher({\n    token:\"YOUR TOKEN\",\n    client_id:\"YOUR CLIENT ID\",\n})\nlet game = await client.getGameById(\"509658\")\nconsole.log(game)\n```\n\n### Example Response\n```js\n{\n  success: true,\n  data: [\n    {\n      id: '509658',\n      name: 'Just Chatting',\n      box_art_url: 'https://static-cdn.jtvnw.net/ttv-boxart/509658-{width}x{height}.jpg',\n      igdb_id: ''\n    }\n  ]\n}\n```\n\n## searchChannel(query)\n\u003e Paramaters\n- query: Twitch channel name\n- type: String\n\n\u003e Response\n- Channel Data (Array)\n\n### Example Usage\n```js\nimport Twitcher from \"twitcher\"\nlet client = new Twitcher({\n    token:\"YOUR TOKEN\",\n    client_id:\"YOUR CLIENT ID\",\n})\nlet channels = await client.searchChannel(\"gweepcreative\")\nconsole.log(channels)\n```\n\n### Example Response\n```js\n[\n  {\n    broadcaster_language: 'tr',\n    broadcaster_login: 'gweepcreative',\n    display_name: 'GweepCreative',\n    game_id: '516575',\n    game_name: 'VALORANT',\n    id: '571983883',\n    is_live: false,\n    tag_ids: [],\n    tags: [ 'oyun', 'ghosts', 'valorant', 'espor', 'ESports', 'Türkçe' ],\n    thumbnail_url: 'https://static-cdn.jtvnw.net/jtv_user_pictures/f618ba01-c0cb-45b1-930d-64a01b5568c9-profile_image-300x300.png',\n    title: 'RANKED VALO',\n    started_at: ''\n  },\n  {\n    broadcaster_language: '',\n    broadcaster_login: 'gweep_creative',\n    display_name: 'gweep_creative',\n    game_id: '0',\n    game_name: '',\n    id: '606695369',\n    is_live: false,\n    tag_ids: [],\n    tags: [],\n    thumbnail_url: 'https://static-cdn.jtvnw.net/user-default-pictures-uv/ce57700a-def9-11e9-842d-784f43822e80-profile_image-300x300.png',\n    title: '',\n    started_at: ''\n  },\n  {\n    broadcaster_language: '',\n    broadcaster_login: 'gweepcreative2',\n    display_name: 'gweepcreative2',\n    game_id: '0',\n    game_name: '',\n    id: '678460694',\n    is_live: false,\n    tag_ids: [],\n    tags: [],\n    thumbnail_url: 'https://static-cdn.jtvnw.net/user-default-pictures-uv/294c98b5-e34d-42cd-a8f0-140b72fba9b0-profile_image-300x300.png',\n    title: '',\n    started_at: ''\n  },\n  {\n    broadcaster_language: '',\n    broadcaster_login: 'gweepcreative22',\n    display_name: 'gweepcreative22',\n    game_id: '0',\n    game_name: '',\n    id: '720647790',\n    is_live: false,\n    tag_ids: [],\n    tags: [],\n    thumbnail_url: 'https://static-cdn.jtvnw.net/user-default-pictures-uv/75305d54-c7cc-40d1-bb9c-91fbe85943c7-profile_image-300x300.png',\n    title: '',\n    started_at: ''\n  }\n]\n```\n\n## searchUserByName(query)\n\u003e Paramaters\n- query: Twitch channel/user name\n- type: String\n\n\u003e Response\n- Channel/User Data\n\n### Example Usage\n```js\nimport Twitcher from \"twitcher\"\nlet client = new Twitcher({\n    token:\"YOUR TOKEN\",\n    client_id:\"YOUR CLIENT ID\",\n})\nlet user = await client.searchUserByName(\"gweepcreative\")\nconsole.log(user)\n```\n\n### Example Response\n```js\n{\n  success: true,\n  data: [\n    {\n      id: '571983883',\n      login: 'gweepcreative',\n      display_name: 'GweepCreative',\n      type: '',\n      broadcaster_type: '',\n      description: 'Md. Backend Developer  //   @Discord Employee',\n      profile_image_url: 'https://static-cdn.jtvnw.net/jtv_user_pictures/f618ba01-c0cb-45b1-930d-64a01b5568c9-profile_image-300x300.png',\n      offline_image_url: 'https://static-cdn.jtvnw.net/jtv_user_pictures/fd7758e3-fdc6-4b28-9883-1da2fe560513-channel_offline_image-1920x1080.png',\n      view_count: 0,\n      created_at: '2020-08-24T06:51:19Z'\n    }\n  ]\n}\n```\n\n## searchUserByUserId(query)\n\u003e Paramaters\n- query: Twitch channel/user id\n- type: String\n\n\u003e Response\n- Channel/User Data\n\n### Example Usage\n```js\nimport Twitcher from \"twitcher\"\nlet client = new Twitcher({\n    token:\"YOUR TOKEN\",\n    client_id:\"YOUR CLIENT ID\",\n})\nlet user = await client.searchUserByUserId(\"571983883\")\nconsole.log(user)\n```\n\n### Example Response\n```js\n{\n  success: true,\n  data: [\n    {\n      id: '571983883',\n      login: 'gweepcreative',\n      display_name: 'GweepCreative',\n      type: '',\n      broadcaster_type: '',\n      description: 'Md. Backend Developer  //   @Discord Employee',\n      profile_image_url: 'https://static-cdn.jtvnw.net/jtv_user_pictures/f618ba01-c0cb-45b1-930d-64a01b5568c9-profile_image-300x300.png',\n      offline_image_url: 'https://static-cdn.jtvnw.net/jtv_user_pictures/fd7758e3-fdc6-4b28-9883-1da2fe560513-channel_offline_image-1920x1080.png',\n      view_count: 0,\n      created_at: '2020-08-24T06:51:19Z'\n    }\n  ]\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrkndev%2Ftwitcher","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrkndev%2Ftwitcher","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrkndev%2Ftwitcher/lists"}