@scrapecreators/cli 1.0.3 → 1.0.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/api-config/apis.js +184 -0
  2. package/package.json +1 -1
package/api-config/apis.js CHANGED
@@ -173,6 +173,190 @@ export const apis = [
173
173
  },
174
174
  ],
175
175
  },
176
+ {
177
+ name: "Channel Playlists",
178
+ method: "GET",
179
+ description:
180
+ "Get playlists from a YouTube channel. Can pass channelId or handle.",
181
+ fullDescription:
182
+ "Fetches playlists from a YouTube channel's Playlists tab, including playlist ID, title, thumbnail, video count, channel info, playlist URL, and a continuationToken when YouTube has more results. Pass a handle or channelId for the first page, then pass continuationToken to page through more playlists.",
183
+ path: "/v1/youtube/channel/playlists",
184
+ paginationField: "continuationToken",
185
+ sampleResponse: {
186
+ success: true,
187
+ credits_remaining: 100,
188
+ playlists: [
189
+ {
190
+ type: "playlist",
191
+ id: "PLoSWVnSA9vG8hI-SUpAimvYJrPh-PRRvp",
192
+ title: "If You Survive, You Win",
193
+ thumbnail:
194
+ "https://i.ytimg.com/vi/tnTPaLOaHz8/hqdefault.jpg",
195
+ playlistUrl:
196
+ "https://www.youtube.com/playlist?list=PLoSWVnSA9vG8hI-SUpAimvYJrPh-PRRvp",
197
+ videoId: "tnTPaLOaHz8",
198
+ videoUrl: "https://www.youtube.com/watch?v=tnTPaLOaHz8",
199
+ videoCount: 4,
200
+ channel: {
201
+ id: "UCX6OQ3DkcsbYNE6H8uQQuVA",
202
+ title: "MrBeast",
203
+ handle: "MrBeast",
204
+ channelUrl: "https://www.youtube.com/@MrBeast",
205
+ },
206
+ },
207
+ ],
208
+ continuationToken: "4qmFsgLlFhIYV....",
209
+ },
210
+ params: [
211
+ {
212
+ name: "channelId",
213
+ type: "string",
214
+ description: "YouTube channel ID",
215
+ placeholder: "UCX6OQ3DkcsbYNE6H8uQQuVA",
216
+ },
217
+ {
218
+ name: "handle",
219
+ type: "string",
220
+ description: "YouTube channel handle",
221
+ placeholder: "MrBeast",
222
+ },
223
+ {
224
+ name: "continuationToken",
225
+ type: "string",
226
+ required: false,
227
+ description:
228
+ "Continuation token to get more playlists. Get 'continuationToken' from previous response.",
229
+ placeholder: "4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB",
230
+ },
231
+ ],
232
+ },
233
+ {
234
+ name: "Channel Lives",
235
+ method: "GET",
236
+ description:
237
+ "Get live streams and past streams from a YouTube channel. Can pass channelId or handle.",
238
+ fullDescription:
239
+ "Fetches live streams and past streams from a YouTube channel's Live tab, including title, URL, thumbnail, view count, publish time, duration, and a continuationToken when YouTube has more results. Pass a handle or channelId for the first page, then pass continuationToken to page through more lives.",
240
+ path: "/v1/youtube/channel/lives",
241
+ paginationField: "continuationToken",
242
+ sampleResponse: {
243
+ success: true,
244
+ credits_remaining: 100,
245
+ lives: [
246
+ {
247
+ type: "live",
248
+ id: "JpVtso3S9rM",
249
+ url: "https://www.youtube.com/watch?v=JpVtso3S9rM",
250
+ title: "IShowSpeed Live Stream",
251
+ thumbnail:
252
+ "https://i.ytimg.com/vi/JpVtso3S9rM/hqdefault.jpg",
253
+ channel: {
254
+ id: null,
255
+ title: null,
256
+ handle: null,
257
+ thumbnail: null,
258
+ },
259
+ viewCountText: "1.2M views",
260
+ viewCountInt: 1200000,
261
+ publishedTimeText: "Streamed 2 days ago",
262
+ lengthText: "2:14:52",
263
+ lengthSeconds: 8092,
264
+ badges: [],
265
+ },
266
+ ],
267
+ continuationToken: "4qmFsgLlFhIYV....",
268
+ },
269
+ params: [
270
+ {
271
+ name: "channelId",
272
+ type: "string",
273
+ description: "YouTube channel ID",
274
+ placeholder: "UCWsDFcIhY2DBi3GB5uykGXA",
275
+ },
276
+ {
277
+ name: "handle",
278
+ type: "string",
279
+ description: "YouTube channel handle",
280
+ placeholder: "IShowSpeed",
281
+ },
282
+ {
283
+ name: "continuationToken",
284
+ type: "string",
285
+ required: false,
286
+ description:
287
+ "Continuation token to get more lives. Get 'continuationToken' from previous response.",
288
+ placeholder: "4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB",
289
+ },
290
+ ],
291
+ },
292
+ {
293
+ name: "Channel Community Posts",
294
+ method: "GET",
295
+ description:
296
+ "Get community posts from a YouTube channel. Can pass channelId or handle.",
297
+ fullDescription:
298
+ "Fetches community posts from a YouTube channel's Posts tab, including post ID, URL, content, images, attached video, like count, publish time, channel info, and a continuationToken when YouTube has more results. Pass a handle or channelId for the first page, then pass continuationToken to page through more posts.",
299
+ path: "/v1/youtube/channel/community-posts",
300
+ paginationField: "continuationToken",
301
+ sampleResponse: {
302
+ success: true,
303
+ credits_remaining: 100,
304
+ posts: [
305
+ {
306
+ id: "UgkxfMvMnSnV3Ww9HwAY2wFGmVevmhRaYAYO",
307
+ url: "https://www.youtube.com/post/UgkxfMvMnSnV3Ww9HwAY2wFGmVevmhRaYAYO",
308
+ channel: {
309
+ id: "UCX6OQ3DkcsbYNE6H8uQQuVA",
310
+ title: "MrBeast",
311
+ url: "https://www.youtube.com/@MrBeast",
312
+ handle: "MrBeast",
313
+ },
314
+ content: "New video is live",
315
+ image: "https://yt3.ggpht.com/example-image=s640-c-fcrop64",
316
+ images: ["https://yt3.ggpht.com/example-image=s640-c-fcrop64"],
317
+ likeCountText: "250K",
318
+ likeCount: 250000,
319
+ publishedTimeText: "2 days ago",
320
+ publishedTime: "2026-05-24T12:00:00.000Z",
321
+ video: {
322
+ id: "tnTPaLOaHz8",
323
+ title: "If You Survive, You Win",
324
+ thumbnail:
325
+ "https://i.ytimg.com/vi/tnTPaLOaHz8/hqdefault.jpg",
326
+ url: "https://www.youtube.com/watch?v=tnTPaLOaHz8",
327
+ viewCountText: "10M views",
328
+ viewCountInt: 10000000,
329
+ publishedTimeText: "2 days ago",
330
+ lengthText: "18:42",
331
+ lengthSeconds: 1122,
332
+ },
333
+ },
334
+ ],
335
+ continuationToken: "4qmFsgLlFhIYV....",
336
+ },
337
+ params: [
338
+ {
339
+ name: "channelId",
340
+ type: "string",
341
+ description: "YouTube channel ID",
342
+ placeholder: "UCX6OQ3DkcsbYNE6H8uQQuVA",
343
+ },
344
+ {
345
+ name: "handle",
346
+ type: "string",
347
+ description: "YouTube channel handle",
348
+ placeholder: "MrBeast",
349
+ },
350
+ {
351
+ name: "continuationToken",
352
+ type: "string",
353
+ required: false,
354
+ description:
355
+ "Continuation token to get more community posts. Get 'continuationToken' from previous response.",
356
+ placeholder: "4qmFsgKrCBIYVUNkRkpXVWE0M3NtUm00SXBIQnB",
357
+ },
358
+ ],
359
+ },
176
360
  {
177
361
  name: "Channel Shorts",
178
362
  method: "GET",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@scrapecreators/cli",
3
- "version": "1.0.3",
3
+ "version": "1.0.4",
4
4
  "description": "CLI for the ScrapeCreators API — scrape 27+ social media platforms from the terminal",
5
5
  "type": "module",
6
6
  "bin": {