socialcrawl-mcp 1.0.0

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 (51) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +135 -0
  3. package/dist/__tests__/client.test.d.ts +1 -0
  4. package/dist/__tests__/client.test.js +72 -0
  5. package/dist/__tests__/client.test.js.map +1 -0
  6. package/dist/__tests__/data-integrity.test.d.ts +1 -0
  7. package/dist/__tests__/data-integrity.test.js +107 -0
  8. package/dist/__tests__/data-integrity.test.js.map +1 -0
  9. package/dist/__tests__/preflight.test.d.ts +1 -0
  10. package/dist/__tests__/preflight.test.js +28 -0
  11. package/dist/__tests__/preflight.test.js.map +1 -0
  12. package/dist/__tests__/truncation.test.d.ts +1 -0
  13. package/dist/__tests__/truncation.test.js +36 -0
  14. package/dist/__tests__/truncation.test.js.map +1 -0
  15. package/dist/client.d.ts +7 -0
  16. package/dist/client.js +86 -0
  17. package/dist/client.js.map +1 -0
  18. package/dist/constants.d.ts +5 -0
  19. package/dist/constants.js +10 -0
  20. package/dist/constants.js.map +1 -0
  21. package/dist/data/docs.d.ts +3 -0
  22. package/dist/data/docs.js +2621 -0
  23. package/dist/data/docs.js.map +1 -0
  24. package/dist/data/endpoints.d.ts +4 -0
  25. package/dist/data/endpoints.js +1385 -0
  26. package/dist/data/endpoints.js.map +1 -0
  27. package/dist/data/platforms.d.ts +4 -0
  28. package/dist/data/platforms.js +135 -0
  29. package/dist/data/platforms.js.map +1 -0
  30. package/dist/index.d.ts +2 -0
  31. package/dist/index.js +82 -0
  32. package/dist/index.js.map +1 -0
  33. package/dist/schemas/tools.d.ts +29 -0
  34. package/dist/schemas/tools.js +30 -0
  35. package/dist/schemas/tools.js.map +1 -0
  36. package/dist/tools/get-docs.d.ts +1 -0
  37. package/dist/tools/get-docs.js +19 -0
  38. package/dist/tools/get-docs.js.map +1 -0
  39. package/dist/tools/list-endpoints.d.ts +1 -0
  40. package/dist/tools/list-endpoints.js +40 -0
  41. package/dist/tools/list-endpoints.js.map +1 -0
  42. package/dist/tools/list-platforms.d.ts +1 -0
  43. package/dist/tools/list-platforms.js +17 -0
  44. package/dist/tools/list-platforms.js.map +1 -0
  45. package/dist/tools/request.d.ts +7 -0
  46. package/dist/tools/request.js +43 -0
  47. package/dist/tools/request.js.map +1 -0
  48. package/dist/types.d.ts +45 -0
  49. package/dist/types.js +2 -0
  50. package/dist/types.js.map +1 -0
  51. package/package.json +55 -0
