socialtap 1.559.31 → 1.569.31

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.
package/README.md CHANGED
@@ -5,7 +5,7 @@
5
5
  SocialTap is the social media scraper API for developers and AI agents. Send a public link, a handle or a search and get live data back in one schema. Failed requests are free.
6
6
 
7
7
  The TypeScript SDK for the SocialTap API: a method for every endpoint, typed models and errors, retries and pagination.
8
- Generated from the SocialTap catalog (version 1.559.31). Docs: https://socialtap.dev/docs.
8
+ Generated from the SocialTap catalog (version 1.569.31). Docs: https://socialtap.dev/docs.
9
9
 
10
10
  ## Install
11
11
 
@@ -337,13 +337,21 @@ Every result also carries the envelope `meta` (request ID, source, cache status,
337
337
  | `twitch.transcript` | `client.twitch.transcript.get()` | 2 credits + 2 per started minute of media |
338
338
  | `twitch.video` | `client.twitch.video.get()` | 1 credit |
339
339
  | `twitch.videos` | `client.twitch.videos.list()` | 1 credit |
340
+ | `x.comments` | `client.x.comments.list()` | 1 credit |
340
341
  | `x.community` | `client.x.community.get()` | 1 credit |
342
+ | `x.community_posts` | `client.x.communityPosts.list()` | 1 credit |
343
+ | `x.engagement` | `client.x.engagement.get()` | 1 credit |
344
+ | `x.list` | `client.x.list.get()` | 1 credit |
345
+ | `x.list_followers` | `client.x.listFollowers.list()` | 1 credit |
341
346
  | `x.post` | `client.x.post.get()` | 1 credit |
347
+ | `x.posts` | `client.x.posts.list()` | 1 credit |
342
348
  | `x.profile` | `client.x.profile.get()` | 1 credit |
349
+ | `x.profile_mentions` | `client.x.profileMentions.list()` | 1 credit |
343
350
  | `x.search_communities` | `client.x.searchCommunities.list()` | 1 credit + 1 per result filled in |
344
351
  | `x.search_hashtags` | `client.x.searchHashtags.list()` | 1 credit |
345
352
  | `x.search_posts` | `client.x.searchPosts.list()` | 1 credit + 1 per result filled in |
346
353
  | `x.search_profiles` | `client.x.searchProfiles.list()` | 1 credit + 1 per result filled in |
354
+ | `x.transcript` | `client.x.transcript.get()` | 1 credit (captions) or 2 credits + 2 per started minute of media (speech-to-text) |
347
355
  | `youtube.comments` | `client.youtube.comments.list()` | 1 credit |
348
356
  | `youtube.engagement` | `client.youtube.engagement.get()` | 1 credit |
349
357
  | `youtube.post` | `client.youtube.post.get()` | 1 credit |
@@ -415,7 +423,7 @@ try {
415
423
  Retryable failures (the codes above, connection errors, timeouts) are retried 2 times by default with
416
424
  exponential backoff and jitter, honoring `retry-after`. A GET retry sends `max_age` set to the seconds since the first
417
425
  attempt: if the first response was lost in transit, the retry is served free from the cache. Timeouts are per
418
- attempt: 60 s by default, and 300 s for endpoints that may transcribe audio (`facebook.ad_transcript`, `facebook.transcript`, `instagram.transcript`, `kick.transcript`, `linkedin.transcript`, `reddit.transcript`, `rumble.transcript`, `tiktok.transcript`, `twitch.transcript`, `youtube.transcript`), because speech-to-text on long
426
+ attempt: 60 s by default, and 300 s for endpoints that may transcribe audio (`facebook.ad_transcript`, `facebook.transcript`, `instagram.transcript`, `kick.transcript`, `linkedin.transcript`, `reddit.transcript`, `rumble.transcript`, `tiktok.transcript`, `twitch.transcript`, `x.transcript`, `youtube.transcript`), because speech-to-text on long
419
427
  media takes minutes, and for create-and-wait's long-polls. Most requests answer in a few seconds. A timeout you set, on the client or on one request,
420
428
  applies to every endpoint, and so does `maxRetries`.
421
429
 
@@ -560,6 +568,7 @@ console.log(r.isError, r.output);
560
568
  | `list_playlist_tracks` | Playlist tracks |
561
569
  | `list_podcast_episodes` | Podcast episodes |
562
570
  | `list_post_reposts` | Post reposts |
571
+ | `list_profile_mentions` | Profile mentions |
563
572
  | `list_shop_posts` | Shop posts of a profile |
564
573
  | `list_tracks` | Tracks of a profile |
565
574
  | `list_videos` | Videos of a profile |
@@ -568,6 +577,7 @@ console.log(r.isError, r.output);
568
577
  | `list_following` | Following of a profile |
569
578
  | `list_followers` | Followers of a profile |
570
579
  | `list_employees` | Employees of a profile |
580
+ | `list_playlist_followers` | Playlist followers |
571
581
  | `list_post_reactions` | Post reactions |
572
582
  | `list_repository_contributors` | Repository contributors |
573
583
  | `list_similar_profiles` | Similar profiles of a profile |
@@ -583,9 +593,9 @@ console.log(r.isError, r.output);
583
593
  | `get_hashtag` | Hashtag by link |
584
594
  | `list_trending_hashtags` | Trending hashtags |
585
595
  | `get_community` | Community by link |
596
+ | `get_playlist` | Playlist by link |
586
597
  | `get_product` | Product by link |
587
598
  | `get_album` | Album by link |
588
- | `get_playlist` | Playlist by link |
589
599
  | `get_sound` | Sound by link |
590
600
  | `get_topic` | Topic by link |
591
601
  | `get_contributions` | Contributions by handle |
package/dist/client.d.ts CHANGED
@@ -7,21 +7,21 @@ import { Webhooks } from "./webhooks.ts";
7
7
  * SocialTap is the social media scraper API for developers and AI agents. Send a public link, a handle or a
8
8
  * search and get live data back in one schema. Failed requests are free. Available now: activity on GitHub; ads
9
9
  * on Facebook, Google, LinkedIn and TikTok; albums on Apple Music and Spotify; comments on Bluesky, Facebook,
10
- * GitHub, Instagram, LinkedIn, Reddit, Rumble, Snapchat, Threads, TikTok and YouTube; communities on Facebook,
11
- * LinkedIn, Reddit and X; contribution calendars on GitHub; downloads on TikTok; effects on TikTok; embeds on
12
- * Instagram; engagement stats on Facebook, Instagram, LinkedIn, Reddit, Rumble, TikTok and YouTube; events on
13
- * Facebook; hashtags on Instagram and TikTok; issues on GitHub; jobs on LinkedIn; livestreams on TikTok and
14
- * Twitch; offers on Amazon; places on Facebook and Instagram; playlists on Amazon, Apple Music, Instagram,
15
- * Pinterest, Spotify and TikTok; podcasts on Spotify; posts on Amazon, Apple Music, Bluesky, Facebook,
16
- * Instagram, Kick, Kwai, LinkedIn, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads,
17
- * TikTok, Truth Social, Twitch, X and YouTube; products on Amazon, Facebook and TikTok Shop; profiles on Amazon,
18
- * Apple Music, Bluesky, Facebook, GitHub, Google, Instagram, Komi, Kwai, LinkedIn, Linkme, Linktree, Lnk.Bio,
19
- * Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social,
20
- * Twitch, X and YouTube; readmes on GitHub; releases on GitHub; repositories on GitHub; reviews on Amazon and
21
- * TikTok Shop; sounds on Instagram and TikTok; suggestions on Google, Instagram and TikTok; topics on Instagram
22
- * and Pinterest; transcripts on Facebook, Instagram, Kick, LinkedIn, Reddit, Rumble, TikTok, Twitch and YouTube;
23
- * trends on Pinterest; usernames on Instagram; web pages on Pinterest; web results on Facebook, Instagram,
24
- * LinkedIn, Telegram, TikTok and X.
10
+ * GitHub, Instagram, LinkedIn, Reddit, Rumble, Snapchat, Threads, TikTok, X and YouTube; communities on
11
+ * Facebook, LinkedIn, Reddit and X; contribution calendars on GitHub; downloads on TikTok; effects on TikTok;
12
+ * embeds on Instagram; engagement stats on Facebook, Instagram, LinkedIn, Reddit, Rumble, TikTok, X and YouTube;
13
+ * events on Facebook; hashtags on Instagram and TikTok; issues on GitHub; jobs on LinkedIn; livestreams on
14
+ * TikTok and Twitch; offers on Amazon; places on Facebook and Instagram; playlists on Amazon, Apple Music,
15
+ * Instagram, Pinterest, Spotify, TikTok and X; podcasts on Spotify; posts on Amazon, Apple Music, Bluesky,
16
+ * Facebook, Instagram, Kick, Kwai, LinkedIn, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram,
17
+ * Threads, TikTok, Truth Social, Twitch, X and YouTube; products on Amazon, Facebook and TikTok Shop; profiles
18
+ * on Amazon, Apple Music, Bluesky, Facebook, GitHub, Google, Instagram, Komi, Kwai, LinkedIn, Linkme, Linktree,
19
+ * Lnk.Bio, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth
20
+ * Social, Twitch, X and YouTube; readmes on GitHub; releases on GitHub; repositories on GitHub; reviews on
21
+ * Amazon and TikTok Shop; sounds on Instagram and TikTok; suggestions on Google, Instagram and TikTok; topics on
22
+ * Instagram and Pinterest; transcripts on Facebook, Instagram, Kick, LinkedIn, Reddit, Rumble, TikTok, Twitch, X
23
+ * and YouTube; trends on Pinterest; usernames on Instagram; web pages on Pinterest; web results on Facebook,
24
+ * Instagram, LinkedIn, Telegram, TikTok and X.
25
25
  */
26
26
  export declare class SocialTap extends Core {
27
27
  /** Amazon endpoints. */
package/dist/client.js CHANGED
@@ -8,21 +8,21 @@ import { Webhooks } from "./webhooks.js";
8
8
  * SocialTap is the social media scraper API for developers and AI agents. Send a public link, a handle or a
9
9
  * search and get live data back in one schema. Failed requests are free. Available now: activity on GitHub; ads
10
10
  * on Facebook, Google, LinkedIn and TikTok; albums on Apple Music and Spotify; comments on Bluesky, Facebook,
11
- * GitHub, Instagram, LinkedIn, Reddit, Rumble, Snapchat, Threads, TikTok and YouTube; communities on Facebook,
12
- * LinkedIn, Reddit and X; contribution calendars on GitHub; downloads on TikTok; effects on TikTok; embeds on
13
- * Instagram; engagement stats on Facebook, Instagram, LinkedIn, Reddit, Rumble, TikTok and YouTube; events on
14
- * Facebook; hashtags on Instagram and TikTok; issues on GitHub; jobs on LinkedIn; livestreams on TikTok and
15
- * Twitch; offers on Amazon; places on Facebook and Instagram; playlists on Amazon, Apple Music, Instagram,
16
- * Pinterest, Spotify and TikTok; podcasts on Spotify; posts on Amazon, Apple Music, Bluesky, Facebook,
17
- * Instagram, Kick, Kwai, LinkedIn, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads,
18
- * TikTok, Truth Social, Twitch, X and YouTube; products on Amazon, Facebook and TikTok Shop; profiles on Amazon,
19
- * Apple Music, Bluesky, Facebook, GitHub, Google, Instagram, Komi, Kwai, LinkedIn, Linkme, Linktree, Lnk.Bio,
20
- * Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth Social,
21
- * Twitch, X and YouTube; readmes on GitHub; releases on GitHub; repositories on GitHub; reviews on Amazon and
22
- * TikTok Shop; sounds on Instagram and TikTok; suggestions on Google, Instagram and TikTok; topics on Instagram
23
- * and Pinterest; transcripts on Facebook, Instagram, Kick, LinkedIn, Reddit, Rumble, TikTok, Twitch and YouTube;
24
- * trends on Pinterest; usernames on Instagram; web pages on Pinterest; web results on Facebook, Instagram,
25
- * LinkedIn, Telegram, TikTok and X.
11
+ * GitHub, Instagram, LinkedIn, Reddit, Rumble, Snapchat, Threads, TikTok, X and YouTube; communities on
12
+ * Facebook, LinkedIn, Reddit and X; contribution calendars on GitHub; downloads on TikTok; effects on TikTok;
13
+ * embeds on Instagram; engagement stats on Facebook, Instagram, LinkedIn, Reddit, Rumble, TikTok, X and YouTube;
14
+ * events on Facebook; hashtags on Instagram and TikTok; issues on GitHub; jobs on LinkedIn; livestreams on
15
+ * TikTok and Twitch; offers on Amazon; places on Facebook and Instagram; playlists on Amazon, Apple Music,
16
+ * Instagram, Pinterest, Spotify, TikTok and X; podcasts on Spotify; posts on Amazon, Apple Music, Bluesky,
17
+ * Facebook, Instagram, Kick, Kwai, LinkedIn, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram,
18
+ * Threads, TikTok, Truth Social, Twitch, X and YouTube; products on Amazon, Facebook and TikTok Shop; profiles
19
+ * on Amazon, Apple Music, Bluesky, Facebook, GitHub, Google, Instagram, Komi, Kwai, LinkedIn, Linkme, Linktree,
20
+ * Lnk.Bio, Pillar, Pinterest, Reddit, Rumble, Snapchat, SoundCloud, Spotify, Telegram, Threads, TikTok, Truth
21
+ * Social, Twitch, X and YouTube; readmes on GitHub; releases on GitHub; repositories on GitHub; reviews on
22
+ * Amazon and TikTok Shop; sounds on Instagram and TikTok; suggestions on Google, Instagram and TikTok; topics on
23
+ * Instagram and Pinterest; transcripts on Facebook, Instagram, Kick, LinkedIn, Reddit, Rumble, TikTok, Twitch, X
24
+ * and YouTube; trends on Pinterest; usernames on Instagram; web pages on Pinterest; web results on Facebook,
25
+ * Instagram, LinkedIn, Telegram, TikTok and X.
26
26
  */
27
27
  export class SocialTap extends Core {
28
28
  /** Amazon endpoints. */
package/dist/commands.js CHANGED
@@ -4173,6 +4173,25 @@ export const COMMANDS = [
4173
4173
  list: (c, p, o) => c.twitch.videos.list(p, o),
4174
4174
  iterate: (c, p, o) => c.twitch.videos.iterate(p, o),
4175
4175
  },
4176
+ {
4177
+ kind: "list",
4178
+ platform: "x",
4179
+ name: "comments",
4180
+ endpoint: "x.comments",
4181
+ summary: "Top replies to a post, with exact counts",
4182
+ price: "1 credit",
4183
+ params: [
4184
+ { name: "url", type: "string", required: true, description: "X post: a link (x.com or twitter.com, /<username>/status/<id> with or without a view such as /photo/1 or a query such as ?s=20, /i/web/status/<id>, /i/status/<id>, /<username>/article/<id>, old /statuses/ and #! links, mobile.twitter.com, fxtwitter.com and vxtwitter.com) or a bare numeric post ID. At most 2048 characters. Example: https://x.com/WhiteHouse/status/2119797490375606752" },
4185
+ { name: "since", type: "string", required: false, description: "Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC). On newest-first lists, paging stops when it is reached, so later pages are not fetched or charged. Example: 2026-10-01" },
4186
+ { name: "until", type: "string", required: false, description: "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). Example: 2026-10-08" },
4187
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
4188
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
4189
+ { name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 20. Default: 20." },
4190
+ { name: "cursor", type: "string", required: false, description: "page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page." },
4191
+ ],
4192
+ list: (c, p, o) => c.x.comments.list(p, o),
4193
+ iterate: (c, p, o) => c.x.comments.iterate(p, o),
4194
+ },
4176
4195
  {
4177
4196
  kind: "get",
4178
4197
  platform: "x",
@@ -4187,6 +4206,71 @@ export const COMMANDS = [
4187
4206
  ],
4188
4207
  get: (c, p, o) => c.x.community.get(p, o),
4189
4208
  },
4209
+ {
4210
+ kind: "list",
4211
+ platform: "x",
4212
+ name: "community_posts",
4213
+ endpoint: "x.community_posts",
4214
+ summary: "Top posts and media with exact counts",
4215
+ price: "1 credit",
4216
+ params: [
4217
+ { name: "url", type: "string", required: true, description: "The community: its link on x.com or twitter.com (x.com/i/communities/<id>, any of its views such as /about, /latest or /media included, mobile hosts and any query too) or its numeric ID. At most 2048 characters. Example: https://x.com/i/communities/1493446837214187523" },
4218
+ { name: "media", type: "string", required: false, description: "Read the community's Media tab instead of Top: its recent posts with media. any keeps every one, image those with one or more photos, video those with a video or GIF. Top's posts when omitted. One of: any, image, video. Example: video", enum: ["any", "image", "video"] },
4219
+ { name: "since", type: "string", required: false, description: "Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC). On newest-first lists, paging stops when it is reached, so later pages are not fetched or charged. Compared with published_at, filtering the page: neither tab is in time order. Example: 2026-10-01" },
4220
+ { name: "until", type: "string", required: false, description: "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). Compared with published_at, filtering the page. Example: 2026-10-08" },
4221
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
4222
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
4223
+ { name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 30. Default: 30." },
4224
+ { name: "cursor", type: "string", required: false, description: "page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page." },
4225
+ ],
4226
+ list: (c, p, o) => c.x.communityPosts.list(p, o),
4227
+ iterate: (c, p, o) => c.x.communityPosts.iterate(p, o),
4228
+ },
4229
+ {
4230
+ kind: "get",
4231
+ platform: "x",
4232
+ name: "engagement",
4233
+ endpoint: "x.engagement",
4234
+ summary: "Engagement rate, views per post and posting cadence",
4235
+ price: "1 credit",
4236
+ params: [
4237
+ { name: "handle", type: "string", required: true, description: "X account: a username with or without the @ (NASA, @NASA), a numeric user ID (11348282), or a profile link (x.com/NASA or twitter.com/NASA, with or without a tab such as /media or /with_replies, mobile.twitter.com, x.com/i/user/11348282, a Follow-button or intent link such as x.com/intent/user?screen_name=NASA or ?user_id=11348282, with any query such as ?s=20). Usernames are case-insensitive. A bare number is a user ID; a number no account has as its ID is looked up as a username, and @ before digits (@123) always means the username. At most 2048 characters. Example: NASA" },
4238
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
4239
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
4240
+ ],
4241
+ get: (c, p, o) => c.x.engagement.get(p, o),
4242
+ },
4243
+ {
4244
+ kind: "get",
4245
+ platform: "x",
4246
+ name: "list",
4247
+ endpoint: "x.list",
4248
+ summary: "List name, owner, exact member and follower counts",
4249
+ price: "1 credit",
4250
+ params: [
4251
+ { name: "url", type: "string", required: true, description: "The List: its link on x.com or twitter.com (x.com/i/lists/<id>, any of its views such as /members or /followers, the older x.com/<owner>/lists/<name>, mobile hosts, old #! links and any query too) or its numeric ID. At most 2048 characters. Example: https://x.com/i/lists/84839422" },
4252
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
4253
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
4254
+ ],
4255
+ get: (c, p, o) => c.x.list.get(p, o),
4256
+ },
4257
+ {
4258
+ kind: "list",
4259
+ platform: "x",
4260
+ name: "list_followers",
4261
+ endpoint: "x.list_followers",
4262
+ summary: "Accounts that follow an X List, as full profiles",
4263
+ price: "1 credit",
4264
+ params: [
4265
+ { name: "url", type: "string", required: true, description: "The List: its link on x.com or twitter.com (x.com/i/lists/<id>, any of its views such as /followers or /members, the older x.com/<owner>/lists/<name>, mobile hosts, old #! links and any query too) or its numeric ID. At most 2048 characters. Example: https://x.com/i/lists/84839422" },
4266
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
4267
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
4268
+ { name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 200. Default: 200." },
4269
+ { name: "cursor", type: "string", required: false, description: "page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page." },
4270
+ ],
4271
+ list: (c, p, o) => c.x.listFollowers.list(p, o),
4272
+ iterate: (c, p, o) => c.x.listFollowers.iterate(p, o),
4273
+ },
4190
4274
  {
4191
4275
  kind: "get",
4192
4276
  platform: "x",
@@ -4201,6 +4285,27 @@ export const COMMANDS = [
4201
4285
  ],
4202
4286
  get: (c, p, o) => c.x.post.get(p, o),
4203
4287
  },
4288
+ {
4289
+ kind: "list",
4290
+ platform: "x",
4291
+ name: "posts",
4292
+ endpoint: "x.posts",
4293
+ summary: "Latest or most liked posts with exact counts",
4294
+ price: "1 credit",
4295
+ params: [
4296
+ { name: "handle", type: "string", required: true, description: "X account: a username with or without the @ (NASA, @NASA), a numeric user ID (11348282), or a profile link (x.com/NASA or twitter.com/NASA, with or without a tab such as /media, mobile.twitter.com, x.com/i/user/11348282, a Follow-button or intent link such as x.com/intent/user?screen_name=NASA). Usernames are case-insensitive. A bare number is a user ID; a number no account has as its ID is looked up as a username, and @ before digits (@123) always means the username. At most 2048 characters. Example: NASA" },
4297
+ { name: "sort", type: "string", required: false, description: "Order of the results. newest (default): the latest posts first. popular: X's selection of the account's most liked posts, about a hundred in one page, roughly most liked first. X shows a logged-out visitor one of the two for each account (see the notes), and the other is answered as closely as it can be. One of: newest, popular. Default: newest.", enum: ["newest", "popular"] },
4298
+ { name: "media", type: "string", required: false, description: "Only the account's own posts (no reposts) with media: any (a photo, video or GIF), image (one or more photos) or video (a video or GIF). All posts and reposts when omitted. A page keeps only those, so it can hold fewer items than limit. One of: any, image, video. Example: video", enum: ["any", "image", "video"] },
4299
+ { name: "since", type: "string", required: false, description: "Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC). On newest-first lists, paging stops when it is reached, so later pages are not fetched or charged. Compared with published_at. With sort=newest the walk stops once the list is older than this. Example: 2026-10-01" },
4300
+ { name: "until", type: "string", required: false, description: "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). Compared with published_at, filtering every page. Example: 2026-10-08" },
4301
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
4302
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
4303
+ { name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 100. Default: 100." },
4304
+ { name: "cursor", type: "string", required: false, description: "page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page." },
4305
+ ],
4306
+ list: (c, p, o) => c.x.posts.list(p, o),
4307
+ iterate: (c, p, o) => c.x.posts.iterate(p, o),
4308
+ },
4204
4309
  {
4205
4310
  kind: "get",
4206
4311
  platform: "x",
@@ -4215,6 +4320,25 @@ export const COMMANDS = [
4215
4320
  ],
4216
4321
  get: (c, p, o) => c.x.profile.get(p, o),
4217
4322
  },
4323
+ {
4324
+ kind: "list",
4325
+ platform: "x",
4326
+ name: "profile_mentions",
4327
+ endpoint: "x.profile_mentions",
4328
+ summary: "Posts by others that @mention an account",
4329
+ price: "1 credit",
4330
+ params: [
4331
+ { name: "handle", type: "string", required: true, description: "X account whose mentions to find: a username with or without the @ (NASA, @NASA), a numeric user ID (11348282), or a profile link (x.com/NASA or twitter.com/NASA, with or without a tab such as /media, mobile.twitter.com, x.com/i/user/11348282, an intent link such as x.com/intent/user?screen_name=NASA). Usernames are case-insensitive. A bare number is a user ID; a number no account has as its ID is read as a username. At most 2048 characters. Example: NASA" },
4332
+ { name: "since", type: "string", required: false, description: "Only items at or after this time: RFC 3339 (2026-10-01T12:00:00Z) or a date (2026-10-01, midnight UTC). On newest-first lists, paging stops when it is reached, so later pages are not fetched or charged. By the post's exact time; the search engine is asked for the same dates, so this also finds recent posts the plain ranking leaves out. A date filter narrows a ranking, not an order: results are still by relevance. Example: 2026-10-01" },
4333
+ { name: "until", type: "string", required: false, description: "Only items before this time (exclusive): RFC 3339 or a date (midnight UTC). By the post's exact time. Example: 2026-10-08" },
4334
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
4335
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
4336
+ { name: "limit", type: "integer", required: false, description: "Items per page, 1 to the endpoint's page size (its default and maximum; larger values are reduced to it). Omit it: every page costs the same, so a smaller limit means more pages to pay for. Range: 1 to 20. Default: 20." },
4337
+ { name: "cursor", type: "string", required: false, description: "page.next_cursor from the previous response. Send the same other parameters; omit to start from the first page." },
4338
+ ],
4339
+ list: (c, p, o) => c.x.profileMentions.list(p, o),
4340
+ iterate: (c, p, o) => c.x.profileMentions.iterate(p, o),
4341
+ },
4218
4342
  {
4219
4343
  kind: "list",
4220
4344
  platform: "x",
@@ -4292,6 +4416,21 @@ export const COMMANDS = [
4292
4416
  list: (c, p, o) => c.x.searchProfiles.list(p, o),
4293
4417
  iterate: (c, p, o) => c.x.searchProfiles.iterate(p, o),
4294
4418
  },
4419
+ {
4420
+ kind: "get",
4421
+ platform: "x",
4422
+ name: "transcript",
4423
+ endpoint: "x.transcript",
4424
+ summary: "Video post transcript, from captions or audio",
4425
+ price: "1 credit (captions) or 2 credits + 2 per started minute of media (speech-to-text)",
4426
+ params: [
4427
+ { name: "url", type: "string", required: true, description: "X video post: a link (x.com or twitter.com, /<username>/status/<id> with or without /video/<n>, which picks the post's nth attachment, /i/web/status/<id>, /i/status/<id>, old /statuses/ and #! links, mobile.twitter.com, fxtwitter.com and vxtwitter.com) or a bare numeric post ID. A repost transcribes the reposted video, and a quote post without a video of its own the video of the post it quotes. At most 2048 characters. Example: https://x.com/TheoVon/status/1916982720317821050" },
4428
+ { name: "lang", type: "string", required: false, description: "Preferred language: a BCP-47 tag such as en or pt-BR (case-insensitive; _ is read as -). Picks X's caption track in that language when the video has one. X captions a video in its spoken language only, so for another language you get that track, and language says which. For a video X has no captions for, it is the language speech-to-text listens for (detected without it). Example: en" },
4429
+ { name: "max_age", type: "integer", required: false, description: "Accept a cached response up to this many seconds old. Cache hits cost 0 credits. Omit to always fetch fresh. The Cache-Control: max-age=N request header is equivalent; max_age wins when both are sent. Minimum: 0." },
4430
+ { name: "fields", type: "string", required: false, description: "Return only these fields of each item: comma-separated paths in the schema's notation (id,text,metrics.view_count,segments[].text; a parent path keeps the whole object). Unknown paths are rejected. Applied after the cache, so it changes neither the price nor cache hits; page and meta are always returned whole." },
4431
+ ],
4432
+ get: (c, p, o) => c.x.transcript.get(p, o),
4433
+ },
4295
4434
  {
4296
4435
  kind: "list",
4297
4436
  platform: "youtube",
@@ -1,5 +1,5 @@
1
1
  /** SDK version: 1.<contract facts>.<generator revision> (sdk/README.md). */
2
- export declare const VERSION = "1.559.31";
2
+ export declare const VERSION = "1.569.31";
3
3
  /** The production API origin. */
4
4
  export declare const DEFAULT_BASE_URL = "https://socialtap.dev";
5
5
  /** Environment variable the API key is read from. */
package/dist/constants.js CHANGED
@@ -1,6 +1,6 @@
1
1
  // Code generated by engine/cmd/gensdk (make gen) from catalog/catalog.gen.json; DO NOT EDIT.
2
2
  /** SDK version: 1.<contract facts>.<generator revision> (sdk/README.md). */
3
- export const VERSION = "1.559.31";
3
+ export const VERSION = "1.569.31";
4
4
  /** The production API origin. */
5
5
  export const DEFAULT_BASE_URL = "https://socialtap.dev";
6
6
  /** Environment variable the API key is read from. */