@@ -0,0 +1,1385 @@
1
+ export const ENDPOINTS = [
2
+ // --- TikTok (24 endpoints) ---
3
+ {
4
+ platform: "tiktok",
5
+ resource: "profile",
6
+ method: "GET",
7
+ params: [
8
+ { name: "handle", required: true, description: "TikTok username without the @ symbol", example: "charlidamelio" },
9
+ ],
10
+ creditTier: "standard",
11
+ creditCost: 1,
12
+ archetype: "Author",
13
+ summary: "Get TikTok user profile",
14
+ description: "Returns public profile information for a TikTok user including follower count, following count, total likes, bio, avatar URL, and verification status.",
15
+ },
16
+ {
17
+ platform: "tiktok",
18
+ resource: "profile/videos",
19
+ method: "GET",
20
+ params: [
21
+ { name: "handle", required: true, description: "TikTok username without the @ symbol", example: "charlidamelio" },
22
+ ],
23
+ creditTier: "standard",
24
+ creditCost: 1,
25
+ archetype: "PostList",
26
+ summary: "List TikTok user videos",
27
+ description: "Returns a paginated list of recent public videos posted by a TikTok user. Each video includes view count, like count, comment count, share count, caption, and thumbnail URL.",
28
+ },
29
+ {
30
+ platform: "tiktok",
31
+ resource: "post",
32
+ method: "GET",
33
+ params: [
34
+ { name: "url", required: true, description: "Full URL of the TikTok video", example: "https://www.tiktok.com/@charlidamelio/video/7321485815660738859" },
35
+ ],
36
+ creditTier: "standard",
37
+ creditCost: 1,
38
+ archetype: "Post",
39
+ summary: "Get TikTok post details",
40
+ description: "Returns detailed information about a specific TikTok video including view count, like count, comment count, share count, caption, music info, author details, and video metadata.",
41
+ },
42
+ {
43
+ platform: "tiktok",
44
+ resource: "post/comments",
45
+ method: "GET",
46
+ params: [
47
+ { name: "url", required: true, description: "Full URL of the TikTok video to fetch comments for", example: "https://www.tiktok.com/@charlidamelio/video/7321485815660738859" },
48
+ ],
49
+ creditTier: "standard",
50
+ creditCost: 1,
51
+ archetype: "CommentList",
52
+ summary: "List TikTok post comments",
53
+ description: "Returns a list of comments on a specific TikTok video. Each comment includes the author username, comment text, like count, reply count, and creation timestamp.",
54
+ },
55
+ {
56
+ platform: "tiktok",
57
+ resource: "search",
58
+ method: "GET",
59
+ params: [
60
+ { name: "query", required: true, description: "Search keyword or phrase to find TikTok videos", example: "cooking recipes" },
61
+ ],
62
+ creditTier: "standard",
63
+ creditCost: 1,
64
+ archetype: "PostList",
65
+ summary: "Search TikTok videos by keyword",
66
+ description: "Searches TikTok for videos matching a keyword query. Returns a list of matching videos with view counts, like counts, captions, author info, and thumbnails.",
67
+ },
68
+ {
69
+ platform: "tiktok",
70
+ resource: "trending",
71
+ method: "GET",
72
+ params: [
73
+ { name: "region", required: true, description: "ISO 3166-1 alpha-2 country code (e.g., US, GB, KR)", example: "US" },
74
+ ],
75
+ creditTier: "advanced",
76
+ creditCost: 5,
77
+ archetype: "PostList",
78
+ summary: "Get TikTok trending feed",
79
+ description: "Returns trending videos for a specific region. Each video includes view count, like count, caption, author info, and thumbnail.",
80
+ },
81
+ {
82
+ platform: "tiktok",
83
+ resource: "search/hashtag",
84
+ method: "GET",
85
+ params: [
86
+ { name: "hashtag", required: true, description: "Hashtag to search for without the # symbol", example: "fyp" },
87
+ ],
88
+ creditTier: "standard",
89
+ creditCost: 1,
90
+ archetype: "SearchResult",
91
+ summary: "Search TikTok by hashtag",
92
+ description: "Searches TikTok for videos under a specific hashtag. Returns matching videos with engagement metrics and author info.",
93
+ },
94
+ {
95
+ platform: "tiktok",
96
+ resource: "search/top",
97
+ method: "GET",
98
+ params: [
99
+ { name: "query", required: true, description: "Search keyword or phrase", example: "dance challenge" },
100
+ ],
101
+ creditTier: "standard",
102
+ creditCost: 1,
103
+ archetype: "SearchResult",
104
+ summary: "TikTok top search results",
105
+ description: "Returns top search results for a keyword query on TikTok, including accounts, videos, and sounds.",
106
+ },
107
+ {
108
+ platform: "tiktok",
109
+ resource: "search/users",
110
+ method: "GET",
111
+ params: [
112
+ { name: "query", required: true, description: "Search keyword or phrase to find TikTok users", example: "cooking" },
113
+ ],
114
+ creditTier: "standard",
115
+ creditCost: 1,
116
+ archetype: "SearchResult",
117
+ summary: "Search TikTok users",
118
+ description: "Searches TikTok for user accounts matching a query. Returns matching profiles with follower counts and verification status.",
119
+ },
120
+ {
121
+ platform: "tiktok",
122
+ resource: "user/audience",
123
+ method: "GET",
124
+ params: [
125
+ { name: "handle", required: true, description: "TikTok username without the @ symbol", example: "charlidamelio" },
126
+ ],
127
+ creditTier: "advanced",
128
+ creditCost: 5,
129
+ archetype: "Audience",
130
+ summary: "Get TikTok user audience demographics",
131
+ description: "Returns audience demographic data for a TikTok creator including age distribution, gender split, and top countries.",
132
+ },
133
+ {
134
+ platform: "tiktok",
135
+ resource: "user/followers",
136
+ method: "GET",
137
+ params: [
138
+ { name: "handle", required: true, description: "TikTok username without the @ symbol", example: "charlidamelio" },
139
+ ],
140
+ creditTier: "standard",
141
+ creditCost: 1,
142
+ archetype: "PostList",
143
+ summary: "List TikTok user followers",
144
+ description: "Returns a list of followers for a TikTok user. Each follower includes username, display name, avatar, and follower count.",
145
+ },
146
+ {
147
+ platform: "tiktok",
148
+ resource: "user/following",
149
+ method: "GET",
150
+ params: [
151
+ { name: "handle", required: true, description: "TikTok username without the @ symbol", example: "charlidamelio" },
152
+ ],
153
+ creditTier: "standard",
154
+ creditCost: 1,
155
+ archetype: "PostList",
156
+ summary: "List TikTok user following",
157
+ description: "Returns a list of accounts that a TikTok user is following. Each account includes username, display name, avatar, and follower count.",
158
+ },
159
+ {
160
+ platform: "tiktok",
161
+ resource: "user/live",
162
+ method: "GET",
163
+ params: [
164
+ { name: "handle", required: true, description: "TikTok username without the @ symbol", example: "charlidamelio" },
165
+ ],
166
+ creditTier: "standard",
167
+ creditCost: 1,
168
+ archetype: "Analytics",
169
+ summary: "Get TikTok user live stream",
170
+ description: "Returns current live stream information for a TikTok user including viewer count, stream title, duration, and gift count.",
171
+ },
172
+ {
173
+ platform: "tiktok",
174
+ resource: "post/transcript",
175
+ method: "GET",
176
+ params: [
177
+ { name: "url", required: true, description: "Full URL of the TikTok video", example: "https://www.tiktok.com/@charlidamelio/video/7321485815660738859" },
178
+ ],
179
+ creditTier: "premium",
180
+ creditCost: 10,
181
+ archetype: "Post",
182
+ summary: "Get TikTok video transcript",
183
+ description: "Returns the transcript of a TikTok video. Supports auto-generated captions and AI-powered transcription as fallback.",
184
+ },
185
+ {
186
+ platform: "tiktok",
187
+ resource: "song",
188
+ method: "GET",
189
+ params: [
190
+ { name: "clipId", required: true, description: "TikTok sound/song clip ID", example: "7252403792087040774" },
191
+ ],
192
+ creditTier: "standard",
193
+ creditCost: 1,
194
+ archetype: "Post",
195
+ summary: "Get TikTok song details",
196
+ description: "Returns details about a specific TikTok sound/song including title, artist, duration, usage count, and cover image.",
197
+ },
198
+ {
199
+ platform: "tiktok",
200
+ resource: "song/videos",
201
+ method: "GET",
202
+ params: [
203
+ { name: "clipId", required: true, description: "TikTok sound/song clip ID", example: "7252403792087040774" },
204
+ ],
205
+ creditTier: "standard",
206
+ creditCost: 1,
207
+ archetype: "PostList",
208
+ summary: "List TikTok videos using a song",
209
+ description: "Returns videos that use a specific TikTok sound/song. Each video includes engagement metrics, author info, and caption.",
210
+ },
211
+ {
212
+ platform: "tiktok",
213
+ resource: "songs/popular",
214
+ method: "GET",
215
+ params: [],
216
+ creditTier: "advanced",
217
+ creditCost: 5,
218
+ archetype: "Analytics",
219
+ summary: "Get popular TikTok songs",
220
+ description: "Returns currently popular songs on TikTok with ranking, usage counts, artist info, and trend data.",
221
+ },
222
+ {
223
+ platform: "tiktok",
224
+ resource: "creators/popular",
225
+ method: "GET",
226
+ params: [],
227
+ creditTier: "advanced",
228
+ creditCost: 5,
229
+ archetype: "Analytics",
230
+ summary: "Get popular TikTok creators",
231
+ description: "Returns currently popular TikTok creators with follower counts, engagement rates, and content categories.",
232
+ },
233
+ {
234
+ platform: "tiktok",
235
+ resource: "hashtags/popular",
236
+ method: "GET",
237
+ params: [],
238
+ creditTier: "advanced",
239
+ creditCost: 5,
240
+ archetype: "Analytics",
241
+ summary: "Get popular TikTok hashtags",
242
+ description: "Returns currently trending hashtags on TikTok with view counts, video counts, and trend data.",
243
+ },
244
+ {
245
+ platform: "tiktok",
246
+ resource: "videos/popular",
247
+ method: "GET",
248
+ params: [],
249
+ creditTier: "advanced",
250
+ creditCost: 5,
251
+ archetype: "Analytics",
252
+ summary: "Get popular TikTok videos",
253
+ description: "Returns currently popular TikTok videos with view counts, engagement metrics, and creator info.",
254
+ },
255
+ {
256
+ platform: "tiktok",
257
+ resource: "shop/product",
258
+ method: "GET",
259
+ params: [
260
+ { name: "url", required: true, description: "Full URL of the TikTok Shop product page", example: "https://www.tiktok.com/@shop/product/1234567890" },
261
+ ],
262
+ creditTier: "standard",
263
+ creditCost: 1,
264
+ archetype: "Post",
265
+ summary: "Get TikTok Shop product details",
266
+ description: "Returns detailed information about a TikTok Shop product including price, rating, review count, seller info, and images.",
267
+ },
268
+ {
269
+ platform: "tiktok",
270
+ resource: "shop/product/reviews",
271
+ method: "GET",
272
+ params: [
273
+ { name: "url", required: true, description: "Full URL of the TikTok Shop product page", example: "https://www.tiktok.com/@shop/product/1234567890" },
274
+ ],
275
+ creditTier: "standard",
276
+ creditCost: 1,
277
+ archetype: "CommentList",
278
+ summary: "List TikTok Shop product reviews",
279
+ description: "Returns reviews for a TikTok Shop product. Each review includes rating, text, author, and timestamp.",
280
+ },
281
+ {
282
+ platform: "tiktok",
283
+ resource: "shop/products",
284
+ method: "GET",
285
+ params: [
286
+ { name: "url", required: true, description: "Full URL of the TikTok Shop page", example: "https://www.tiktok.com/@shop/1234567890" },
287
+ ],
288
+ creditTier: "standard",
289
+ creditCost: 1,
290
+ archetype: "PostList",
291
+ summary: "List TikTok Shop products",
292
+ description: "Returns products from a TikTok Shop page including names, prices, ratings, and images.",
293
+ },
294
+ {
295
+ platform: "tiktok",
296
+ resource: "shop/search",
297
+ method: "GET",
298
+ params: [
299
+ { name: "query", required: true, description: "Search keyword or phrase to find TikTok Shop products", example: "phone case" },
300
+ ],
301
+ creditTier: "standard",
302
+ creditCost: 1,
303
+ archetype: "SearchResult",
304
+ summary: "Search TikTok Shop products",
305
+ description: "Searches TikTok Shop for products matching a query. Returns matching products with prices, ratings, and seller info.",
306
+ },
307
+ // --- Instagram (12 endpoints) ---
308
+ {
309
+ platform: "instagram",
310
+ resource: "profile",
311
+ method: "GET",
312
+ params: [
313
+ { name: "handle", required: true, description: "Instagram username without the @ symbol", example: "instagram" },
314
+ ],
315
+ creditTier: "standard",
316
+ creditCost: 1,
317
+ archetype: "Author",
318
+ summary: "Get Instagram user profile",
319
+ description: "Returns public profile information for an Instagram user including follower count, following count, post count, bio, profile picture URL, and verification status.",
320
+ },
321
+ {
322
+ platform: "instagram",
323
+ resource: "profile/posts",
324
+ method: "GET",
325
+ params: [
326
+ { name: "handle", required: true, description: "Instagram username without the @ symbol", example: "instagram" },
327
+ ],
328
+ creditTier: "standard",
329
+ creditCost: 1,
330
+ archetype: "PostList",
331
+ summary: "List Instagram user posts",
332
+ description: "Returns a list of recent posts from an Instagram user's profile. Each post includes like count, comment count, caption, media URL, media type, and timestamp.",
333
+ },
334
+ {
335
+ platform: "instagram",
336
+ resource: "post",
337
+ method: "GET",
338
+ params: [
339
+ { name: "url", required: true, description: "Full URL of the Instagram post", example: "https://www.instagram.com/p/CwA1234abcd/" },
340
+ ],
341
+ creditTier: "standard",
342
+ creditCost: 1,
343
+ archetype: "Post",
344
+ summary: "Get Instagram post details",
345
+ description: "Returns detailed information about a specific Instagram post including like count, comment count, caption, media URLs, media type, author info, and tagged users.",
346
+ },
347
+ {
348
+ platform: "instagram",
349
+ resource: "post/comments",
350
+ method: "GET",
351
+ params: [
352
+ { name: "url", required: true, description: "Full URL of the Instagram post to fetch comments for", example: "https://www.instagram.com/p/CwA1234abcd/" },
353
+ ],
354
+ creditTier: "standard",
355
+ creditCost: 1,
356
+ archetype: "CommentList",
357
+ summary: "List Instagram post comments",
358
+ description: "Returns a list of comments on a specific Instagram post. Each comment includes the author username, comment text, like count, reply count, and creation timestamp.",
359
+ },
360
+ {
361
+ platform: "instagram",
362
+ resource: "basic-profile",
363
+ method: "GET",
364
+ params: [
365
+ { name: "userId", required: true, description: "Instagram numeric user ID", example: "25025320" },
366
+ ],
367
+ creditTier: "standard",
368
+ creditCost: 1,
369
+ archetype: "Author",
370
+ summary: "Get Instagram basic profile",
371
+ description: "Returns basic public profile info for an Instagram user by user ID including username, full name, and profile picture.",
372
+ },
373
+ {
374
+ platform: "instagram",
375
+ resource: "profile/reels",
376
+ method: "GET",
377
+ params: [
378
+ { name: "handle", required: true, description: "Instagram username without the @ symbol", example: "instagram" },
379
+ ],
380
+ creditTier: "standard",
381
+ creditCost: 1,
382
+ archetype: "PostList",
383
+ summary: "List Instagram user reels",
384
+ description: "Returns a list of reels posted by an Instagram user. Each reel includes view count, like count, comment count, and thumbnail.",
385
+ },
386
+ {
387
+ platform: "instagram",
388
+ resource: "highlights",
389
+ method: "GET",
390
+ params: [
391
+ { name: "handle", required: true, description: "Instagram username without the @ symbol", example: "instagram" },
392
+ ],
393
+ creditTier: "standard",
394
+ creditCost: 1,
395
+ archetype: "PostList",
396
+ summary: "List Instagram story highlights",
397
+ description: "Returns a list of story highlight collections for an Instagram user including highlight titles, cover images, and item counts.",
398
+ },
399
+ {
400
+ platform: "instagram",
401
+ resource: "highlight/detail",
402
+ method: "GET",
403
+ params: [
404
+ { name: "id", required: true, description: "Instagram highlight ID", example: "17854360229135492" },
405
+ ],
406
+ creditTier: "standard",
407
+ creditCost: 1,
408
+ archetype: "PostList",
409
+ summary: "Get Instagram highlight detail",
410
+ description: "Returns the items within a specific Instagram story highlight including media URLs, timestamps, and interaction counts.",
411
+ },
412
+ {
413
+ platform: "instagram",
414
+ resource: "search/reels",
415
+ method: "GET",
416
+ params: [
417
+ { name: "query", required: true, description: "Search keyword or phrase to find Instagram reels", example: "workout routine" },
418
+ ],
419
+ creditTier: "standard",
420
+ creditCost: 1,
421
+ archetype: "SearchResult",
422
+ summary: "Search Instagram reels",
423
+ description: "Searches Instagram for reels matching a keyword query. Returns matching reels with view counts, like counts, and author info.",
424
+ },
425
+ {
426
+ platform: "instagram",
427
+ resource: "media/transcript",
428
+ method: "GET",
429
+ params: [
430
+ { name: "url", required: true, description: "Full URL of the Instagram video or reel", example: "https://www.instagram.com/reel/CwA1234abcd/" },
431
+ ],
432
+ creditTier: "premium",
433
+ creditCost: 10,
434
+ archetype: "Post",
435
+ summary: "Get Instagram media transcript",
436
+ description: "Returns the AI-generated transcript of an Instagram video or reel. Supports auto-generated and AI-powered transcription.",
437
+ },
438
+ {
439
+ platform: "instagram",
440
+ resource: "user/embed",
441
+ method: "GET",
442
+ params: [
443
+ { name: "handle", required: true, description: "Instagram username without the @ symbol", example: "instagram" },
444
+ ],
445
+ creditTier: "standard",
446
+ creditCost: 1,
447
+ archetype: "Author",
448
+ summary: "Get Instagram user embed HTML",
449
+ description: "Returns embeddable HTML snippet for an Instagram user profile that can be embedded on external websites.",
450
+ },
451
+ {
452
+ platform: "instagram",
453
+ resource: "song/reels",
454
+ method: "GET",
455
+ params: [
456
+ { name: "audio_id", required: true, description: "Instagram audio/song ID", example: "243313786724210" },
457
+ ],
458
+ creditTier: "standard",
459
+ creditCost: 1,
460
+ archetype: "PostList",
461
+ summary: "List Instagram reels using a song",
462
+ description: "Returns reels that use a specific audio track on Instagram. Each reel includes engagement metrics and author info.",
463
+ },
464
+ // --- YouTube (11 endpoints) ---
465
+ {
466
+ platform: "youtube",
467
+ resource: "channel",
468
+ method: "GET",
469
+ params: [
470
+ { name: "handle", required: true, description: "YouTube channel handle without the @ symbol", example: "MrBeast" },
471
+ ],
472
+ creditTier: "standard",
473
+ creditCost: 1,
474
+ archetype: "Author",
475
+ summary: "Get YouTube channel info",
476
+ description: "Returns public channel information for a YouTube channel including subscriber count, total video count, total view count, channel description, banner URL, and avatar URL.",
477
+ },
478
+ {
479
+ platform: "youtube",
480
+ resource: "channel/videos",
481
+ method: "GET",
482
+ params: [
483
+ { name: "handle", required: true, description: "YouTube channel handle without the @ symbol", example: "MrBeast" },
484
+ ],
485
+ creditTier: "standard",
486
+ creditCost: 1,
487
+ archetype: "PostList",
488
+ summary: "List YouTube channel videos",
489
+ description: "Returns a list of recent videos published by a YouTube channel. Each video includes title, view count, like count, comment count, duration, thumbnail URL, and publish date.",
490
+ },
491
+ {
492
+ platform: "youtube",
493
+ resource: "video",
494
+ method: "GET",
495
+ params: [
496
+ { name: "url", required: true, description: "Full URL of the YouTube video", example: "https://www.youtube.com/watch?v=dQw4w9WgXcQ" },
497
+ ],
498
+ creditTier: "standard",
499
+ creditCost: 1,
500
+ archetype: "Post",
501
+ summary: "Get YouTube video details",
502
+ description: "Returns detailed information about a specific YouTube video including title, view count, like count, comment count, description, tags, duration, channel info, and publish date.",
503
+ },
504
+ {
505
+ platform: "youtube",
506
+ resource: "video/comments",
507
+ method: "GET",
508
+ params: [
509
+ { name: "url", required: true, description: "Full URL of the YouTube video to fetch comments for", example: "https://www.youtube.com/watch?v=dQw4w9WgXcQ" },
510
+ ],
511
+ creditTier: "standard",
512
+ creditCost: 1,
513
+ archetype: "CommentList",
514
+ summary: "List YouTube video comments",
515
+ description: "Returns a list of comments on a specific YouTube video. Each comment includes the author name, comment text, like count, reply count, and publish timestamp.",
516
+ },
517
+ {
518
+ platform: "youtube",
519
+ resource: "search",
520
+ method: "GET",
521
+ params: [
522
+ { name: "query", required: true, description: "Search keyword or phrase to find YouTube videos", example: "javascript tutorial" },
523
+ ],
524
+ creditTier: "standard",
525
+ creditCost: 1,
526
+ archetype: "SearchResult",
527
+ summary: "Search YouTube videos",
528
+ description: "Searches YouTube for videos matching a keyword query. Returns a list of matching videos with titles, view counts, channel names, thumbnails, and publish dates.",
529
+ },
530
+ {
531
+ platform: "youtube",
532
+ resource: "channel/shorts",
533
+ method: "GET",
534
+ params: [
535
+ { name: "handle", required: true, description: "YouTube channel handle without the @ symbol", example: "MrBeast" },
536
+ ],
537
+ creditTier: "standard",
538
+ creditCost: 1,
539
+ archetype: "PostList",
540
+ summary: "List YouTube channel shorts",
541
+ description: "Returns a list of YouTube Shorts published by a channel. Each short includes view count, like count, title, and thumbnail.",
542
+ },
543
+ {
544
+ platform: "youtube",
545
+ resource: "community-post",
546
+ method: "GET",
547
+ params: [
548
+ { name: "url", required: true, description: "Full URL of the YouTube community post", example: "https://www.youtube.com/post/UgkxCWeKpIOHLknREsNOF9M_aqz4fKkCERjP" },
549
+ ],
550
+ creditTier: "standard",
551
+ creditCost: 1,
552
+ archetype: "Post",
553
+ summary: "Get YouTube community post",
554
+ description: "Returns details of a YouTube community post including text content, like count, comment count, images, and author info.",
555
+ },
556
+ {
557
+ platform: "youtube",
558
+ resource: "playlist",
559
+ method: "GET",
560
+ params: [
561
+ { name: "playlist_id", required: true, description: "YouTube playlist ID", example: "PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf" },
562
+ ],
563
+ creditTier: "standard",
564
+ creditCost: 1,
565
+ archetype: "PostList",
566
+ summary: "Get YouTube playlist",
567
+ description: "Returns videos in a YouTube playlist including titles, view counts, durations, thumbnails, and channel info.",
568
+ },
569
+ {
570
+ platform: "youtube",
571
+ resource: "search/hashtag",
572
+ method: "GET",
573
+ params: [
574
+ { name: "hashtag", required: true, description: "Hashtag to search for without the # symbol", example: "shorts" },
575
+ ],
576
+ creditTier: "standard",
577
+ creditCost: 1,
578
+ archetype: "SearchResult",
579
+ summary: "Search YouTube by hashtag",
580
+ description: "Searches YouTube for videos under a specific hashtag. Returns matching videos with view counts, channel info, and publish dates.",
581
+ },
582
+ {
583
+ platform: "youtube",
584
+ resource: "shorts/trending",
585
+ method: "GET",
586
+ params: [],
587
+ creditTier: "advanced",
588
+ creditCost: 5,
589
+ archetype: "PostList",
590
+ summary: "Get trending YouTube shorts",
591
+ description: "Returns currently trending YouTube Shorts with view counts, like counts, channel info, and thumbnails.",
592
+ },
593
+ {
594
+ platform: "youtube",
595
+ resource: "video/transcript",
596
+ method: "GET",
597
+ params: [
598
+ { name: "url", required: true, description: "Full URL of the YouTube video", example: "https://www.youtube.com/watch?v=dQw4w9WgXcQ" },
599
+ ],
600
+ creditTier: "premium",
601
+ creditCost: 10,
602
+ archetype: "Post",
603
+ summary: "Get YouTube video transcript",
604
+ description: "Returns the transcript of a YouTube video with timestamped text segments. Supports multiple languages.",
605
+ },
606
+ // --- Facebook (12 endpoints) ---
607
+ {
608
+ platform: "facebook",
609
+ resource: "profile",
610
+ method: "GET",
611
+ params: [
612
+ { name: "url", required: true, description: "Full URL of the Facebook page or profile", example: "https://www.facebook.com/Meta" },
613
+ ],
614
+ creditTier: "standard",
615
+ creditCost: 1,
616
+ archetype: "Author",
617
+ summary: "Get Facebook page profile",
618
+ description: "Returns public profile information for a Facebook page or user including name, follower count, like count, category, about text, profile picture URL, and cover photo URL.",
619
+ },
620
+ {
621
+ platform: "facebook",
622
+ resource: "profile/posts",
623
+ method: "GET",
624
+ params: [
625
+ { name: "url", required: true, description: "Full URL of the Facebook page or profile to fetch posts for", example: "https://www.facebook.com/Meta" },
626
+ ],
627
+ creditTier: "standard",
628
+ creditCost: 1,
629
+ archetype: "PostList",
630
+ summary: "List Facebook page posts",
631
+ description: "Returns a list of recent posts from a Facebook page or profile. Each post includes the post text, like count, comment count, share count, media attachments, and publish timestamp.",
632
+ },
633
+ {
634
+ platform: "facebook",
635
+ resource: "post",
636
+ method: "GET",
637
+ params: [
638
+ { name: "url", required: true, description: "Full URL of the Facebook post", example: "https://www.facebook.com/Meta/posts/1234567890" },
639
+ ],
640
+ creditTier: "standard",
641
+ creditCost: 1,
642
+ archetype: "Post",
643
+ summary: "Get Facebook post details",
644
+ description: "Returns detailed information about a specific Facebook post including the post text, like count, comment count, share count, reactions breakdown, media attachments, and author info.",
645
+ },
646
+ {
647
+ platform: "facebook",
648
+ resource: "post/comments",
649
+ method: "GET",
650
+ params: [
651
+ { name: "url", required: true, description: "Full URL of the Facebook post to fetch comments for", example: "https://www.facebook.com/Meta/posts/1234567890" },
652
+ ],
653
+ creditTier: "standard",
654
+ creditCost: 1,
655
+ archetype: "CommentList",
656
+ summary: "List Facebook post comments",
657
+ description: "Returns a list of comments on a specific Facebook post. Each comment includes the author name, comment text, like count, reply count, and creation timestamp.",
658
+ },
659
+ {
660
+ platform: "facebook",
661
+ resource: "group/posts",
662
+ method: "GET",
663
+ params: [
664
+ { name: "url", required: true, description: "Full URL of the Facebook group", example: "https://www.facebook.com/groups/reactjs/" },
665
+ ],
666
+ creditTier: "standard",
667
+ creditCost: 1,
668
+ archetype: "PostList",
669
+ summary: "List Facebook group posts",
670
+ description: "Returns recent posts from a Facebook group. Each post includes text, reaction count, comment count, shares, and author info.",
671
+ },
672
+ {
673
+ platform: "facebook",
674
+ resource: "post/transcript",
675
+ method: "GET",
676
+ params: [
677
+ { name: "url", required: true, description: "Full URL of the Facebook video post", example: "https://www.facebook.com/Meta/videos/1234567890" },
678
+ ],
679
+ creditTier: "premium",
680
+ creditCost: 10,
681
+ archetype: "Post",
682
+ summary: "Get Facebook video transcript",
683
+ description: "Returns the transcript of a Facebook video post. Supports auto-generated captions.",
684
+ },
685
+ {
686
+ platform: "facebook",
687
+ resource: "profile/photos",
688
+ method: "GET",
689
+ params: [
690
+ { name: "url", required: true, description: "Full URL of the Facebook page or profile", example: "https://www.facebook.com/Meta" },
691
+ ],
692
+ creditTier: "standard",
693
+ creditCost: 1,
694
+ archetype: "PostList",
695
+ summary: "List Facebook profile photos",
696
+ description: "Returns photos from a Facebook page or profile. Each photo includes image URL, caption, reaction count, and comment count.",
697
+ },
698
+ {
699
+ platform: "facebook",
700
+ resource: "profile/reels",
701
+ method: "GET",
702
+ params: [
703
+ { name: "url", required: true, description: "Full URL of the Facebook page or profile", example: "https://www.facebook.com/Meta" },
704
+ ],
705
+ creditTier: "standard",
706
+ creditCost: 1,
707
+ archetype: "PostList",
708
+ summary: "List Facebook profile reels",
709
+ description: "Returns reels from a Facebook page or profile. Each reel includes view count, reaction count, comment count, and thumbnail.",
710
+ },
711
+ {
712
+ platform: "facebook",
713
+ resource: "adlibrary/ad",
714
+ method: "GET",
715
+ params: [
716
+ { name: "id", required: true, description: "Facebook Ad Library ad ID", example: "23851234567890123" },
717
+ ],
718
+ creditTier: "advanced",
719
+ creditCost: 5,
720
+ archetype: "Post",
721
+ summary: "Get Facebook Ad Library ad details",
722
+ description: "Returns detailed information about a specific ad from the Facebook Ad Library including creative, spend, impressions, and targeting.",
723
+ },
724
+ {
725
+ platform: "facebook",
726
+ resource: "adlibrary/company/ads",
727
+ method: "GET",
728
+ params: [
729
+ { name: "pageId", required: true, description: "Facebook page ID of the advertiser", example: "20531316728" },
730
+ ],
731
+ creditTier: "advanced",
732
+ creditCost: 5,
733
+ archetype: "PostList",
734
+ summary: "List Facebook Ad Library company ads",
735
+ description: "Returns ads from a specific company/page in the Facebook Ad Library. Each ad includes creative, status, spend, and targeting info.",
736
+ },
737
+ {
738
+ platform: "facebook",
739
+ resource: "adlibrary/search/ads",
740
+ method: "GET",
741
+ params: [
742
+ { name: "query", required: true, description: "Search keyword or phrase to find ads in the Facebook Ad Library", example: "artificial intelligence" },
743
+ ],
744
+ creditTier: "advanced",
745
+ creditCost: 5,
746
+ archetype: "SearchResult",
747
+ summary: "Search Facebook Ad Library",
748
+ description: "Searches the Facebook Ad Library for ads matching a keyword. Returns matching ads with creative text, images, sponsor info, and status.",
749
+ },
750
+ {
751
+ platform: "facebook",
752
+ resource: "adlibrary/search/companies",
753
+ method: "GET",
754
+ params: [
755
+ { name: "query", required: true, description: "Search keyword or phrase to find companies in the Facebook Ad Library", example: "Nike" },
756
+ ],
757
+ creditTier: "advanced",
758
+ creditCost: 5,
759
+ archetype: "SearchResult",
760
+ summary: "Search Facebook Ad Library companies",
761
+ description: "Searches for companies/pages in the Facebook Ad Library. Returns matching pages with active ad counts and page details.",
762
+ },
763
+ // --- Twitter (6 endpoints) ---
764
+ {
765
+ platform: "twitter",
766
+ resource: "profile",
767
+ method: "GET",
768
+ params: [
769
+ { name: "handle", required: true, description: "Twitter username without the @ symbol", example: "elonmusk" },
770
+ ],
771
+ creditTier: "standard",
772
+ creditCost: 1,
773
+ archetype: "Author",
774
+ summary: "Get Twitter user profile",
775
+ description: "Returns public profile information for a Twitter/X user including follower count, following count, tweet count, bio, profile image URL, banner URL, and verification status.",
776
+ },
777
+ {
778
+ platform: "twitter",
779
+ resource: "user/tweets",
780
+ method: "GET",
781
+ params: [
782
+ { name: "handle", required: true, description: "Twitter username without the @ symbol", example: "elonmusk" },
783
+ ],
784
+ creditTier: "standard",
785
+ creditCost: 1,
786
+ archetype: "PostList",
787
+ summary: "List Twitter user tweets",
788
+ description: "Returns a list of recent tweets posted by a Twitter/X user. Each tweet includes the full text, like count, retweet count, reply count, media attachments, and creation timestamp.",
789
+ },
790
+ {
791
+ platform: "twitter",
792
+ resource: "tweet",
793
+ method: "GET",
794
+ params: [
795
+ { name: "url", required: true, description: "Full URL of the tweet", example: "https://x.com/elonmusk/status/1234567890" },
796
+ ],
797
+ creditTier: "standard",
798
+ creditCost: 1,
799
+ archetype: "Post",
800
+ summary: "Get Twitter tweet details",
801
+ description: "Returns detailed information about a specific tweet including the full text, like count, retweet count, reply count, quote count, media attachments, author info, and creation timestamp.",
802
+ },
803
+ {
804
+ platform: "twitter",
805
+ resource: "community",
806
+ method: "GET",
807
+ params: [
808
+ { name: "url", required: true, description: "Full URL of the Twitter/X community", example: "https://x.com/i/communities/1234567890" },
809
+ ],
810
+ creditTier: "standard",
811
+ creditCost: 1,
812
+ archetype: "Author",
813
+ summary: "Get Twitter community details",
814
+ description: "Returns information about a Twitter/X community including name, description, member count, rules, and creation date.",
815
+ },
816
+ {
817
+ platform: "twitter",
818
+ resource: "community/tweets",
819
+ method: "GET",
820
+ params: [
821
+ { name: "url", required: true, description: "Full URL of the Twitter/X community", example: "https://x.com/i/communities/1234567890" },
822
+ ],
823
+ creditTier: "standard",
824
+ creditCost: 1,
825
+ archetype: "PostList",
826
+ summary: "List Twitter community tweets",
827
+ description: "Returns recent tweets posted in a Twitter/X community. Each tweet includes text, engagement metrics, and author info.",
828
+ },
829
+ {
830
+ platform: "twitter",
831
+ resource: "tweet/transcript",
832
+ method: "GET",
833
+ params: [
834
+ { name: "url", required: true, description: "Full URL of the tweet containing a video", example: "https://x.com/elonmusk/status/1234567890" },
835
+ ],
836
+ creditTier: "premium",
837
+ creditCost: 10,
838
+ archetype: "Post",
839
+ summary: "Get Twitter video transcript",
840
+ description: "Returns the transcript of a video attached to a tweet. Supports auto-generated captions.",
841
+ },
842
+ // --- LinkedIn (6 endpoints) ---
843
+ {
844
+ platform: "linkedin",
845
+ resource: "profile",
846
+ method: "GET",
847
+ params: [
848
+ { name: "url", required: true, description: "Full URL of the LinkedIn profile page", example: "https://www.linkedin.com/in/williamhgates/" },
849
+ ],
850
+ creditTier: "standard",
851
+ creditCost: 1,
852
+ archetype: "Author",
853
+ summary: "Get LinkedIn user profile",
854
+ description: "Returns public profile information for a LinkedIn user including name, headline, summary, location, current company, education, skills, and profile picture URL.",
855
+ },
856
+ {
857
+ platform: "linkedin",
858
+ resource: "company",
859
+ method: "GET",
860
+ params: [
861
+ { name: "url", required: true, description: "Full URL of the LinkedIn company page", example: "https://www.linkedin.com/company/microsoft/" },
862
+ ],
863
+ creditTier: "standard",
864
+ creditCost: 1,
865
+ archetype: "Author",
866
+ summary: "Get LinkedIn company page",
867
+ description: "Returns public information about a LinkedIn company page including company name, description, industry, employee count, headquarters location, website, and logo URL.",
868
+ },
869
+ {
870
+ platform: "linkedin",
871
+ resource: "post",
872
+ method: "GET",
873
+ params: [
874
+ { name: "url", required: true, description: "Full URL of the LinkedIn post", example: "https://www.linkedin.com/posts/williamhgates_example-activity-1234567890" },
875
+ ],
876
+ creditTier: "standard",
877
+ creditCost: 1,
878
+ archetype: "Post",
879
+ summary: "Get LinkedIn post details",
880
+ description: "Returns detailed information about a specific LinkedIn post including the post text, like count, comment count, share count, author info, media attachments, and publish timestamp.",
881
+ },
882
+ {
883
+ platform: "linkedin",
884
+ resource: "company/posts",
885
+ method: "GET",
886
+ params: [
887
+ { name: "url", required: true, description: "Full URL of the LinkedIn company page", example: "https://www.linkedin.com/company/microsoft/" },
888
+ ],
889
+ creditTier: "standard",
890
+ creditCost: 1,
891
+ archetype: "PostList",
892
+ summary: "List LinkedIn company posts",
893
+ description: "Returns recent posts from a LinkedIn company page. Each post includes text, reaction count, comment count, and media.",
894
+ },
895
+ {
896
+ platform: "linkedin",
897
+ resource: "ad",
898
+ method: "GET",
899
+ params: [
900
+ { name: "url", required: true, description: "Full URL of the LinkedIn ad", example: "https://www.linkedin.com/ad/library/detail/12345" },
901
+ ],
902
+ creditTier: "advanced",
903
+ creditCost: 5,
904
+ archetype: "Post",
905
+ summary: "Get LinkedIn ad details",
906
+ description: "Returns detailed information about a specific LinkedIn advertisement including ad copy, sponsor info, impressions, and targeting.",
907
+ },
908
+ {
909
+ platform: "linkedin",
910
+ resource: "ads/search",
911
+ method: "GET",
912
+ params: [
913
+ { name: "company", required: true, description: "Company name or LinkedIn company page URL to search ads for", example: "Microsoft" },
914
+ ],
915
+ creditTier: "advanced",
916
+ creditCost: 5,
917
+ archetype: "SearchResult",
918
+ summary: "Search LinkedIn ads",
919
+ description: "Searches the LinkedIn Ad Library for ads by company, keyword, or filters. Returns matching ads with ad copy and sponsor info.",
920
+ },
921
+ // --- Reddit (7 endpoints) ---
922
+ {
923
+ platform: "reddit",
924
+ resource: "subreddit",
925
+ method: "GET",
926
+ params: [
927
+ { name: "subreddit", required: true, description: "Subreddit name without the r/ prefix", example: "technology" },
928
+ ],
929
+ creditTier: "standard",
930
+ creditCost: 1,
931
+ archetype: "PostList",
932
+ summary: "List Reddit subreddit posts",
933
+ description: "Returns a list of top posts from a subreddit. Each post includes the title, score, upvote ratio, comment count, author, flair, permalink, and creation timestamp.",
934
+ },
935
+ {
936
+ platform: "reddit",
937
+ resource: "subreddit/details",
938
+ method: "GET",
939
+ params: [
940
+ { name: "subreddit", required: true, description: "Subreddit name without the r/ prefix", example: "technology" },
941
+ ],
942
+ creditTier: "standard",
943
+ creditCost: 1,
944
+ archetype: "Author",
945
+ summary: "Get Reddit subreddit details",
946
+ description: "Returns detailed information about a subreddit including subscriber count, active user count, description, creation date, rules, and subreddit icon URL.",
947
+ },
948
+ {
949
+ platform: "reddit",
950
+ resource: "search",
951
+ method: "GET",
952
+ params: [
953
+ { name: "query", required: true, description: "Search keyword or phrase to find Reddit posts", example: "best programming languages 2024" },
954
+ ],
955
+ creditTier: "standard",
956
+ creditCost: 1,
957
+ archetype: "SearchResult",
958
+ summary: "Search Reddit posts",
959
+ description: "Searches Reddit for posts matching a keyword query. Returns a list of matching posts with titles, scores, comment counts, subreddit names, and permalinks.",
960
+ },
961
+ {
962
+ platform: "reddit",
963
+ resource: "post/comments",
964
+ method: "GET",
965
+ params: [
966
+ { name: "url", required: true, description: "Full URL of the Reddit post to fetch comments for", example: "https://www.reddit.com/r/technology/comments/abc123/example_post/" },
967
+ ],
968
+ creditTier: "standard",
969
+ creditCost: 1,
970
+ archetype: "CommentList",
971
+ summary: "List Reddit post comments",
972
+ description: "Returns a threaded list of comments on a specific Reddit post. Each comment includes the author, comment body, score, reply count, awards, and creation timestamp.",
973
+ },
974
+ {
975
+ platform: "reddit",
976
+ resource: "ad",
977
+ method: "GET",
978
+ params: [
979
+ { name: "id", required: true, description: "Reddit ad ID", example: "t3_abc123" },
980
+ ],
981
+ creditTier: "advanced",
982
+ creditCost: 5,
983
+ archetype: "Post",
984
+ summary: "Get Reddit ad details",
985
+ description: "Returns detailed information about a specific Reddit advertisement including ad copy, targeting, and engagement metrics.",
986
+ },
987
+ {
988
+ platform: "reddit",
989
+ resource: "ads/search",
990
+ method: "GET",
991
+ params: [
992
+ { name: "query", required: true, description: "Search keyword or phrase to find Reddit ads", example: "gaming" },
993
+ ],
994
+ creditTier: "advanced",
995
+ creditCost: 5,
996
+ archetype: "SearchResult",
997
+ summary: "Search Reddit ads",
998
+ description: "Searches Reddit's ad transparency center for ads matching a query. Returns matching ads with creative, industry, and budget info.",
999
+ },
1000
+ {
1001
+ platform: "reddit",
1002
+ resource: "subreddit/search",
1003
+ method: "GET",
1004
+ params: [
1005
+ { name: "subreddit", required: true, description: "Subreddit name without the r/ prefix", example: "technology" },
1006
+ ],
1007
+ creditTier: "standard",
1008
+ creditCost: 1,
1009
+ archetype: "SearchResult",
1010
+ summary: "Search within a subreddit",
1011
+ description: "Searches for posts within a specific subreddit. Returns matching posts with titles, scores, comment counts, and permalinks.",
1012
+ },
1013
+ // --- Threads (5 endpoints) ---
1014
+ {
1015
+ platform: "threads",
1016
+ resource: "profile",
1017
+ method: "GET",
1018
+ params: [
1019
+ { name: "handle", required: true, description: "Threads username without the @ symbol", example: "zuck" },
1020
+ ],
1021
+ creditTier: "standard",
1022
+ creditCost: 1,
1023
+ archetype: "Author",
1024
+ summary: "Get Threads user profile",
1025
+ description: "Returns public profile information for a Threads user including follower count, bio, profile picture URL, and verification status.",
1026
+ },
1027
+ {
1028
+ platform: "threads",
1029
+ resource: "user/posts",
1030
+ method: "GET",
1031
+ params: [
1032
+ { name: "handle", required: true, description: "Threads username without the @ symbol", example: "zuck" },
1033
+ ],
1034
+ creditTier: "standard",
1035
+ creditCost: 1,
1036
+ archetype: "PostList",
1037
+ summary: "List Threads user posts",
1038
+ description: "Returns a list of recent posts from a Threads user. Each post includes the text content, like count, reply count, repost count, media attachments, and creation timestamp.",
1039
+ },
1040
+ {
1041
+ platform: "threads",
1042
+ resource: "post",
1043
+ method: "GET",
1044
+ params: [
1045
+ { name: "url", required: true, description: "Full URL of the Threads post", example: "https://www.threads.net/@zuck/post/CwABCDEFGHI" },
1046
+ ],
1047
+ creditTier: "standard",
1048
+ creditCost: 1,
1049
+ archetype: "Post",
1050
+ summary: "Get Threads post details",
1051
+ description: "Returns detailed information about a specific Threads post including the text content, like count, reply count, repost count, media attachments, author info, and creation timestamp.",
1052
+ },
1053
+ {
1054
+ platform: "threads",
1055
+ resource: "search",
1056
+ method: "GET",
1057
+ params: [
1058
+ { name: "query", required: true, description: "Search keyword or phrase to find Threads posts", example: "artificial intelligence" },
1059
+ ],
1060
+ creditTier: "standard",
1061
+ creditCost: 1,
1062
+ archetype: "SearchResult",
1063
+ summary: "Search Threads posts",
1064
+ description: "Searches Threads for posts matching a keyword query. Returns a list of matching posts with text content, like counts, author info, and creation timestamps.",
1065
+ },
1066
+ {
1067
+ platform: "threads",
1068
+ resource: "search/users",
1069
+ method: "GET",
1070
+ params: [
1071
+ { name: "query", required: true, description: "Search keyword or phrase to find Threads users", example: "tech" },
1072
+ ],
1073
+ creditTier: "standard",
1074
+ creditCost: 1,
1075
+ archetype: "SearchResult",
1076
+ summary: "Search Threads users",
1077
+ description: "Searches Threads for user accounts matching a query. Returns matching profiles with follower counts and verification status.",
1078
+ },
1079
+ // --- Pinterest (4 endpoints) ---
1080
+ {
1081
+ platform: "pinterest",
1082
+ resource: "search",
1083
+ method: "GET",
1084
+ params: [
1085
+ { name: "query", required: true, description: "Search keyword or phrase to find Pinterest pins", example: "home decor ideas" },
1086
+ ],
1087
+ creditTier: "standard",
1088
+ creditCost: 1,
1089
+ archetype: "SearchResult",
1090
+ summary: "Search Pinterest pins",
1091
+ description: "Searches Pinterest for pins matching a keyword query. Returns a list of matching pins with titles, image URLs, save counts, author info, and board details.",
1092
+ },
1093
+ {
1094
+ platform: "pinterest",
1095
+ resource: "pin",
1096
+ method: "GET",
1097
+ params: [
1098
+ { name: "url", required: true, description: "Full URL of the Pinterest pin", example: "https://www.pinterest.com/pin/1234567890/" },
1099
+ ],
1100
+ creditTier: "standard",
1101
+ creditCost: 1,
1102
+ archetype: "Post",
1103
+ summary: "Get Pinterest pin details",
1104
+ description: "Returns detailed information about a specific Pinterest pin including the title, description, image URL, save count, comment count, author info, and board details.",
1105
+ },
1106
+ {
1107
+ platform: "pinterest",
1108
+ resource: "board",
1109
+ method: "GET",
1110
+ params: [
1111
+ { name: "url", required: true, description: "Full URL of the Pinterest board", example: "https://www.pinterest.com/pinterest/official-pinterest-pins/" },
1112
+ ],
1113
+ creditTier: "standard",
1114
+ creditCost: 1,
1115
+ archetype: "PostList",
1116
+ summary: "Get Pinterest board",
1117
+ description: "Returns pins from a Pinterest board. Each pin includes title, image URL, save count, and link destination.",
1118
+ },
1119
+ {
1120
+ platform: "pinterest",
1121
+ resource: "user/boards",
1122
+ method: "GET",
1123
+ params: [
1124
+ { name: "handle", required: true, description: "Pinterest username", example: "pinterest" },
1125
+ ],
1126
+ creditTier: "standard",
1127
+ creditCost: 1,
1128
+ archetype: "PostList",
1129
+ summary: "List Pinterest user boards",
1130
+ description: "Returns boards created by a Pinterest user. Each board includes title, description, pin count, and cover image.",
1131
+ },
1132
+ // --- Google (4 endpoints) ---
1133
+ {
1134
+ platform: "google",
1135
+ resource: "search",
1136
+ method: "GET",
1137
+ params: [
1138
+ { name: "query", required: true, description: "Search keyword or phrase", example: "best restaurants in London" },
1139
+ ],
1140
+ creditTier: "standard",
1141
+ creditCost: 1,
1142
+ archetype: "SearchResult",
1143
+ summary: "Google web search",
1144
+ description: "Returns Google search results for a query. Each result includes title, URL, snippet, and position.",
1145
+ },
1146
+ {
1147
+ platform: "google",
1148
+ resource: "ad",
1149
+ method: "GET",
1150
+ params: [
1151
+ { name: "url", required: true, description: "Full URL of the Google ad or Ads Transparency Center page", example: "https://adstransparency.google.com/advertiser/AR12345678901234567" },
1152
+ ],
1153
+ creditTier: "advanced",
1154
+ creditCost: 5,
1155
+ archetype: "Post",
1156
+ summary: "Get Google ad details",
1157
+ description: "Returns detailed information about a specific Google advertisement including ad copy, advertiser, and format.",
1158
+ },
1159
+ {
1160
+ platform: "google",
1161
+ resource: "adlibrary/advertisers/search",
1162
+ method: "GET",
1163
+ params: [
1164
+ { name: "query", required: true, description: "Search keyword or phrase to find advertisers in the Google Ads Transparency Center", example: "Nike" },
1165
+ ],
1166
+ creditTier: "advanced",
1167
+ creditCost: 5,
1168
+ archetype: "SearchResult",
1169
+ summary: "Search Google Ad Library advertisers",
1170
+ description: "Searches the Google Ads Transparency Center for advertisers matching a query. Returns matching advertisers with ad counts.",
1171
+ },
1172
+ {
1173
+ platform: "google",
1174
+ resource: "company/ads",
1175
+ method: "GET",
1176
+ params: [
1177
+ { name: "domain", required: true, description: "Company domain name to look up ads for", example: "nike.com" },
1178
+ ],
1179
+ creditTier: "advanced",
1180
+ creditCost: 5,
1181
+ archetype: "PostList",
1182
+ summary: "List Google ads by company",
1183
+ description: "Returns ads from a specific company/domain in the Google Ads Transparency Center. Each ad includes creative, format, and date range.",
1184
+ },
1185
+ // --- Twitch (2 endpoints) ---
1186
+ {
1187
+ platform: "twitch",
1188
+ resource: "profile",
1189
+ method: "GET",
1190
+ params: [
1191
+ { name: "handle", required: true, description: "Twitch username", example: "ninja" },
1192
+ ],
1193
+ creditTier: "standard",
1194
+ creditCost: 1,
1195
+ archetype: "Author",
1196
+ summary: "Get Twitch streamer profile",
1197
+ description: "Returns public profile information for a Twitch streamer including display name, follower count, bio, profile image URL, broadcast language, and partner/affiliate status.",
1198
+ },
1199
+ {
1200
+ platform: "twitch",
1201
+ resource: "clip",
1202
+ method: "GET",
1203
+ params: [
1204
+ { name: "url", required: true, description: "Full URL of the Twitch clip", example: "https://www.twitch.tv/ninja/clip/ExampleClipSlug" },
1205
+ ],
1206
+ creditTier: "standard",
1207
+ creditCost: 1,
1208
+ archetype: "Post",
1209
+ summary: "Get Twitch clip details",
1210
+ description: "Returns detailed information about a specific Twitch clip including the title, view count, duration, creator name, broadcaster name, game name, thumbnail URL, and creation timestamp.",
1211
+ },
1212
+ // --- Truth Social (3 endpoints) ---
1213
+ {
1214
+ platform: "truthsocial",
1215
+ resource: "profile",
1216
+ method: "GET",
1217
+ params: [
1218
+ { name: "handle", required: true, description: "Truth Social username without the @ symbol", example: "realDonaldTrump" },
1219
+ ],
1220
+ creditTier: "standard",
1221
+ creditCost: 1,
1222
+ archetype: "Author",
1223
+ summary: "Get Truth Social user profile",
1224
+ description: "Returns public profile information for a Truth Social user including display name, follower count, following count, truth count, bio, and profile image URL.",
1225
+ },
1226
+ {
1227
+ platform: "truthsocial",
1228
+ resource: "user/posts",
1229
+ method: "GET",
1230
+ params: [
1231
+ { name: "handle", required: true, description: "Truth Social username without the @ symbol", example: "realDonaldTrump" },
1232
+ ],
1233
+ creditTier: "standard",
1234
+ creditCost: 1,
1235
+ archetype: "PostList",
1236
+ summary: "List Truth Social user posts",
1237
+ description: "Returns a list of recent truths posted by a Truth Social user. Each truth includes the text content, like count, retruth count, reply count, media attachments, and creation timestamp.",
1238
+ },
1239
+ {
1240
+ platform: "truthsocial",
1241
+ resource: "post",
1242
+ method: "GET",
1243
+ params: [
1244
+ { name: "url", required: true, description: "Full URL of the Truth Social post", example: "https://truthsocial.com/@realDonaldTrump/posts/123456789" },
1245
+ ],
1246
+ creditTier: "standard",
1247
+ creditCost: 1,
1248
+ archetype: "Post",
1249
+ summary: "Get Truth Social post details",
1250
+ description: "Returns detailed information about a specific Truth Social post including the text content, like count, retruth count, reply count, media attachments, author info, and creation timestamp.",
1251
+ },
1252
+ // --- Snapchat (1 endpoint) ---
1253
+ {
1254
+ platform: "snapchat",
1255
+ resource: "profile",
1256
+ method: "GET",
1257
+ params: [
1258
+ { name: "handle", required: true, description: "Snapchat username", example: "djkhaled305" },
1259
+ ],
1260
+ creditTier: "standard",
1261
+ creditCost: 1,
1262
+ archetype: "Author",
1263
+ summary: "Get Snapchat user profile",
1264
+ description: "Returns public profile information for a Snapchat user including display name, Bitmoji avatar URL, subscriber count, and bio description.",
1265
+ },
1266
+ // --- Kick (1 endpoint) ---
1267
+ {
1268
+ platform: "kick",
1269
+ resource: "clip",
1270
+ method: "GET",
1271
+ params: [
1272
+ { name: "url", required: true, description: "Full URL of the Kick clip", example: "https://kick.com/xqc/clips/clip_abc123" },
1273
+ ],
1274
+ creditTier: "standard",
1275
+ creditCost: 1,
1276
+ archetype: "Post",
1277
+ summary: "Get Kick clip details",
1278
+ description: "Returns detailed information about a specific Kick clip including the title, view count, duration, category, creator name, channel name, thumbnail URL, and creation timestamp.",
1279
+ },
1280
+ // --- Amazon (1 endpoint) ---
1281
+ {
1282
+ platform: "amazon",
1283
+ resource: "shop",
1284
+ method: "GET",
1285
+ params: [
1286
+ { name: "url", required: true, description: "Full URL of the Amazon shop or storefront page", example: "https://www.amazon.com/shop/influencer123" },
1287
+ ],
1288
+ creditTier: "standard",
1289
+ creditCost: 1,
1290
+ archetype: "Post",
1291
+ summary: "Get Amazon shop page",
1292
+ description: "Returns product listings from an Amazon shop or storefront page including product names, prices, ratings, and images.",
1293
+ },
1294
+ // --- Utility (1 endpoint) ---
1295
+ {
1296
+ platform: "utility",
1297
+ resource: "age-gender",
1298
+ method: "GET",
1299
+ params: [
1300
+ { name: "url", required: true, description: "Direct URL of the image to analyze", example: "https://example.com/photo.jpg" },
1301
+ ],
1302
+ creditTier: "premium",
1303
+ creditCost: 10,
1304
+ archetype: "Analytics",
1305
+ summary: "Detect age and gender",
1306
+ description: "Uses AI to detect the estimated age and gender of a person from an image URL. Returns age estimate, gender, and confidence score.",
1307
+ },
1308
+ // --- Linktree (1 endpoint) ---
1309
+ {
1310
+ platform: "linktree",
1311
+ resource: "page",
1312
+ method: "GET",
1313
+ params: [
1314
+ { name: "url", required: true, description: "Full URL of the Linktree page", example: "https://linktr.ee/charlidamelio" },
1315
+ ],
1316
+ creditTier: "standard",
1317
+ creditCost: 1,
1318
+ archetype: "Author",
1319
+ summary: "Get Linktree page",
1320
+ description: "Returns data from a Linktree page including the user's display name, bio, avatar, and list of links with titles and URLs.",
1321
+ },
1322
+ // --- Linkbio (1 endpoint) ---
1323
+ {
1324
+ platform: "linkbio",
1325
+ resource: "page",
1326
+ method: "GET",
1327
+ params: [
1328
+ { name: "url", required: true, description: "Full URL of the Linkbio page", example: "https://lnk.bio/example" },
1329
+ ],
1330
+ creditTier: "standard",
1331
+ creditCost: 1,
1332
+ archetype: "Author",
1333
+ summary: "Get Linkbio page",
1334
+ description: "Returns data from a Linkbio page including display name, bio, avatar, and list of links with titles and URLs.",
1335
+ },
1336
+ // --- Linkme (1 endpoint) ---
1337
+ {
1338
+ platform: "linkme",
1339
+ resource: "page",
1340
+ method: "GET",
1341
+ params: [
1342
+ { name: "url", required: true, description: "Full URL of the Linkme page", example: "https://linkme.bio/example" },
1343
+ ],
1344
+ creditTier: "standard",
1345
+ creditCost: 1,
1346
+ archetype: "Author",
1347
+ summary: "Get Linkme profile",
1348
+ description: "Returns data from a Linkme page including display name, bio, avatar, and list of links with titles and URLs.",
1349
+ },
1350
+ // --- Komi (1 endpoint) ---
1351
+ {
1352
+ platform: "komi",
1353
+ resource: "page",
1354
+ method: "GET",
1355
+ params: [
1356
+ { name: "url", required: true, description: "Full URL of the Komi page", example: "https://komi.io/example" },
1357
+ ],
1358
+ creditTier: "standard",
1359
+ creditCost: 1,
1360
+ archetype: "Author",
1361
+ summary: "Get Komi page",
1362
+ description: "Returns data from a Komi page including display name, bio, avatar, and list of links with titles and URLs.",
1363
+ },
1364
+ // --- Pillar (1 endpoint) ---
1365
+ {
1366
+ platform: "pillar",
1367
+ resource: "page",
1368
+ method: "GET",
1369
+ params: [
1370
+ { name: "url", required: true, description: "Full URL of the Pillar page", example: "https://pillar.io/example" },
1371
+ ],
1372
+ creditTier: "standard",
1373
+ creditCost: 1,
1374
+ archetype: "Author",
1375
+ summary: "Get Pillar page",
1376
+ description: "Returns data from a Pillar page including display name, bio, avatar, and list of links with titles and URLs.",
1377
+ },
1378
+ ];
1379
+ export function findEndpoint(platform, resource) {
1380
+ return ENDPOINTS.find((e) => e.platform === platform && e.resource === resource);
1381
+ }
1382
+ export function getEndpointsByPlatform(platform) {
1383
+ return ENDPOINTS.filter((e) => e.platform === platform);
1384
+ }
1385
+ //# sourceMappingURL=endpoints.js.map