@mentio-dev/sdk 0.11.3 → 0.12.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.
package/dist/index.d.ts CHANGED
@@ -351,6 +351,20 @@ type GroupRef = {
351
351
  */
352
352
  isDefault: boolean;
353
353
  };
354
+ type KeywordFeed = {
355
+ /**
356
+ * The feed itself (after redirects): what is polled.
357
+ */
358
+ url: string;
359
+ /**
360
+ * The feed's own title, when it has one.
361
+ */
362
+ title: string | null;
363
+ /**
364
+ * When this keyword started reading the feed: nothing published before it is a live mention.
365
+ */
366
+ connectedAt: string;
367
+ };
354
368
  type ReviewSource = {
355
369
  /**
356
370
  * appstore (Apple App Store), googleplay (Google Play), trustpilot (a company's Trustpilot page) or googlemaps (a place's Google reviews).
@@ -405,7 +419,7 @@ type Keyword = {
405
419
  */
406
420
  cap: {
407
421
  /**
408
- * Matched mentions allowed per calendar month (UTC). Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills.
422
+ * Charged items allowed per calendar month (UTC): matched mentions plus the thread comments delivered under them. Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills.
409
423
  */
410
424
  mentions: number;
411
425
  /**
@@ -417,11 +431,28 @@ type Keyword = {
417
431
  */
418
432
  own: number | null;
419
433
  } | null;
434
+ /**
435
+ * Comments under this keyword's mentions: when enabled, the comments of every mention scored relevant are read from 30 minutes after the post, on a schedule per platform (for a day on Reddit, Hacker News and Bluesky, a week on GitHub, Stack Overflow and DEV, a month on YouTube) (new comments only, at most maxPerPost a thread, comments of fewer than three words dropped), on Hacker News, Bluesky, GitHub, Stack Overflow, DEV, YouTube and Reddit. List them with GET /v1/mentions/{id}/comments.
436
+ */
437
+ comments: {
438
+ /**
439
+ * Read the comments under this keyword's relevant mentions, from 30 minutes after each post, as long as its platform's conversations last (a day to a month). Each comment delivered costs $0.008 (comments of fewer than three words are dropped, never billed) (the comments line of the bill). Off by default.
440
+ */
441
+ enabled: boolean;
442
+ /**
443
+ * The newest comments of one thread you receive, 20 by default, 100 at most: the ceiling on what one mention's comments can cost. A comment that names the keyword is a mention too, but only among these newest ones, so it is never billed past the ceiling.
444
+ */
445
+ maxPerPost: number;
446
+ };
420
447
  group: GroupRef;
421
448
  /**
422
449
  * Platforms the term is searched on; null means every platform, [] none (the keyword only collects reviews).
423
450
  */
424
451
  platforms: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram'> | null;
452
+ /**
453
+ * RSS and Atom feeds this keyword reads; empty for none.
454
+ */
455
+ feeds: Array<KeywordFeed>;
425
456
  /**
426
457
  * Where this keyword collects reviews from (App Store and Google Play apps, Trustpilot pages, Google Maps places); empty for none.
427
458
  */
@@ -458,6 +489,19 @@ type Keyword = {
458
489
  * true: only the exact phrase matches. false (default): a multi-word keyword also matches a post holding its words close together, in any order, plurals and spellings (non-profit, nonprofit) included; such a match is kept and billed only when the classifier scores it relevant. A term sent in double quotes sets this to true.
459
490
  */
460
491
  exactPhrase: boolean;
492
+ /**
493
+ * Reddit only, for this keyword alone; the workspace filters' own subreddit lists (GET /v1/filters) still apply to every keyword, and a post must pass both.
494
+ */
495
+ subreddits: {
496
+ /**
497
+ * When non-empty, this keyword takes Reddit posts from these subreddits ONLY and `excluded` is ignored. r/name or name, stored bare and lowercase.
498
+ */
499
+ only: Array<string>;
500
+ /**
501
+ * Reddit posts from these subreddits are dropped for this keyword. r/name or name.
502
+ */
503
+ excluded: Array<string>;
504
+ };
461
505
  };
462
506
  /**
463
507
  * Computed over this workspace's matches.
@@ -476,7 +520,7 @@ type Keyword = {
476
520
  */
477
521
  last7d: number;
478
522
  /**
479
- * Matches recorded this calendar month (UTC), the count a cap compares against.
523
+ * Matches recorded this calendar month (UTC), plus the thread comments delivered under this keyword's mentions: the count a cap compares against.
480
524
  */
481
525
  thisMonth: number;
482
526
  /**
@@ -538,7 +582,15 @@ type Keyword = {
538
582
  */
539
583
  mentionCents: number;
540
584
  /**
541
- * keywordCents plus mentionCents: what this keyword has cost this month, in USD cents.
585
+ * Comments billed this month under this keyword: comments delivered in its threads and comments it matched, each once per workspace.
586
+ */
587
+ billableComments: number;
588
+ /**
589
+ * Those comments at $0.008 each, rounded once on the total.
590
+ */
591
+ commentCents: number;
592
+ /**
593
+ * keywordCents plus mentionCents plus commentCents: what this keyword has cost this month, in USD cents.
542
594
  */
543
595
  totalCents: number;
544
596
  };
@@ -548,9 +600,9 @@ type Keyword = {
548
600
  */
549
601
  polling: Array<{
550
602
  /**
551
- * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place).
603
+ * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place), rss (RSS and Atom feeds a keyword reads).
552
604
  */
553
- platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
605
+ platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
554
606
  /**
555
607
  * Newest poll of this platform for the term; null until the first one.
556
608
  */
@@ -649,16 +701,42 @@ type KeywordSuggestion = {
649
701
  * true: only the exact phrase matches. false (default): a multi-word keyword also matches a post holding its words close together, in any order, plurals and spellings (non-profit, nonprofit) included; such a match is kept and billed only when the classifier scores it relevant. A term sent in double quotes sets this to true.
650
702
  */
651
703
  exactPhrase?: boolean;
704
+ /**
705
+ * Reddit only, for this keyword alone: each list is replaced when sent, kept when omitted.
706
+ */
707
+ subreddits?: {
708
+ /**
709
+ * Replaces the keyword's allowlist; [] clears it.
710
+ */
711
+ only?: Array<string>;
712
+ /**
713
+ * Replaces the keyword's deny list; [] clears it.
714
+ */
715
+ excluded?: Array<string>;
716
+ };
652
717
  };
653
718
  /**
654
719
  * Replaces the monthly mention cap; null removes it. A cap above this month's count resumes a capped keyword at once, one at or under it pauses it.
655
720
  */
656
721
  cap?: {
657
722
  /**
658
- * Matched mentions allowed per calendar month (UTC). Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills.
723
+ * Charged items allowed per calendar month (UTC): matched mentions plus the thread comments delivered under them. Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills.
659
724
  */
660
725
  mentions: number;
661
726
  } | null;
727
+ /**
728
+ * Comments under this keyword's mentions; omitted fields are untouched (on create: off, 20 per post).
729
+ */
730
+ comments?: {
731
+ /**
732
+ * Read the comments under this keyword's relevant mentions, from 30 minutes after each post, as long as its platform's conversations last (a day to a month). Each comment delivered costs $0.008 (comments of fewer than three words are dropped, never billed) (the comments line of the bill). Off by default.
733
+ */
734
+ enabled?: boolean;
735
+ /**
736
+ * The newest comments of one thread you receive, 20 by default, 100 at most: the ceiling on what one mention's comments can cost. A comment that names the keyword is a mention too, but only among these newest ones, so it is never billed past the ceiling.
737
+ */
738
+ maxPerPost?: number;
739
+ };
662
740
  /**
663
741
  * Moves the keyword to this group (grp_...). A 409 when that group already tracks the term.
664
742
  */
@@ -688,6 +766,15 @@ type KeywordSuggestion = {
688
766
  */
689
767
  language?: string;
690
768
  }>;
769
+ /**
770
+ * Replaces the feeds this keyword reads; [] disconnects them all (their mentions stay). A feed added here is checked now and brings its newest 10 matching items of the last 30 days; one already listed keeps its place.
771
+ */
772
+ feeds?: Array<{
773
+ /**
774
+ * A feed's address (https://forum.example.com/posts.rss), or a page's (https://forum.example.com): the feed the page advertises is used.
775
+ */
776
+ url: string;
777
+ }>;
691
778
  };
692
779
  /**
693
780
  * What the change would have done over the window, measured with the matcher's own rules. Null for a context, which changes scores, not matches.
@@ -813,9 +900,9 @@ type KeywordHealth = {
813
900
  */
814
901
  byPlatform: Array<{
815
902
  /**
816
- * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place).
903
+ * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place), rss (RSS and Atom feeds a keyword reads).
817
904
  */
818
- platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
905
+ platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
819
906
  /**
820
907
  * Matches on this platform in the window.
821
908
  */
@@ -871,7 +958,15 @@ type KeywordHealth = {
871
958
  */
872
959
  mentionCents: number;
873
960
  /**
874
- * keywordCents plus mentionCents: its row in GET /v1/usage/breakdown for the same range.
961
+ * Comments billed in the window under the keyword (0074).
962
+ */
963
+ billableComments: number;
964
+ /**
965
+ * Those comments at the comment rate.
966
+ */
967
+ commentCents: number;
968
+ /**
969
+ * keywordCents, mentionCents and commentCents: its row in GET /v1/usage/breakdown for the same range.
875
970
  */
876
971
  totalCents: number;
877
972
  };
@@ -1028,9 +1123,13 @@ type Mention = {
1028
1123
  };
1029
1124
  post: {
1030
1125
  /**
1031
- * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place).
1126
+ * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place), rss (RSS and Atom feeds a keyword reads).
1127
+ */
1128
+ platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
1129
+ /**
1130
+ * post: a top-level post. comment: an item that answers a post or another comment (a Reddit or Hacker News comment, an X or Bluesky reply, a Stack Overflow answer, a YouTube comment).
1032
1131
  */
1033
- platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
1132
+ kind: 'post' | 'comment';
1034
1133
  /**
1035
1134
  * Permalink of the post.
1036
1135
  */
@@ -1047,6 +1146,14 @@ type Mention = {
1047
1146
  * A preview image of the post, when the platform sent one with it: a YouTube thumbnail, a DEV cover, a news article's sharing image, a Bluesky link card or image. Null otherwise.
1048
1147
  */
1049
1148
  imageUrl: string | null;
1149
+ /**
1150
+ * The subreddit a Reddit post was written in, without the r/ (SaaS). Null on every other platform.
1151
+ */
1152
+ subreddit: string | null;
1153
+ /**
1154
+ * A Reddit post's flair, when its subreddit uses them (Question, Show and Tell). Null otherwise.
1155
+ */
1156
+ flair: string | null;
1050
1157
  /**
1051
1158
  * Links the post carries, in the order written, at most 20. Empty for a post with none, and for posts ingested before September 2026.
1052
1159
  */
@@ -1067,7 +1174,7 @@ type Mention = {
1067
1174
  bookmarks: number | null;
1068
1175
  } | null;
1069
1176
  /**
1070
- * The post this one replies to (X, Bluesky); null for top-level posts.
1177
+ * The post or comment this one answers; null for top-level posts.
1071
1178
  */
1072
1179
  replyTo: {
1073
1180
  /**
@@ -1084,6 +1191,10 @@ type Mention = {
1084
1191
  text: string | null;
1085
1192
  } | null;
1086
1193
  };
1194
+ /**
1195
+ * For a comment whose parent post or comment is itself one of your mentions: that mention's id (mm_...). Null otherwise.
1196
+ */
1197
+ parentMentionId: string | null;
1087
1198
  /**
1088
1199
  * Who posted it; null when the platform gave no author at all.
1089
1200
  */
@@ -1260,11 +1371,112 @@ type Mention = {
1260
1371
  */
1261
1372
  note: string | null;
1262
1373
  };
1374
+ /**
1375
+ * Set on a cross-post: the id of the mention this one copies (the same author posting the same text again for the same keyword within three days, like one announcement pasted into five subreddits). A copy is billed like any mention but is listed only under its original and never alerted on its own. null for an original.
1376
+ */
1377
+ duplicateOf: string | null;
1378
+ /**
1379
+ * The cross-posts filed under this mention, oldest first: where else its author posted it. Empty when there are none, and on a copy.
1380
+ */
1381
+ duplicates: Array<{
1382
+ /**
1383
+ * The copy's mention id (mm_...).
1384
+ */
1385
+ id: string;
1386
+ /**
1387
+ * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place), rss (RSS and Atom feeds a keyword reads).
1388
+ */
1389
+ platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
1390
+ /**
1391
+ * Link to the copy.
1392
+ */
1393
+ url: string;
1394
+ /**
1395
+ * When the copy was published.
1396
+ */
1397
+ publishedAt: string;
1398
+ }>;
1399
+ /**
1400
+ * Computed counts.
1401
+ */
1402
+ stats: {
1403
+ /**
1404
+ * Comments of this post delivered to you (GET /v1/mentions/{id}/comments); 0 until its thread is read, and for keywords without comments.
1405
+ */
1406
+ comments: number;
1407
+ };
1263
1408
  /**
1264
1409
  * When the match was recorded; the default feed order.
1265
1410
  */
1266
1411
  createdAt: string;
1267
1412
  };
1413
+ type MentionComment = {
1414
+ /**
1415
+ * Comment id (men_...): the item itself, the same for every workspace it reaches.
1416
+ */
1417
+ id: string;
1418
+ /**
1419
+ * Permalink of the comment.
1420
+ */
1421
+ url: string;
1422
+ /**
1423
+ * The comment, truncated to 8 KB at ingest.
1424
+ */
1425
+ text: string;
1426
+ /**
1427
+ * When the comment was written.
1428
+ */
1429
+ publishedAt: string;
1430
+ /**
1431
+ * Who wrote it; null when the platform gave no author (a deleted account).
1432
+ */
1433
+ author: {
1434
+ /**
1435
+ * As the platform names them.
1436
+ */
1437
+ name: string | null;
1438
+ /**
1439
+ * Their profile.
1440
+ */
1441
+ url: string | null;
1442
+ /**
1443
+ * Their profile picture, when the platform sends one.
1444
+ */
1445
+ avatarUrl: string | null;
1446
+ } | null;
1447
+ /**
1448
+ * The comment this one answers, when it is a reply inside the thread; null for a comment on the post itself.
1449
+ */
1450
+ parentCommentId: string | null;
1451
+ /**
1452
+ * Engagement counts as the platform reported them when the post was ingested, usually minutes after it was written; a count the platform does not have is null. Null as a whole for platforms that report none and for posts ingested before September 2026. X carries all six.
1453
+ */
1454
+ engagement: {
1455
+ likes: number | null;
1456
+ reposts: number | null;
1457
+ replies: number | null;
1458
+ quotes: number | null;
1459
+ views: number | null;
1460
+ bookmarks: number | null;
1461
+ } | null;
1462
+ /**
1463
+ * A light read of the comment (sentiment and intent tags); null until it is scored, usually minutes after the thread arrives.
1464
+ */
1465
+ classification: {
1466
+ /**
1467
+ * Classifier sentiment.
1468
+ */
1469
+ sentiment: 'positive' | 'neutral' | 'negative';
1470
+ /**
1471
+ * Intent and topic tags, the same vocabulary as a mention's.
1472
+ */
1473
+ intents: Array<string>;
1474
+ } | null;
1475
+ /**
1476
+ * When this comment itself names one of your keywords, its mention (mm_...), with the full verdict. Null otherwise.
1477
+ */
1478
+ mentionId: string | null;
1479
+ };
1268
1480
  type Person = {
1269
1481
  /**
1270
1482
  * Person id (aut_...): the canonical account. An account merged into someone resolves to that person.
@@ -1273,7 +1485,7 @@ type Person = {
1273
1485
  /**
1274
1486
  * Platform of the canonical account; `accounts` lists every account.
1275
1487
  */
1276
- platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
1488
+ platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
1277
1489
  /**
1278
1490
  * Display name as of their newest post; null when the platform has none.
1279
1491
  */
@@ -1296,9 +1508,9 @@ type Person = {
1296
1508
  */
1297
1509
  id: string;
1298
1510
  /**
1299
- * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place).
1511
+ * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place), rss (RSS and Atom feeds a keyword reads).
1300
1512
  */
1301
- platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
1513
+ platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
1302
1514
  /**
1303
1515
  * Display name as the platform reports it.
1304
1516
  */
@@ -1454,7 +1666,7 @@ type Segment = {
1454
1666
  /**
1455
1667
  * People with an account on any of these platforms.
1456
1668
  */
1457
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
1669
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
1458
1670
  /**
1459
1671
  * People carrying any of these tags.
1460
1672
  */
@@ -1490,7 +1702,7 @@ type Segment = {
1490
1702
  /**
1491
1703
  * Nobody with an account on these platforms.
1492
1704
  */
1493
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
1705
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
1494
1706
  /**
1495
1707
  * Nobody carrying any of these tags.
1496
1708
  */
@@ -1568,11 +1780,11 @@ type FilterGroup = {
1568
1780
  /**
1569
1781
  * Only posts from any of these platforms.
1570
1782
  */
1571
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
1783
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
1572
1784
  /**
1573
1785
  * Never posts from these platforms.
1574
1786
  */
1575
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
1787
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
1576
1788
  /**
1577
1789
  * Only mentions in this status: open, ignored, done.
1578
1790
  */
@@ -1633,6 +1845,14 @@ type FilterGroup = {
1633
1845
  * Never posts linking to these hosts.
1634
1846
  */
1635
1847
  notLinkHosts?: Array<string>;
1848
+ /**
1849
+ * Only Reddit posts from any of these subreddits (names without the r/, any case); every other post fails it.
1850
+ */
1851
+ subreddits?: Array<string>;
1852
+ /**
1853
+ * Never Reddit posts from these subreddits; posts from other platforms still pass.
1854
+ */
1855
+ notSubreddits?: Array<string>;
1636
1856
  /**
1637
1857
  * Only authors with at least this many followers; unknown reach never passes.
1638
1858
  */
@@ -1645,6 +1865,10 @@ type FilterGroup = {
1645
1865
  * true: only replies and comments; false: only top-level posts.
1646
1866
  */
1647
1867
  isReply?: boolean;
1868
+ /**
1869
+ * Only posts (post) or only comments (comment).
1870
+ */
1871
+ kind?: 'post' | 'comment';
1648
1872
  /**
1649
1873
  * Never these authors: display names, handles or profile URLs.
1650
1874
  */
@@ -1717,11 +1941,11 @@ type View = {
1717
1941
  /**
1718
1942
  * Only posts from any of these platforms.
1719
1943
  */
1720
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
1944
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
1721
1945
  /**
1722
1946
  * Never posts from these platforms.
1723
1947
  */
1724
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
1948
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
1725
1949
  /**
1726
1950
  * Only mentions in this status: open, ignored, done.
1727
1951
  */
@@ -1782,6 +2006,14 @@ type View = {
1782
2006
  * Never posts linking to these hosts.
1783
2007
  */
1784
2008
  notLinkHosts?: Array<string>;
2009
+ /**
2010
+ * Only Reddit posts from any of these subreddits (names without the r/, any case); every other post fails it.
2011
+ */
2012
+ subreddits?: Array<string>;
2013
+ /**
2014
+ * Never Reddit posts from these subreddits; posts from other platforms still pass.
2015
+ */
2016
+ notSubreddits?: Array<string>;
1785
2017
  /**
1786
2018
  * Only authors with at least this many followers; unknown reach never passes.
1787
2019
  */
@@ -1794,6 +2026,10 @@ type View = {
1794
2026
  * true: only replies and comments; false: only top-level posts.
1795
2027
  */
1796
2028
  isReply?: boolean;
2029
+ /**
2030
+ * Only posts (post) or only comments (comment).
2031
+ */
2032
+ kind?: 'post' | 'comment';
1797
2033
  /**
1798
2034
  * Never these authors: display names, handles or profile URLs.
1799
2035
  */
@@ -2323,7 +2559,7 @@ type UsageSummary = {
2323
2559
  */
2324
2560
  cents: number;
2325
2561
  /**
2326
- * Mentions matched since the last daily settlement, priced but not yet debited.
2562
+ * Mentions and comments billed since the last daily settlement, priced but not yet debited.
2327
2563
  */
2328
2564
  pendingCents: number;
2329
2565
  /**
@@ -2446,24 +2682,32 @@ type UsageBreakdown = {
2446
2682
  * Of the matches billed in the window (every scored match, relevant or not), the ones in this group.
2447
2683
  */
2448
2684
  billableMentions: number;
2685
+ /**
2686
+ * Matches recorded in the window that are never charged: no score yet (still being scored, or classification failed), or a free review from the look-back of a newly connected app. Every other match is charged, on the mentions line or, for a comment, on the comments line.
2687
+ */
2688
+ unclassifiedMentions: number;
2449
2689
  /**
2450
2690
  * The billed mentions at $0.008 each, rounded once on the total.
2451
2691
  */
2452
2692
  mentionCents: number;
2453
2693
  /**
2454
- * keywordCents plus mentionCents.
2694
+ * Comments billed in the window (the comments line): comments delivered under your mentions and comments that matched a keyword, each once per workspace.
2455
2695
  */
2456
- totalCents: number;
2696
+ billableComments: number;
2457
2697
  /**
2458
- * Matched but never scored (classification failed): never charged.
2698
+ * The billed comments at $0.008 each, rounded once on the total.
2459
2699
  */
2460
- unclassifiedMentions: number;
2700
+ commentCents: number;
2701
+ /**
2702
+ * keywordCents plus mentionCents plus commentCents.
2703
+ */
2704
+ totalCents: number;
2461
2705
  /**
2462
2706
  * What the ledger has debited so far for the days of the window, each debit by the day it settled. Mentions settle the morning after their day, so a window ending today lags totalCents by today's mentions (and yesterday's before the tick at 00:05 UTC); a closed month differs from totalCents only by cumulative rounding.
2463
2707
  */
2464
2708
  ledgerDebitCents: number;
2465
2709
  /**
2466
- * Billed mentions whose match row is gone (deleted keyword), so no platform or keyword row can claim them. Charged all the same.
2710
+ * Billed mentions whose match row is gone (deleted keyword), so no platform or keyword row can claim them. Charged all the same. Comments carry their keyword and platform on the billed row, so they are never unattributed (by=group puts a deleted keyword's comments on the no-group row).
2467
2711
  */
2468
2712
  unattributedBillable: number;
2469
2713
  };
@@ -2529,12 +2773,24 @@ type UsageBreakdown = {
2529
2773
  * Of the matches billed in the window (every scored match, relevant or not), the ones in this group.
2530
2774
  */
2531
2775
  billableMentions: number;
2776
+ /**
2777
+ * Matches recorded in the window that are never charged: no score yet (still being scored, or classification failed), or a free review from the look-back of a newly connected app. Every other match is charged, on the mentions line or, for a comment, on the comments line.
2778
+ */
2779
+ unclassifiedMentions: number;
2532
2780
  /**
2533
2781
  * The billed mentions at $0.008 each, rounded once on the total.
2534
2782
  */
2535
2783
  mentionCents: number;
2536
2784
  /**
2537
- * keywordCents plus mentionCents.
2785
+ * Comments billed in the window (the comments line): comments delivered under your mentions and comments that matched a keyword, each once per workspace.
2786
+ */
2787
+ billableComments: number;
2788
+ /**
2789
+ * The billed comments at $0.008 each, rounded once on the total.
2790
+ */
2791
+ commentCents: number;
2792
+ /**
2793
+ * keywordCents plus mentionCents plus commentCents.
2538
2794
  */
2539
2795
  totalCents: number;
2540
2796
  }>;
@@ -2549,7 +2805,7 @@ type Wallet = {
2549
2805
  */
2550
2806
  balanceCents: number;
2551
2807
  /**
2552
- * Mentions matched since the last daily settlement, priced but not yet debited.
2808
+ * Mentions and comments billed since the last daily settlement, priced but not yet debited.
2553
2809
  */
2554
2810
  pendingCents: number;
2555
2811
  /**
@@ -2662,9 +2918,9 @@ type LedgerList = {
2662
2918
  */
2663
2919
  id: string;
2664
2920
  /**
2665
- * signup_credit, topup, refund, debit_keyword_days, debit_mentions or adjustment.
2921
+ * signup_credit, topup, refund, debit_keyword_days, debit_mentions, debit_comments or adjustment.
2666
2922
  */
2667
- kind: 'signup_credit' | 'topup' | 'refund' | 'debit_keyword_days' | 'debit_mentions' | 'adjustment';
2923
+ kind: 'signup_credit' | 'topup' | 'refund' | 'debit_keyword_days' | 'debit_mentions' | 'debit_comments' | 'adjustment';
2668
2924
  /**
2669
2925
  * Integer USD cents; credits positive, debits negative.
2670
2926
  */
@@ -2753,7 +3009,7 @@ type Alert = {
2753
3009
  /**
2754
3010
  * Only posts from these platforms.
2755
3011
  */
2756
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
3012
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
2757
3013
  /**
2758
3014
  * The rule's relevance floor. Absent, it sends relevant mentions only (scored 40 and up, the classifier's line); lower, down to 0, it also receives the matches the classifier scored as noise; higher, it hears less. Email channels keep the 40 line whatever the rule says. Unclassified mentions never pass.
2759
3015
  */
@@ -3260,17 +3516,17 @@ type AnalyticsBreakdown = {
3260
3516
  /**
3261
3517
  * The dimension the rows are grouped by.
3262
3518
  */
3263
- by: 'platform' | 'keyword' | 'sentiment' | 'intent' | 'status' | 'hour' | 'person' | 'language';
3519
+ by: 'platform' | 'keyword' | 'sentiment' | 'intent' | 'status' | 'hour' | 'person' | 'language' | 'subreddit';
3264
3520
  /**
3265
3521
  * Most matched first, at most 50 groups. by=hour is chronological and unlimited (168 cells at most).
3266
3522
  */
3267
3523
  data: Array<{
3268
3524
  /**
3269
- * The group: platform name, keyword id, sentiment, intent, status, "weekday-hour" for by=hour, or an opaque person key.
3525
+ * The group: platform name, keyword id, sentiment, intent, status, "weekday-hour" for by=hour, an opaque person key, or the subreddit in lowercase.
3270
3526
  */
3271
3527
  key: string;
3272
3528
  /**
3273
- * Readable name: the keyword term, the person name, otherwise the key.
3529
+ * Readable name: the keyword term, the person name, the subreddit as Reddit spells it, otherwise the key.
3274
3530
  */
3275
3531
  label: string;
3276
3532
  /**
@@ -3304,9 +3560,9 @@ type AnalyticsBreakdown = {
3304
3560
  */
3305
3561
  name: string | null;
3306
3562
  /**
3307
- * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place).
3563
+ * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place), rss (RSS and Atom feeds a keyword reads).
3308
3564
  */
3309
- platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
3565
+ platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
3310
3566
  /**
3311
3567
  * Profile URL.
3312
3568
  */
@@ -3915,7 +4171,7 @@ type ListKeywordsData = {
3915
4171
  /**
3916
4172
  * Only keywords tracked on any of these platforms: its term searched there (every platform when its platforms are null), or for appstore and googleplay, an app of that store among its reviewSources. Repeatable, or comma-separated.
3917
4173
  */
3918
- platform?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
4174
+ platform?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
3919
4175
  /**
3920
4176
  * newest: created most recently first. oldest: the reverse. term: A to Z. mentions: most matches first. relevant: most relevant matches first. recent: most matches in the last 7 days first. lastMention: newest matched post first, keywords with none last.
3921
4177
  */
@@ -3975,7 +4231,7 @@ type ListKeywordsResponses = {
3975
4231
  */
3976
4232
  cap: {
3977
4233
  /**
3978
- * Matched mentions allowed per calendar month (UTC). Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills.
4234
+ * Charged items allowed per calendar month (UTC): matched mentions plus the thread comments delivered under them. Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills.
3979
4235
  */
3980
4236
  mentions: number;
3981
4237
  /**
@@ -3987,11 +4243,28 @@ type ListKeywordsResponses = {
3987
4243
  */
3988
4244
  own: number | null;
3989
4245
  } | null;
4246
+ /**
4247
+ * Comments under this keyword's mentions: when enabled, the comments of every mention scored relevant are read from 30 minutes after the post, on a schedule per platform (for a day on Reddit, Hacker News and Bluesky, a week on GitHub, Stack Overflow and DEV, a month on YouTube) (new comments only, at most maxPerPost a thread, comments of fewer than three words dropped), on Hacker News, Bluesky, GitHub, Stack Overflow, DEV, YouTube and Reddit. List them with GET /v1/mentions/{id}/comments.
4248
+ */
4249
+ comments: {
4250
+ /**
4251
+ * Read the comments under this keyword's relevant mentions, from 30 minutes after each post, as long as its platform's conversations last (a day to a month). Each comment delivered costs $0.008 (comments of fewer than three words are dropped, never billed) (the comments line of the bill). Off by default.
4252
+ */
4253
+ enabled: boolean;
4254
+ /**
4255
+ * The newest comments of one thread you receive, 20 by default, 100 at most: the ceiling on what one mention's comments can cost. A comment that names the keyword is a mention too, but only among these newest ones, so it is never billed past the ceiling.
4256
+ */
4257
+ maxPerPost: number;
4258
+ };
3990
4259
  group: GroupRef;
3991
4260
  /**
3992
4261
  * Platforms the term is searched on; null means every platform, [] none (the keyword only collects reviews).
3993
4262
  */
3994
4263
  platforms: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram'> | null;
4264
+ /**
4265
+ * RSS and Atom feeds this keyword reads; empty for none.
4266
+ */
4267
+ feeds: Array<KeywordFeed>;
3995
4268
  /**
3996
4269
  * Where this keyword collects reviews from (App Store and Google Play apps, Trustpilot pages, Google Maps places); empty for none.
3997
4270
  */
@@ -4028,6 +4301,19 @@ type ListKeywordsResponses = {
4028
4301
  * true: only the exact phrase matches. false (default): a multi-word keyword also matches a post holding its words close together, in any order, plurals and spellings (non-profit, nonprofit) included; such a match is kept and billed only when the classifier scores it relevant. A term sent in double quotes sets this to true.
4029
4302
  */
4030
4303
  exactPhrase: boolean;
4304
+ /**
4305
+ * Reddit only, for this keyword alone; the workspace filters' own subreddit lists (GET /v1/filters) still apply to every keyword, and a post must pass both.
4306
+ */
4307
+ subreddits: {
4308
+ /**
4309
+ * When non-empty, this keyword takes Reddit posts from these subreddits ONLY and `excluded` is ignored. r/name or name, stored bare and lowercase.
4310
+ */
4311
+ only: Array<string>;
4312
+ /**
4313
+ * Reddit posts from these subreddits are dropped for this keyword. r/name or name.
4314
+ */
4315
+ excluded: Array<string>;
4316
+ };
4031
4317
  };
4032
4318
  /**
4033
4319
  * Computed over this workspace's matches.
@@ -4046,7 +4332,7 @@ type ListKeywordsResponses = {
4046
4332
  */
4047
4333
  last7d: number;
4048
4334
  /**
4049
- * Matches recorded this calendar month (UTC), the count a cap compares against.
4335
+ * Matches recorded this calendar month (UTC), plus the thread comments delivered under this keyword's mentions: the count a cap compares against.
4050
4336
  */
4051
4337
  thisMonth: number;
4052
4338
  /**
@@ -4108,7 +4394,15 @@ type ListKeywordsResponses = {
4108
4394
  */
4109
4395
  mentionCents: number;
4110
4396
  /**
4111
- * keywordCents plus mentionCents: what this keyword has cost this month, in USD cents.
4397
+ * Comments billed this month under this keyword: comments delivered in its threads and comments it matched, each once per workspace.
4398
+ */
4399
+ billableComments: number;
4400
+ /**
4401
+ * Those comments at $0.008 each, rounded once on the total.
4402
+ */
4403
+ commentCents: number;
4404
+ /**
4405
+ * keywordCents plus mentionCents plus commentCents: what this keyword has cost this month, in USD cents.
4112
4406
  */
4113
4407
  totalCents: number;
4114
4408
  };
@@ -4118,9 +4412,9 @@ type ListKeywordsResponses = {
4118
4412
  */
4119
4413
  polling: Array<{
4120
4414
  /**
4121
- * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place).
4415
+ * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place), rss (RSS and Atom feeds a keyword reads).
4122
4416
  */
4123
- platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
4417
+ platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
4124
4418
  /**
4125
4419
  * Newest poll of this platform for the term; null until the first one.
4126
4420
  */
@@ -4153,7 +4447,7 @@ type CreateKeywordData = {
4153
4447
  */
4154
4448
  kind?: 'brand' | 'competitor' | 'topic';
4155
4449
  /**
4156
- * Platforms to search the term on; omit or null for every platform. [] searches it nowhere: a keyword that only collects reviews, which then needs reviewSources.
4450
+ * Platforms to search the term on; omit or null for every platform. [] searches it nowhere: a keyword that only collects reviews or reads feeds, which then needs reviewSources or feeds.
4157
4451
  */
4158
4452
  platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram'> | null;
4159
4453
  /**
@@ -4188,16 +4482,42 @@ type CreateKeywordData = {
4188
4482
  * true: only the exact phrase matches. false (default): a multi-word keyword also matches a post holding its words close together, in any order, plurals and spellings (non-profit, nonprofit) included; such a match is kept and billed only when the classifier scores it relevant. A term sent in double quotes sets this to true.
4189
4483
  */
4190
4484
  exactPhrase?: boolean;
4485
+ /**
4486
+ * Reddit only, for this keyword alone: each list is replaced when sent, kept when omitted.
4487
+ */
4488
+ subreddits?: {
4489
+ /**
4490
+ * Replaces the keyword's allowlist; [] clears it.
4491
+ */
4492
+ only?: Array<string>;
4493
+ /**
4494
+ * Replaces the keyword's deny list; [] clears it.
4495
+ */
4496
+ excluded?: Array<string>;
4497
+ };
4191
4498
  };
4192
4499
  /**
4193
4500
  * A monthly mention cap; omit or null for none.
4194
4501
  */
4195
4502
  cap?: {
4196
4503
  /**
4197
- * Matched mentions allowed per calendar month (UTC). Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills.
4504
+ * Charged items allowed per calendar month (UTC): matched mentions plus the thread comments delivered under them. Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills.
4198
4505
  */
4199
4506
  mentions: number;
4200
4507
  } | null;
4508
+ /**
4509
+ * Comments under this keyword's mentions; omitted fields are untouched (on create: off, 20 per post).
4510
+ */
4511
+ comments?: {
4512
+ /**
4513
+ * Read the comments under this keyword's relevant mentions, from 30 minutes after each post, as long as its platform's conversations last (a day to a month). Each comment delivered costs $0.008 (comments of fewer than three words are dropped, never billed) (the comments line of the bill). Off by default.
4514
+ */
4515
+ enabled?: boolean;
4516
+ /**
4517
+ * The newest comments of one thread you receive, 20 by default, 100 at most: the ceiling on what one mention's comments can cost. A comment that names the keyword is a mention too, but only among these newest ones, so it is never billed past the ceiling.
4518
+ */
4519
+ maxPerPost?: number;
4520
+ };
4201
4521
  /**
4202
4522
  * The group to track it in (grp_...); omit for the workspace's default group. A term may be tracked once per group.
4203
4523
  */
@@ -4227,6 +4547,15 @@ type CreateKeywordData = {
4227
4547
  */
4228
4548
  language?: string;
4229
4549
  }>;
4550
+ /**
4551
+ * RSS or Atom feeds this keyword reads, at most 20, each { url }: a feed's URL, or a page's (a forum, a community, a blog), in which case the feed the page advertises is used, else a usual address such as /feed or /rss. A URL with no feed behind it is a 400. Each feed is read every hour; an item is a mention of this keyword when it holds the term (with the keyword's matching rules), and only of keywords that named the feed. A newly connected feed brings its newest 10 items of the last 30 days that hold the term, billed like any mention and never sent as instant alerts.
4552
+ */
4553
+ feeds?: Array<{
4554
+ /**
4555
+ * A feed's address (https://forum.example.com/posts.rss), or a page's (https://forum.example.com): the feed the page advertises is used.
4556
+ */
4557
+ url: string;
4558
+ }>;
4230
4559
  };
4231
4560
  path?: never;
4232
4561
  query?: never;
@@ -4361,16 +4690,42 @@ type UpdateKeywordData = {
4361
4690
  * true: only the exact phrase matches. false (default): a multi-word keyword also matches a post holding its words close together, in any order, plurals and spellings (non-profit, nonprofit) included; such a match is kept and billed only when the classifier scores it relevant. A term sent in double quotes sets this to true.
4362
4691
  */
4363
4692
  exactPhrase?: boolean;
4693
+ /**
4694
+ * Reddit only, for this keyword alone: each list is replaced when sent, kept when omitted.
4695
+ */
4696
+ subreddits?: {
4697
+ /**
4698
+ * Replaces the keyword's allowlist; [] clears it.
4699
+ */
4700
+ only?: Array<string>;
4701
+ /**
4702
+ * Replaces the keyword's deny list; [] clears it.
4703
+ */
4704
+ excluded?: Array<string>;
4705
+ };
4364
4706
  };
4365
4707
  /**
4366
4708
  * Replaces the monthly mention cap; null removes it. A cap above this month's count resumes a capped keyword at once, one at or under it pauses it.
4367
4709
  */
4368
4710
  cap?: {
4369
4711
  /**
4370
- * Matched mentions allowed per calendar month (UTC). Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills.
4712
+ * Charged items allowed per calendar month (UTC): matched mentions plus the thread comments delivered under them. Every match counts, relevant or not, the look-back a new keyword gets included, because every match bills.
4371
4713
  */
4372
4714
  mentions: number;
4373
4715
  } | null;
4716
+ /**
4717
+ * Comments under this keyword's mentions; omitted fields are untouched (on create: off, 20 per post).
4718
+ */
4719
+ comments?: {
4720
+ /**
4721
+ * Read the comments under this keyword's relevant mentions, from 30 minutes after each post, as long as its platform's conversations last (a day to a month). Each comment delivered costs $0.008 (comments of fewer than three words are dropped, never billed) (the comments line of the bill). Off by default.
4722
+ */
4723
+ enabled?: boolean;
4724
+ /**
4725
+ * The newest comments of one thread you receive, 20 by default, 100 at most: the ceiling on what one mention's comments can cost. A comment that names the keyword is a mention too, but only among these newest ones, so it is never billed past the ceiling.
4726
+ */
4727
+ maxPerPost?: number;
4728
+ };
4374
4729
  /**
4375
4730
  * Moves the keyword to this group (grp_...). A 409 when that group already tracks the term.
4376
4731
  */
@@ -4400,6 +4755,15 @@ type UpdateKeywordData = {
4400
4755
  */
4401
4756
  language?: string;
4402
4757
  }>;
4758
+ /**
4759
+ * Replaces the feeds this keyword reads; [] disconnects them all (their mentions stay). A feed added here is checked now and brings its newest 10 matching items of the last 30 days; one already listed keeps its place.
4760
+ */
4761
+ feeds?: Array<{
4762
+ /**
4763
+ * A feed's address (https://forum.example.com/posts.rss), or a page's (https://forum.example.com): the feed the page advertises is used.
4764
+ */
4765
+ url: string;
4766
+ }>;
4403
4767
  };
4404
4768
  path: {
4405
4769
  /**
@@ -4656,7 +5020,7 @@ type SearchMentionsData = {
4656
5020
  /**
4657
5021
  * Only posts from this platform.
4658
5022
  */
4659
- platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
5023
+ platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
4660
5024
  /**
4661
5025
  * Only mentions in this status. Omit for every status.
4662
5026
  */
@@ -4685,6 +5049,10 @@ type SearchMentionsData = {
4685
5049
  * true: include mentions by people you muted, hidden by default.
4686
5050
  */
4687
5051
  includeMuted?: boolean;
5052
+ /**
5053
+ * true: list cross-posts (a mention whose duplicateOf is set) as mentions of their own. By default each is listed only in its original's duplicates.
5054
+ */
5055
+ includeDuplicates?: boolean;
4688
5056
  /**
4689
5057
  * Only mentions assigned to this workspace member (user id).
4690
5058
  */
@@ -4713,6 +5081,10 @@ type SearchMentionsData = {
4713
5081
  * Only authors with at most this many followers. Unknown reach never passes.
4714
5082
  */
4715
5083
  maxFollowers?: number | null;
5084
+ /**
5085
+ * Only posts (post) or only comments (comment). Omitted: both.
5086
+ */
5087
+ kind?: 'post' | 'comment';
4716
5088
  /**
4717
5089
  * true: only replies and comments (posts answering another post); false: only top-level posts. Omitted: both.
4718
5090
  */
@@ -4740,11 +5112,11 @@ type SearchMentionsData = {
4740
5112
  /**
4741
5113
  * Only posts from any of these platforms.
4742
5114
  */
4743
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
5115
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
4744
5116
  /**
4745
5117
  * Never posts from these platforms.
4746
5118
  */
4747
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
5119
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
4748
5120
  /**
4749
5121
  * Only matches of any of these keywords.
4750
5122
  */
@@ -4781,6 +5153,14 @@ type SearchMentionsData = {
4781
5153
  * Never posts linking to these hosts, the host itself or a subdomain of it.
4782
5154
  */
4783
5155
  notLinkHosts?: Array<string> | null;
5156
+ /**
5157
+ * Only Reddit posts from any of these subreddits: subreddits=SaaS,startups (names without the r/, any case). Every other post fails it. Repeatable, or comma-separated.
5158
+ */
5159
+ subreddits?: Array<string> | null;
5160
+ /**
5161
+ * Never Reddit posts from these subreddits; posts from other platforms still pass.
5162
+ */
5163
+ notSubreddits?: Array<string> | null;
4784
5164
  /**
4785
5165
  * Never authors your workspace tagged with any of these.
4786
5166
  */
@@ -4891,7 +5271,7 @@ type ExportMentionsCsvData = {
4891
5271
  /**
4892
5272
  * Only posts from this platform.
4893
5273
  */
4894
- platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
5274
+ platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
4895
5275
  /**
4896
5276
  * Only mentions in this status. Omit for every status.
4897
5277
  */
@@ -4920,6 +5300,10 @@ type ExportMentionsCsvData = {
4920
5300
  * true: include mentions by people you muted, hidden by default.
4921
5301
  */
4922
5302
  includeMuted?: boolean;
5303
+ /**
5304
+ * true: list cross-posts (a mention whose duplicateOf is set) as mentions of their own. By default each is listed only in its original's duplicates.
5305
+ */
5306
+ includeDuplicates?: boolean;
4923
5307
  /**
4924
5308
  * Only mentions assigned to this workspace member (user id).
4925
5309
  */
@@ -4948,6 +5332,10 @@ type ExportMentionsCsvData = {
4948
5332
  * Only authors with at most this many followers. Unknown reach never passes.
4949
5333
  */
4950
5334
  maxFollowers?: number | null;
5335
+ /**
5336
+ * Only posts (post) or only comments (comment). Omitted: both.
5337
+ */
5338
+ kind?: 'post' | 'comment';
4951
5339
  /**
4952
5340
  * true: only replies and comments (posts answering another post); false: only top-level posts. Omitted: both.
4953
5341
  */
@@ -4975,11 +5363,11 @@ type ExportMentionsCsvData = {
4975
5363
  /**
4976
5364
  * Only posts from any of these platforms.
4977
5365
  */
4978
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
5366
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
4979
5367
  /**
4980
5368
  * Never posts from these platforms.
4981
5369
  */
4982
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
5370
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
4983
5371
  /**
4984
5372
  * Only matches of any of these keywords.
4985
5373
  */
@@ -5016,6 +5404,14 @@ type ExportMentionsCsvData = {
5016
5404
  * Never posts linking to these hosts, the host itself or a subdomain of it.
5017
5405
  */
5018
5406
  notLinkHosts?: Array<string> | null;
5407
+ /**
5408
+ * Only Reddit posts from any of these subreddits: subreddits=SaaS,startups (names without the r/, any case). Every other post fails it. Repeatable, or comma-separated.
5409
+ */
5410
+ subreddits?: Array<string> | null;
5411
+ /**
5412
+ * Never Reddit posts from these subreddits; posts from other platforms still pass.
5413
+ */
5414
+ notSubreddits?: Array<string> | null;
5019
5415
  /**
5020
5416
  * Never authors your workspace tagged with any of these.
5021
5417
  */
@@ -5101,6 +5497,54 @@ type ExportMentionsCsvResponses = {
5101
5497
  200: string;
5102
5498
  };
5103
5499
  type ExportMentionsCsvResponse = ExportMentionsCsvResponses[keyof ExportMentionsCsvResponses];
5500
+ type ListMentionCommentsData = {
5501
+ body?: never;
5502
+ path: {
5503
+ /**
5504
+ * Mention id (mm_...).
5505
+ */
5506
+ id: string;
5507
+ };
5508
+ query?: {
5509
+ /**
5510
+ * nextCursor from the previous page.
5511
+ */
5512
+ cursor?: string;
5513
+ /**
5514
+ * Page size, 1 to 100.
5515
+ */
5516
+ limit?: number;
5517
+ };
5518
+ url: '/v1/mentions/{id}/comments';
5519
+ };
5520
+ type ListMentionCommentsErrors = {
5521
+ /**
5522
+ * Invalid pagination cursor
5523
+ */
5524
+ 400: ErrorResponse;
5525
+ /**
5526
+ * Missing or invalid API key
5527
+ */
5528
+ 401: ErrorResponse;
5529
+ /**
5530
+ * Mention not found
5531
+ */
5532
+ 404: ErrorResponse;
5533
+ };
5534
+ type ListMentionCommentsError = ListMentionCommentsErrors[keyof ListMentionCommentsErrors];
5535
+ type ListMentionCommentsResponses = {
5536
+ /**
5537
+ * One page of the thread, newest first
5538
+ */
5539
+ 200: {
5540
+ data: Array<MentionComment>;
5541
+ /**
5542
+ * Pass as cursor for the next page; null on the last page.
5543
+ */
5544
+ nextCursor: string | null;
5545
+ };
5546
+ };
5547
+ type ListMentionCommentsResponse = ListMentionCommentsResponses[keyof ListMentionCommentsResponses];
5104
5548
  type ExportMentionsJsonData = {
5105
5549
  body?: never;
5106
5550
  path?: never;
@@ -5112,7 +5556,7 @@ type ExportMentionsJsonData = {
5112
5556
  /**
5113
5557
  * Only posts from this platform.
5114
5558
  */
5115
- platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
5559
+ platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
5116
5560
  /**
5117
5561
  * Only mentions in this status. Omit for every status.
5118
5562
  */
@@ -5141,6 +5585,10 @@ type ExportMentionsJsonData = {
5141
5585
  * true: include mentions by people you muted, hidden by default.
5142
5586
  */
5143
5587
  includeMuted?: boolean;
5588
+ /**
5589
+ * true: list cross-posts (a mention whose duplicateOf is set) as mentions of their own. By default each is listed only in its original's duplicates.
5590
+ */
5591
+ includeDuplicates?: boolean;
5144
5592
  /**
5145
5593
  * Only mentions assigned to this workspace member (user id).
5146
5594
  */
@@ -5169,6 +5617,10 @@ type ExportMentionsJsonData = {
5169
5617
  * Only authors with at most this many followers. Unknown reach never passes.
5170
5618
  */
5171
5619
  maxFollowers?: number | null;
5620
+ /**
5621
+ * Only posts (post) or only comments (comment). Omitted: both.
5622
+ */
5623
+ kind?: 'post' | 'comment';
5172
5624
  /**
5173
5625
  * true: only replies and comments (posts answering another post); false: only top-level posts. Omitted: both.
5174
5626
  */
@@ -5196,11 +5648,11 @@ type ExportMentionsJsonData = {
5196
5648
  /**
5197
5649
  * Only posts from any of these platforms.
5198
5650
  */
5199
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
5651
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
5200
5652
  /**
5201
5653
  * Never posts from these platforms.
5202
5654
  */
5203
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
5655
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
5204
5656
  /**
5205
5657
  * Only matches of any of these keywords.
5206
5658
  */
@@ -5237,6 +5689,14 @@ type ExportMentionsJsonData = {
5237
5689
  * Never posts linking to these hosts, the host itself or a subdomain of it.
5238
5690
  */
5239
5691
  notLinkHosts?: Array<string> | null;
5692
+ /**
5693
+ * Only Reddit posts from any of these subreddits: subreddits=SaaS,startups (names without the r/, any case). Every other post fails it. Repeatable, or comma-separated.
5694
+ */
5695
+ subreddits?: Array<string> | null;
5696
+ /**
5697
+ * Never Reddit posts from these subreddits; posts from other platforms still pass.
5698
+ */
5699
+ notSubreddits?: Array<string> | null;
5240
5700
  /**
5241
5701
  * Never authors your workspace tagged with any of these.
5242
5702
  */
@@ -5338,7 +5798,7 @@ type ExportPeopleCsvData = {
5338
5798
  /**
5339
5799
  * People with an account on this platform.
5340
5800
  */
5341
- platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
5801
+ platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
5342
5802
  /**
5343
5803
  * Matches the display name or the profile handle or URL, case-insensitively.
5344
5804
  */
@@ -5366,7 +5826,7 @@ type ExportPeopleCsvData = {
5366
5826
  /**
5367
5827
  * People with an account on any of these platforms. Repeatable, or comma-separated.
5368
5828
  */
5369
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
5829
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
5370
5830
  /**
5371
5831
  * People carrying any of these tags. Repeatable, or comma-separated.
5372
5832
  */
@@ -5394,7 +5854,7 @@ type ExportPeopleCsvData = {
5394
5854
  /**
5395
5855
  * Nobody with an account on these platforms. Repeatable, or comma-separated.
5396
5856
  */
5397
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
5857
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
5398
5858
  /**
5399
5859
  * Nobody carrying any of these tags. Repeatable, or comma-separated.
5400
5860
  */
@@ -5471,7 +5931,7 @@ type ListPeopleData = {
5471
5931
  /**
5472
5932
  * People with an account on this platform.
5473
5933
  */
5474
- platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
5934
+ platform?: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
5475
5935
  /**
5476
5936
  * Matches the display name or the profile handle or URL, case-insensitively.
5477
5937
  */
@@ -5499,7 +5959,7 @@ type ListPeopleData = {
5499
5959
  /**
5500
5960
  * People with an account on any of these platforms. Repeatable, or comma-separated.
5501
5961
  */
5502
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
5962
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
5503
5963
  /**
5504
5964
  * People carrying any of these tags. Repeatable, or comma-separated.
5505
5965
  */
@@ -5527,7 +5987,7 @@ type ListPeopleData = {
5527
5987
  /**
5528
5988
  * Nobody with an account on these platforms. Repeatable, or comma-separated.
5529
5989
  */
5530
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
5990
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
5531
5991
  /**
5532
5992
  * Nobody carrying any of these tags. Repeatable, or comma-separated.
5533
5993
  */
@@ -5607,7 +6067,7 @@ type ListPeopleResponses = {
5607
6067
  /**
5608
6068
  * Platform of the canonical account; `accounts` lists every account.
5609
6069
  */
5610
- platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
6070
+ platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
5611
6071
  /**
5612
6072
  * Display name as of their newest post; null when the platform has none.
5613
6073
  */
@@ -5630,9 +6090,9 @@ type ListPeopleResponses = {
5630
6090
  */
5631
6091
  id: string;
5632
6092
  /**
5633
- * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place).
6093
+ * Platform: bluesky, hackernews, github, stackoverflow, devto, reddit, x, youtube, news, linkedin, tiktok, instagram, appstore (App Store reviews), googleplay (Google Play reviews), trustpilot (Trustpilot reviews), googlemaps (Google reviews of a place), rss (RSS and Atom feeds a keyword reads).
5634
6094
  */
5635
- platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps';
6095
+ platform: 'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss';
5636
6096
  /**
5637
6097
  * Display name as the platform reports it.
5638
6098
  */
@@ -6072,7 +6532,7 @@ type ListSegmentsResponses = {
6072
6532
  /**
6073
6533
  * People with an account on any of these platforms.
6074
6534
  */
6075
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
6535
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6076
6536
  /**
6077
6537
  * People carrying any of these tags.
6078
6538
  */
@@ -6108,7 +6568,7 @@ type ListSegmentsResponses = {
6108
6568
  /**
6109
6569
  * Nobody with an account on these platforms.
6110
6570
  */
6111
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
6571
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6112
6572
  /**
6113
6573
  * Nobody carrying any of these tags.
6114
6574
  */
@@ -6166,7 +6626,7 @@ type ListSegmentsResponses = {
6166
6626
  /**
6167
6627
  * People with an account on any of these platforms.
6168
6628
  */
6169
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
6629
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6170
6630
  /**
6171
6631
  * People carrying any of these tags.
6172
6632
  */
@@ -6202,7 +6662,7 @@ type ListSegmentsResponses = {
6202
6662
  /**
6203
6663
  * Nobody with an account on these platforms.
6204
6664
  */
6205
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
6665
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6206
6666
  /**
6207
6667
  * Nobody carrying any of these tags.
6208
6668
  */
@@ -6248,7 +6708,7 @@ type CreateSegmentData = {
6248
6708
  /**
6249
6709
  * People with an account on any of these platforms.
6250
6710
  */
6251
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
6711
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6252
6712
  /**
6253
6713
  * People carrying any of these tags.
6254
6714
  */
@@ -6284,7 +6744,7 @@ type CreateSegmentData = {
6284
6744
  /**
6285
6745
  * Nobody with an account on these platforms.
6286
6746
  */
6287
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
6747
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6288
6748
  /**
6289
6749
  * Nobody carrying any of these tags.
6290
6750
  */
@@ -6417,7 +6877,7 @@ type UpdateSegmentData = {
6417
6877
  /**
6418
6878
  * People with an account on any of these platforms.
6419
6879
  */
6420
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
6880
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6421
6881
  /**
6422
6882
  * People carrying any of these tags.
6423
6883
  */
@@ -6453,7 +6913,7 @@ type UpdateSegmentData = {
6453
6913
  /**
6454
6914
  * Nobody with an account on these platforms.
6455
6915
  */
6456
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
6916
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6457
6917
  /**
6458
6918
  * Nobody carrying any of these tags.
6459
6919
  */
@@ -6575,11 +7035,11 @@ type ListViewsResponses = {
6575
7035
  /**
6576
7036
  * Only posts from any of these platforms.
6577
7037
  */
6578
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
7038
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6579
7039
  /**
6580
7040
  * Never posts from these platforms.
6581
7041
  */
6582
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
7042
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6583
7043
  /**
6584
7044
  * Only mentions in this status: open, ignored, done.
6585
7045
  */
@@ -6640,6 +7100,14 @@ type ListViewsResponses = {
6640
7100
  * Never posts linking to these hosts.
6641
7101
  */
6642
7102
  notLinkHosts?: Array<string>;
7103
+ /**
7104
+ * Only Reddit posts from any of these subreddits (names without the r/, any case); every other post fails it.
7105
+ */
7106
+ subreddits?: Array<string>;
7107
+ /**
7108
+ * Never Reddit posts from these subreddits; posts from other platforms still pass.
7109
+ */
7110
+ notSubreddits?: Array<string>;
6643
7111
  /**
6644
7112
  * Only authors with at least this many followers; unknown reach never passes.
6645
7113
  */
@@ -6652,6 +7120,10 @@ type ListViewsResponses = {
6652
7120
  * true: only replies and comments; false: only top-level posts.
6653
7121
  */
6654
7122
  isReply?: boolean;
7123
+ /**
7124
+ * Only posts (post) or only comments (comment).
7125
+ */
7126
+ kind?: 'post' | 'comment';
6655
7127
  /**
6656
7128
  * Never these authors: display names, handles or profile URLs.
6657
7129
  */
@@ -6746,11 +7218,11 @@ type CreateViewData = {
6746
7218
  /**
6747
7219
  * Only posts from any of these platforms.
6748
7220
  */
6749
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
7221
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6750
7222
  /**
6751
7223
  * Never posts from these platforms.
6752
7224
  */
6753
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
7225
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6754
7226
  /**
6755
7227
  * Only mentions in this status: open, ignored, done.
6756
7228
  */
@@ -6811,6 +7283,14 @@ type CreateViewData = {
6811
7283
  * Never posts linking to these hosts.
6812
7284
  */
6813
7285
  notLinkHosts?: Array<string>;
7286
+ /**
7287
+ * Only Reddit posts from any of these subreddits (names without the r/, any case); every other post fails it.
7288
+ */
7289
+ subreddits?: Array<string>;
7290
+ /**
7291
+ * Never Reddit posts from these subreddits; posts from other platforms still pass.
7292
+ */
7293
+ notSubreddits?: Array<string>;
6814
7294
  /**
6815
7295
  * Only authors with at least this many followers; unknown reach never passes.
6816
7296
  */
@@ -6823,6 +7303,10 @@ type CreateViewData = {
6823
7303
  * true: only replies and comments; false: only top-level posts.
6824
7304
  */
6825
7305
  isReply?: boolean;
7306
+ /**
7307
+ * Only posts (post) or only comments (comment).
7308
+ */
7309
+ kind?: 'post' | 'comment';
6826
7310
  /**
6827
7311
  * Never these authors: display names, handles or profile URLs.
6828
7312
  */
@@ -6984,11 +7468,11 @@ type UpdateViewData = {
6984
7468
  /**
6985
7469
  * Only posts from any of these platforms.
6986
7470
  */
6987
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
7471
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6988
7472
  /**
6989
7473
  * Never posts from these platforms.
6990
7474
  */
6991
- notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
7475
+ notPlatforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
6992
7476
  /**
6993
7477
  * Only mentions in this status: open, ignored, done.
6994
7478
  */
@@ -7049,6 +7533,14 @@ type UpdateViewData = {
7049
7533
  * Never posts linking to these hosts.
7050
7534
  */
7051
7535
  notLinkHosts?: Array<string>;
7536
+ /**
7537
+ * Only Reddit posts from any of these subreddits (names without the r/, any case); every other post fails it.
7538
+ */
7539
+ subreddits?: Array<string>;
7540
+ /**
7541
+ * Never Reddit posts from these subreddits; posts from other platforms still pass.
7542
+ */
7543
+ notSubreddits?: Array<string>;
7052
7544
  /**
7053
7545
  * Only authors with at least this many followers; unknown reach never passes.
7054
7546
  */
@@ -7061,6 +7553,10 @@ type UpdateViewData = {
7061
7553
  * true: only replies and comments; false: only top-level posts.
7062
7554
  */
7063
7555
  isReply?: boolean;
7556
+ /**
7557
+ * Only posts (post) or only comments (comment).
7558
+ */
7559
+ kind?: 'post' | 'comment';
7064
7560
  /**
7065
7561
  * Never these authors: display names, handles or profile URLs.
7066
7562
  */
@@ -8126,7 +8622,7 @@ type UpdateAlertData = {
8126
8622
  /**
8127
8623
  * Only posts from these platforms.
8128
8624
  */
8129
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
8625
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
8130
8626
  /**
8131
8627
  * The rule's relevance floor. Absent, it sends relevant mentions only (scored 40 and up, the classifier's line); lower, down to 0, it also receives the matches the classifier scored as noise; higher, it hears less. Email channels keep the 40 line whatever the rule says. Unclassified mentions never pass.
8132
8628
  */
@@ -8295,7 +8791,7 @@ type ListAlertsResponses = {
8295
8791
  /**
8296
8792
  * Only posts from these platforms.
8297
8793
  */
8298
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
8794
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
8299
8795
  /**
8300
8796
  * The rule's relevance floor. Absent, it sends relevant mentions only (scored 40 and up, the classifier's line); lower, down to 0, it also receives the matches the classifier scored as noise; higher, it hears less. Email channels keep the 40 line whatever the rule says. Unclassified mentions never pass.
8301
8797
  */
@@ -8440,7 +8936,7 @@ type CreateAlertData = {
8440
8936
  /**
8441
8937
  * Only posts from these platforms.
8442
8938
  */
8443
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
8939
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
8444
8940
  /**
8445
8941
  * The rule's relevance floor. Absent, it sends relevant mentions only (scored 40 and up, the classifier's line); lower, down to 0, it also receives the matches the classifier scored as noise; higher, it hears less. Email channels keep the 40 line whatever the rule says. Unclassified mentions never pass.
8446
8942
  */
@@ -8743,7 +9239,7 @@ type GetAnalyticsSummaryData = {
8743
9239
  /**
8744
9240
  * Only these platforms. Repeatable, or comma-separated; omit for every platform.
8745
9241
  */
8746
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
9242
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
8747
9243
  /**
8748
9244
  * true adds the period of the same length right before the window as `previous`.
8749
9245
  */
@@ -8796,7 +9292,7 @@ type GetAnalyticsSeriesData = {
8796
9292
  /**
8797
9293
  * Only these platforms. Repeatable, or comma-separated; omit for every platform.
8798
9294
  */
8799
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
9295
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
8800
9296
  /**
8801
9297
  * true adds the period of the same length right before the window as `previous`.
8802
9298
  */
@@ -8857,7 +9353,7 @@ type GetAnalyticsBreakdownData = {
8857
9353
  /**
8858
9354
  * Only these platforms. Repeatable, or comma-separated; omit for every platform.
8859
9355
  */
8860
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
9356
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
8861
9357
  /**
8862
9358
  * true adds the period of the same length right before the window as `previous`.
8863
9359
  */
@@ -8867,9 +9363,9 @@ type GetAnalyticsBreakdownData = {
8867
9363
  */
8868
9364
  timezone?: string;
8869
9365
  /**
8870
- * The dimension to group by: platform, keyword, sentiment (unclassified included), intent (a mention can carry several), status (open, ignored, done), hour (weekday and hour of day in `timezone`), person (who posted; anonymous posts are left out), language (ISO 639-1; "unknown" for posts without one).
9366
+ * The dimension to group by: platform, keyword, sentiment (unclassified included), intent (a mention can carry several), status (open, ignored, done), hour (weekday and hour of day in `timezone`), person (who posted; anonymous posts are left out), language (ISO 639-1; "unknown" for posts without one), subreddit (Reddit posts only, most active first; `share` stays a percent of the whole window, every platform included).
8871
9367
  */
8872
- by: 'platform' | 'keyword' | 'sentiment' | 'intent' | 'status' | 'hour' | 'person' | 'language';
9368
+ by: 'platform' | 'keyword' | 'sentiment' | 'intent' | 'status' | 'hour' | 'person' | 'language' | 'subreddit';
8873
9369
  };
8874
9370
  url: '/v1/analytics/breakdown';
8875
9371
  };
@@ -8914,7 +9410,7 @@ type GetShareOfVoiceData = {
8914
9410
  /**
8915
9411
  * Only these platforms. Repeatable, or comma-separated; omit for every platform.
8916
9412
  */
8917
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
9413
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
8918
9414
  /**
8919
9415
  * true adds the period of the same length right before the window as `previous`.
8920
9416
  */
@@ -8967,7 +9463,7 @@ type GetReviewsReportData = {
8967
9463
  /**
8968
9464
  * Only these platforms. Repeatable, or comma-separated; omit for every platform.
8969
9465
  */
8970
- platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps'>;
9466
+ platforms?: Array<'bluesky' | 'hackernews' | 'github' | 'stackoverflow' | 'devto' | 'reddit' | 'x' | 'youtube' | 'news' | 'linkedin' | 'tiktok' | 'instagram' | 'appstore' | 'googleplay' | 'trustpilot' | 'googlemaps' | 'rss'>;
8971
9467
  /**
8972
9468
  * true adds the period of the same length right before the window as `previous`.
8973
9469
  */
@@ -9387,9 +9883,15 @@ declare const searchMentions: <ThrowOnError extends boolean = false>(options?: O
9387
9883
  /**
9388
9884
  * Export mentions as CSV
9389
9885
  *
9390
- * The same mentions GET /v1/mentions would list for these filters, as CSV, newest matched first (the order they entered your feed, which can differ from the post date): id, published_at, platform, keyword, author, author_url, author_followers, relevance, sentiment, intents (pipe-separated), language, confidence, status, relevant, delivered, url, links (pipe-separated), text (first 1,000 characters), group, group_external_id, rating and app_id (app store reviews only), title and image_url (where the platform has them). Capped at 10,000 rows; the X-Mentions-Truncated header says when the cap cut the list. At most 6 exports per minute per workspace; a 429 carries Retry-After.
9886
+ * The same mentions GET /v1/mentions would list for these filters, as CSV, newest matched first (the order they entered your feed, which can differ from the post date): id, published_at, platform, keyword, author, author_url, author_followers, relevance, sentiment, intents (pipe-separated), language, confidence, status, relevant, delivered, url, links (pipe-separated), text (first 1,000 characters), group, group_external_id, rating and app_id (app store reviews only), title and image_url (where the platform has them), kind (post or comment), parent_url (the post a comment answers) and comments (comments of it delivered to you). Capped at 10,000 rows; the X-Mentions-Truncated header says when the cap cut the list. At most 6 exports per minute per workspace; a 429 carries Retry-After.
9391
9887
  */
9392
9888
  declare const exportMentionsCsv: <ThrowOnError extends boolean = false>(options?: Options<ExportMentionsCsvData, ThrowOnError>) => RequestResult<ExportMentionsCsvResponses, ExportMentionsCsvErrors, ThrowOnError>;
9889
+ /**
9890
+ * List the comments of a mention
9891
+ *
9892
+ * The comments under a mention's post, newest first: every comment in the thread, whether or not it names your keyword. Read once, about a day after the post, for mentions scored relevant whose keyword has comments enabled (keywords.comments), on Hacker News, Bluesky, GitHub, Stack Overflow, DEV, YouTube and Reddit; empty before that and for other keywords. Each comment delivered costs $0.008 on the comments line of the bill, once per workspace. A comment that itself names one of your keywords is also a mention: `mentionId` links it. Two mentions of one post (two keywords) list the same thread.
9893
+ */
9894
+ declare const listMentionComments: <ThrowOnError extends boolean = false>(options: Options<ListMentionCommentsData, ThrowOnError>) => RequestResult<ListMentionCommentsResponses, ListMentionCommentsErrors, ThrowOnError>;
9393
9895
  /**
9394
9896
  * Export mentions as JSON
9395
9897
  *
@@ -9806,6 +10308,7 @@ declare const sdk_listInvoices: typeof listInvoices;
9806
10308
  declare const sdk_listKeywords: typeof listKeywords;
9807
10309
  declare const sdk_listLedger: typeof listLedger;
9808
10310
  declare const sdk_listMembers: typeof listMembers;
10311
+ declare const sdk_listMentionComments: typeof listMentionComments;
9809
10312
  declare const sdk_listPeople: typeof listPeople;
9810
10313
  declare const sdk_listPersonActivities: typeof listPersonActivities;
9811
10314
  declare const sdk_listSegments: typeof listSegments;
@@ -9835,7 +10338,7 @@ declare const sdk_updateSegment: typeof updateSegment;
9835
10338
  declare const sdk_updateView: typeof updateView;
9836
10339
  declare const sdk_whoami: typeof whoami;
9837
10340
  declare namespace sdk {
9838
- export { type sdk_Options as Options, sdk_createAlert as createAlert, sdk_createApiKey as createApiKey, sdk_createChannel as createChannel, sdk_createGroup as createGroup, sdk_createInvitation as createInvitation, sdk_createKeyword as createKeyword, sdk_createSegment as createSegment, sdk_createTopUp as createTopUp, sdk_createView as createView, sdk_deleteAlert as deleteAlert, sdk_deleteChannel as deleteChannel, sdk_deleteGroup as deleteGroup, sdk_deleteKeyword as deleteKeyword, sdk_deletePersonActivity as deletePersonActivity, sdk_deleteSegment as deleteSegment, sdk_deleteView as deleteView, sdk_dismissAttention as dismissAttention, sdk_exportMentionsCsv as exportMentionsCsv, sdk_exportMentionsJson as exportMentionsJson, sdk_exportPeopleCsv as exportPeopleCsv, sdk_getAlert as getAlert, sdk_getAnalyticsBreakdown as getAnalyticsBreakdown, sdk_getAnalyticsSeries as getAnalyticsSeries, sdk_getAnalyticsSummary as getAnalyticsSummary, sdk_getChannel as getChannel, sdk_getCompany as getCompany, sdk_getFilters as getFilters, sdk_getGroup as getGroup, sdk_getHealth as getHealth, sdk_getInvoiceUrl as getInvoiceUrl, sdk_getKeyword as getKeyword, sdk_getKeywordHealth as getKeywordHealth, sdk_getMention as getMention, sdk_getPerson as getPerson, sdk_getReviewsReport as getReviewsReport, sdk_getSegment as getSegment, sdk_getShareOfVoice as getShareOfVoice, sdk_getUsage as getUsage, sdk_getUsageBreakdown as getUsageBreakdown, sdk_getView as getView, sdk_getWallet as getWallet, sdk_listAlerts as listAlerts, sdk_listApiKeys as listApiKeys, sdk_listAttention as listAttention, sdk_listChannelDeliveries as listChannelDeliveries, sdk_listChannels as listChannels, sdk_listGroups as listGroups, sdk_listInvitations as listInvitations, sdk_listInvoices as listInvoices, sdk_listKeywords as listKeywords, sdk_listLedger as listLedger, sdk_listMembers as listMembers, sdk_listPeople as listPeople, sdk_listPersonActivities as listPersonActivities, sdk_listSegments as listSegments, sdk_listViews as listViews, sdk_logPersonActivity as logPersonActivity, sdk_mergePeople as mergePeople, sdk_muteAlertAuthors as muteAlertAuthors, sdk_removeMember as removeMember, sdk_revokeApiKey as revokeApiKey, sdk_revokeInvitation as revokeInvitation, sdk_rotateWebhookSecret as rotateWebhookSecret, sdk_runAlertDigest as runAlertDigest, sdk_searchMentions as searchMentions, sdk_splitPerson as splitPerson, sdk_testAlert as testAlert, sdk_testChannel as testChannel, sdk_unmuteAlertAuthors as unmuteAlertAuthors, sdk_updateAlert as updateAlert, sdk_updateChannel as updateChannel, sdk_updateCompany as updateCompany, sdk_updateFilters as updateFilters, sdk_updateGroup as updateGroup, sdk_updateKeyword as updateKeyword, sdk_updateMention as updateMention, sdk_updatePerson as updatePerson, sdk_updateSegment as updateSegment, sdk_updateView as updateView, sdk_whoami as whoami };
10341
+ export { type sdk_Options as Options, sdk_createAlert as createAlert, sdk_createApiKey as createApiKey, sdk_createChannel as createChannel, sdk_createGroup as createGroup, sdk_createInvitation as createInvitation, sdk_createKeyword as createKeyword, sdk_createSegment as createSegment, sdk_createTopUp as createTopUp, sdk_createView as createView, sdk_deleteAlert as deleteAlert, sdk_deleteChannel as deleteChannel, sdk_deleteGroup as deleteGroup, sdk_deleteKeyword as deleteKeyword, sdk_deletePersonActivity as deletePersonActivity, sdk_deleteSegment as deleteSegment, sdk_deleteView as deleteView, sdk_dismissAttention as dismissAttention, sdk_exportMentionsCsv as exportMentionsCsv, sdk_exportMentionsJson as exportMentionsJson, sdk_exportPeopleCsv as exportPeopleCsv, sdk_getAlert as getAlert, sdk_getAnalyticsBreakdown as getAnalyticsBreakdown, sdk_getAnalyticsSeries as getAnalyticsSeries, sdk_getAnalyticsSummary as getAnalyticsSummary, sdk_getChannel as getChannel, sdk_getCompany as getCompany, sdk_getFilters as getFilters, sdk_getGroup as getGroup, sdk_getHealth as getHealth, sdk_getInvoiceUrl as getInvoiceUrl, sdk_getKeyword as getKeyword, sdk_getKeywordHealth as getKeywordHealth, sdk_getMention as getMention, sdk_getPerson as getPerson, sdk_getReviewsReport as getReviewsReport, sdk_getSegment as getSegment, sdk_getShareOfVoice as getShareOfVoice, sdk_getUsage as getUsage, sdk_getUsageBreakdown as getUsageBreakdown, sdk_getView as getView, sdk_getWallet as getWallet, sdk_listAlerts as listAlerts, sdk_listApiKeys as listApiKeys, sdk_listAttention as listAttention, sdk_listChannelDeliveries as listChannelDeliveries, sdk_listChannels as listChannels, sdk_listGroups as listGroups, sdk_listInvitations as listInvitations, sdk_listInvoices as listInvoices, sdk_listKeywords as listKeywords, sdk_listLedger as listLedger, sdk_listMembers as listMembers, sdk_listMentionComments as listMentionComments, sdk_listPeople as listPeople, sdk_listPersonActivities as listPersonActivities, sdk_listSegments as listSegments, sdk_listViews as listViews, sdk_logPersonActivity as logPersonActivity, sdk_mergePeople as mergePeople, sdk_muteAlertAuthors as muteAlertAuthors, sdk_removeMember as removeMember, sdk_revokeApiKey as revokeApiKey, sdk_revokeInvitation as revokeInvitation, sdk_rotateWebhookSecret as rotateWebhookSecret, sdk_runAlertDigest as runAlertDigest, sdk_searchMentions as searchMentions, sdk_splitPerson as splitPerson, sdk_testAlert as testAlert, sdk_testChannel as testChannel, sdk_unmuteAlertAuthors as unmuteAlertAuthors, sdk_updateAlert as updateAlert, sdk_updateChannel as updateChannel, sdk_updateCompany as updateCompany, sdk_updateFilters as updateFilters, sdk_updateGroup as updateGroup, sdk_updateKeyword as updateKeyword, sdk_updateMention as updateMention, sdk_updatePerson as updatePerson, sdk_updateSegment as updateSegment, sdk_updateView as updateView, sdk_whoami as whoami };
9839
10342
  }
9840
10343
 
9841
10344
  /**
@@ -9863,4 +10366,4 @@ type Mentio = typeof sdk & {
9863
10366
  };
9864
10367
  declare function createMentio(options: MentioOptions): Mentio;
9865
10368
 
9866
- export { type Alert, type AnalyticsBreakdown, type AnalyticsSeries, type AnalyticsSummary, type AttentionItem, type Channel, type ChannelFailingEventData, type Client, type ClientOptions, type Company, type Config, type CreateAlertData, type CreateAlertError, type CreateAlertErrors, type CreateAlertResponse, type CreateAlertResponses, type CreateApiKeyData, type CreateApiKeyError, type CreateApiKeyErrors, type CreateApiKeyResponse, type CreateApiKeyResponses, type CreateChannelData, type CreateChannelError, type CreateChannelErrors, type CreateChannelResponse, type CreateChannelResponses, type CreateEmailChannel, type CreateGroupData, type CreateGroupError, type CreateGroupErrors, type CreateGroupResponse, type CreateGroupResponses, type CreateInvitationData, type CreateInvitationError, type CreateInvitationErrors, type CreateInvitationResponse, type CreateInvitationResponses, type CreateKeywordData, type CreateKeywordError, type CreateKeywordErrors, type CreateKeywordResponse, type CreateKeywordResponses, type CreateSegmentData, type CreateSegmentError, type CreateSegmentErrors, type CreateSegmentResponse, type CreateSegmentResponses, type CreateSlackChannel, type CreateTopUpData, type CreateTopUpError, type CreateTopUpErrors, type CreateTopUpResponse, type CreateTopUpResponses, type CreateViewData, type CreateViewError, type CreateViewErrors, type CreateViewResponse, type CreateViewResponses, type CreateWebhookChannel, DEFAULT_BASE_URL, type DeleteAlertData, type DeleteAlertError, type DeleteAlertErrors, type DeleteAlertResponse, type DeleteAlertResponses, type DeleteChannelData, type DeleteChannelError, type DeleteChannelErrors, type DeleteChannelResponse, type DeleteChannelResponses, type DeleteGroupData, type DeleteGroupError, type DeleteGroupErrors, type DeleteGroupResponse, type DeleteGroupResponses, type DeleteKeywordData, type DeleteKeywordError, type DeleteKeywordErrors, type DeleteKeywordResponse, type DeleteKeywordResponses, type DeletePersonActivityData, type DeletePersonActivityError, type DeletePersonActivityErrors, type DeletePersonActivityResponse, type DeletePersonActivityResponses, type DeleteSegmentData, type DeleteSegmentError, type DeleteSegmentErrors, type DeleteSegmentResponse, type DeleteSegmentResponses, type DeleteViewData, type DeleteViewError, type DeleteViewErrors, type DeleteViewResponse, type DeleteViewResponses, type DismissAttentionData, type DismissAttentionError, type DismissAttentionErrors, type DismissAttentionResponse, type DismissAttentionResponses, type EmailChannel, type ErrorResponse, type ExportMentionsCsvData, type ExportMentionsCsvError, type ExportMentionsCsvErrors, type ExportMentionsCsvResponse, type ExportMentionsCsvResponses, type ExportMentionsJsonData, type ExportMentionsJsonError, type ExportMentionsJsonErrors, type ExportMentionsJsonResponse, type ExportMentionsJsonResponses, type ExportPeopleCsvData, type ExportPeopleCsvError, type ExportPeopleCsvErrors, type ExportPeopleCsvResponse, type ExportPeopleCsvResponses, type FilterGroup, type GetAlertData, type GetAlertError, type GetAlertErrors, type GetAlertResponse, type GetAlertResponses, type GetAnalyticsBreakdownData, type GetAnalyticsBreakdownError, type GetAnalyticsBreakdownErrors, type GetAnalyticsBreakdownResponse, type GetAnalyticsBreakdownResponses, type GetAnalyticsSeriesData, type GetAnalyticsSeriesError, type GetAnalyticsSeriesErrors, type GetAnalyticsSeriesResponse, type GetAnalyticsSeriesResponses, type GetAnalyticsSummaryData, type GetAnalyticsSummaryError, type GetAnalyticsSummaryErrors, type GetAnalyticsSummaryResponse, type GetAnalyticsSummaryResponses, type GetChannelData, type GetChannelError, type GetChannelErrors, type GetChannelResponse, type GetChannelResponses, type GetCompanyData, type GetCompanyError, type GetCompanyErrors, type GetCompanyResponse, type GetCompanyResponses, type GetFiltersData, type GetFiltersError, type GetFiltersErrors, type GetFiltersResponse, type GetFiltersResponses, type GetGroupData, type GetGroupError, type GetGroupErrors, type GetGroupResponse, type GetGroupResponses, type GetHealthData, type GetHealthResponse, type GetHealthResponses, type GetInvoiceUrlData, type GetInvoiceUrlError, type GetInvoiceUrlErrors, type GetInvoiceUrlResponse, type GetInvoiceUrlResponses, type GetKeywordData, type GetKeywordError, type GetKeywordErrors, type GetKeywordHealthData, type GetKeywordHealthError, type GetKeywordHealthErrors, type GetKeywordHealthResponse, type GetKeywordHealthResponses, type GetKeywordResponse, type GetKeywordResponses, type GetMentionData, type GetMentionError, type GetMentionErrors, type GetMentionResponse, type GetMentionResponses, type GetPersonData, type GetPersonError, type GetPersonErrors, type GetPersonResponse, type GetPersonResponses, type GetReviewsReportData, type GetReviewsReportError, type GetReviewsReportErrors, type GetReviewsReportResponse, type GetReviewsReportResponses, type GetSegmentData, type GetSegmentError, type GetSegmentErrors, type GetSegmentResponse, type GetSegmentResponses, type GetShareOfVoiceData, type GetShareOfVoiceError, type GetShareOfVoiceErrors, type GetShareOfVoiceResponse, type GetShareOfVoiceResponses, type GetUsageBreakdownData, type GetUsageBreakdownError, type GetUsageBreakdownErrors, type GetUsageBreakdownResponse, type GetUsageBreakdownResponses, type GetUsageData, type GetUsageError, type GetUsageErrors, type GetUsageResponse, type GetUsageResponses, type GetViewData, type GetViewError, type GetViewErrors, type GetViewResponse, type GetViewResponses, type GetWalletData, type GetWalletError, type GetWalletErrors, type GetWalletResponse, type GetWalletResponses, type Group, type GroupRef, type Invitation, type InvoiceList, type Keyword, type KeywordHealth, type KeywordNoisyEventData, type KeywordSuggestion, type LedgerList, type ListAlertsData, type ListAlertsError, type ListAlertsErrors, type ListAlertsResponse, type ListAlertsResponses, type ListApiKeysData, type ListApiKeysError, type ListApiKeysErrors, type ListApiKeysResponse, type ListApiKeysResponses, type ListAttentionData, type ListAttentionError, type ListAttentionErrors, type ListAttentionResponse, type ListAttentionResponses, type ListChannelDeliveriesData, type ListChannelDeliveriesError, type ListChannelDeliveriesErrors, type ListChannelDeliveriesResponse, type ListChannelDeliveriesResponses, type ListChannelsData, type ListChannelsError, type ListChannelsErrors, type ListChannelsResponse, type ListChannelsResponses, type ListGroupsData, type ListGroupsError, type ListGroupsErrors, type ListGroupsResponse, type ListGroupsResponses, type ListInvitationsData, type ListInvitationsError, type ListInvitationsErrors, type ListInvitationsResponse, type ListInvitationsResponses, type ListInvoicesData, type ListInvoicesError, type ListInvoicesErrors, type ListInvoicesResponse, type ListInvoicesResponses, type ListKeywordsData, type ListKeywordsError, type ListKeywordsErrors, type ListKeywordsResponse, type ListKeywordsResponses, type ListLedgerData, type ListLedgerError, type ListLedgerErrors, type ListLedgerResponse, type ListLedgerResponses, type ListMembersData, type ListMembersError, type ListMembersErrors, type ListMembersResponse, type ListMembersResponses, type ListPeopleData, type ListPeopleError, type ListPeopleErrors, type ListPeopleResponse, type ListPeopleResponses, type ListPersonActivitiesData, type ListPersonActivitiesError, type ListPersonActivitiesErrors, type ListPersonActivitiesResponse, type ListPersonActivitiesResponses, type ListSegmentsData, type ListSegmentsError, type ListSegmentsErrors, type ListSegmentsResponse, type ListSegmentsResponses, type ListViewsData, type ListViewsError, type ListViewsErrors, type ListViewsResponse, type ListViewsResponses, type LogPersonActivityData, type LogPersonActivityError, type LogPersonActivityErrors, type LogPersonActivityResponse, type LogPersonActivityResponses, type Member, type Mentio, type MentioOptions, type Mention, type MentionSpikeEventData, type MergePeopleData, type MergePeopleError, type MergePeopleErrors, type MergePeopleResponse, type MergePeopleResponses, type MuteAlertAuthorsData, type MuteAlertAuthorsError, type MuteAlertAuthorsErrors, type MuteAlertAuthorsResponse, type MuteAlertAuthorsResponses, type NegativeSpikeEventData, type Options, type Person, type PersonActivity, type RemoveMemberData, type RemoveMemberError, type RemoveMemberErrors, type RemoveMemberResponse, type RemoveMemberResponses, type RequestResult, type ReviewSource, type ReviewsReport, type RevokeApiKeyData, type RevokeApiKeyError, type RevokeApiKeyErrors, type RevokeApiKeyResponse, type RevokeApiKeyResponses, type RevokeInvitationData, type RevokeInvitationError, type RevokeInvitationErrors, type RevokeInvitationResponse, type RevokeInvitationResponses, type RotateWebhookSecretData, type RotateWebhookSecretError, type RotateWebhookSecretErrors, type RotateWebhookSecretResponse, type RotateWebhookSecretResponses, type RunAlertDigestData, type RunAlertDigestError, type RunAlertDigestErrors, type RunAlertDigestResponse, type RunAlertDigestResponses, type SearchMentionsData, type SearchMentionsError, type SearchMentionsErrors, type SearchMentionsResponse, type SearchMentionsResponses, type Segment, type ShareOfVoice, type SlackChannel, type SplitPersonData, type SplitPersonError, type SplitPersonErrors, type SplitPersonResponse, type SplitPersonResponses, type TelegramChannel, type TestAlertData, type TestAlertError, type TestAlertErrors, type TestAlertResponse, type TestAlertResponses, type TestChannelData, type TestChannelError, type TestChannelErrors, type TestChannelResponse, type TestChannelResponses, type UnmuteAlertAuthorsData, type UnmuteAlertAuthorsError, type UnmuteAlertAuthorsErrors, type UnmuteAlertAuthorsResponse, type UnmuteAlertAuthorsResponses, type UpdateAlertData, type UpdateAlertError, type UpdateAlertErrors, type UpdateAlertResponse, type UpdateAlertResponses, type UpdateChannelData, type UpdateChannelError, type UpdateChannelErrors, type UpdateChannelResponse, type UpdateChannelResponses, type UpdateCompanyData, type UpdateCompanyError, type UpdateCompanyErrors, type UpdateCompanyResponse, type UpdateCompanyResponses, type UpdateFiltersData, type UpdateFiltersError, type UpdateFiltersErrors, type UpdateFiltersResponse, type UpdateFiltersResponses, type UpdateGroupData, type UpdateGroupError, type UpdateGroupErrors, type UpdateGroupResponse, type UpdateGroupResponses, type UpdateKeywordData, type UpdateKeywordError, type UpdateKeywordErrors, type UpdateKeywordResponse, type UpdateKeywordResponses, type UpdateMentionData, type UpdateMentionError, type UpdateMentionErrors, type UpdateMentionResponse, type UpdateMentionResponses, type UpdatePersonData, type UpdatePersonError, type UpdatePersonErrors, type UpdatePersonResponse, type UpdatePersonResponses, type UpdateSegmentData, type UpdateSegmentError, type UpdateSegmentErrors, type UpdateSegmentResponse, type UpdateSegmentResponses, type UpdateViewData, type UpdateViewError, type UpdateViewErrors, type UpdateViewResponse, type UpdateViewResponses, type UsageBreakdown, type UsageSummary, type View, type Wallet, type WebhookChannel, type Whoami, type WhoamiData, type WhoamiError, type WhoamiErrors, type WhoamiResponse, type WhoamiResponses, type WorkspaceFilters, createAlert, createApiKey, createChannel, createClient, createConfig, createGroup, createInvitation, createKeyword, createMentio, createSegment, createTopUp, createView, deleteAlert, deleteChannel, deleteGroup, deleteKeyword, deletePersonActivity, deleteSegment, deleteView, dismissAttention, exportMentionsCsv, exportMentionsJson, exportPeopleCsv, getAlert, getAnalyticsBreakdown, getAnalyticsSeries, getAnalyticsSummary, getChannel, getCompany, getFilters, getGroup, getHealth, getInvoiceUrl, getKeyword, getKeywordHealth, getMention, getPerson, getReviewsReport, getSegment, getShareOfVoice, getUsage, getUsageBreakdown, getView, getWallet, listAlerts, listApiKeys, listAttention, listChannelDeliveries, listChannels, listGroups, listInvitations, listInvoices, listKeywords, listLedger, listMembers, listPeople, listPersonActivities, listSegments, listViews, logPersonActivity, mergePeople, muteAlertAuthors, removeMember, revokeApiKey, revokeInvitation, rotateWebhookSecret, runAlertDigest, searchMentions, splitPerson, testAlert, testChannel, unmuteAlertAuthors, updateAlert, updateChannel, updateCompany, updateFilters, updateGroup, updateKeyword, updateMention, updatePerson, updateSegment, updateView, whoami };
10369
+ export { type Alert, type AnalyticsBreakdown, type AnalyticsSeries, type AnalyticsSummary, type AttentionItem, type Channel, type ChannelFailingEventData, type Client, type ClientOptions, type Company, type Config, type CreateAlertData, type CreateAlertError, type CreateAlertErrors, type CreateAlertResponse, type CreateAlertResponses, type CreateApiKeyData, type CreateApiKeyError, type CreateApiKeyErrors, type CreateApiKeyResponse, type CreateApiKeyResponses, type CreateChannelData, type CreateChannelError, type CreateChannelErrors, type CreateChannelResponse, type CreateChannelResponses, type CreateEmailChannel, type CreateGroupData, type CreateGroupError, type CreateGroupErrors, type CreateGroupResponse, type CreateGroupResponses, type CreateInvitationData, type CreateInvitationError, type CreateInvitationErrors, type CreateInvitationResponse, type CreateInvitationResponses, type CreateKeywordData, type CreateKeywordError, type CreateKeywordErrors, type CreateKeywordResponse, type CreateKeywordResponses, type CreateSegmentData, type CreateSegmentError, type CreateSegmentErrors, type CreateSegmentResponse, type CreateSegmentResponses, type CreateSlackChannel, type CreateTopUpData, type CreateTopUpError, type CreateTopUpErrors, type CreateTopUpResponse, type CreateTopUpResponses, type CreateViewData, type CreateViewError, type CreateViewErrors, type CreateViewResponse, type CreateViewResponses, type CreateWebhookChannel, DEFAULT_BASE_URL, type DeleteAlertData, type DeleteAlertError, type DeleteAlertErrors, type DeleteAlertResponse, type DeleteAlertResponses, type DeleteChannelData, type DeleteChannelError, type DeleteChannelErrors, type DeleteChannelResponse, type DeleteChannelResponses, type DeleteGroupData, type DeleteGroupError, type DeleteGroupErrors, type DeleteGroupResponse, type DeleteGroupResponses, type DeleteKeywordData, type DeleteKeywordError, type DeleteKeywordErrors, type DeleteKeywordResponse, type DeleteKeywordResponses, type DeletePersonActivityData, type DeletePersonActivityError, type DeletePersonActivityErrors, type DeletePersonActivityResponse, type DeletePersonActivityResponses, type DeleteSegmentData, type DeleteSegmentError, type DeleteSegmentErrors, type DeleteSegmentResponse, type DeleteSegmentResponses, type DeleteViewData, type DeleteViewError, type DeleteViewErrors, type DeleteViewResponse, type DeleteViewResponses, type DismissAttentionData, type DismissAttentionError, type DismissAttentionErrors, type DismissAttentionResponse, type DismissAttentionResponses, type EmailChannel, type ErrorResponse, type ExportMentionsCsvData, type ExportMentionsCsvError, type ExportMentionsCsvErrors, type ExportMentionsCsvResponse, type ExportMentionsCsvResponses, type ExportMentionsJsonData, type ExportMentionsJsonError, type ExportMentionsJsonErrors, type ExportMentionsJsonResponse, type ExportMentionsJsonResponses, type ExportPeopleCsvData, type ExportPeopleCsvError, type ExportPeopleCsvErrors, type ExportPeopleCsvResponse, type ExportPeopleCsvResponses, type FilterGroup, type GetAlertData, type GetAlertError, type GetAlertErrors, type GetAlertResponse, type GetAlertResponses, type GetAnalyticsBreakdownData, type GetAnalyticsBreakdownError, type GetAnalyticsBreakdownErrors, type GetAnalyticsBreakdownResponse, type GetAnalyticsBreakdownResponses, type GetAnalyticsSeriesData, type GetAnalyticsSeriesError, type GetAnalyticsSeriesErrors, type GetAnalyticsSeriesResponse, type GetAnalyticsSeriesResponses, type GetAnalyticsSummaryData, type GetAnalyticsSummaryError, type GetAnalyticsSummaryErrors, type GetAnalyticsSummaryResponse, type GetAnalyticsSummaryResponses, type GetChannelData, type GetChannelError, type GetChannelErrors, type GetChannelResponse, type GetChannelResponses, type GetCompanyData, type GetCompanyError, type GetCompanyErrors, type GetCompanyResponse, type GetCompanyResponses, type GetFiltersData, type GetFiltersError, type GetFiltersErrors, type GetFiltersResponse, type GetFiltersResponses, type GetGroupData, type GetGroupError, type GetGroupErrors, type GetGroupResponse, type GetGroupResponses, type GetHealthData, type GetHealthResponse, type GetHealthResponses, type GetInvoiceUrlData, type GetInvoiceUrlError, type GetInvoiceUrlErrors, type GetInvoiceUrlResponse, type GetInvoiceUrlResponses, type GetKeywordData, type GetKeywordError, type GetKeywordErrors, type GetKeywordHealthData, type GetKeywordHealthError, type GetKeywordHealthErrors, type GetKeywordHealthResponse, type GetKeywordHealthResponses, type GetKeywordResponse, type GetKeywordResponses, type GetMentionData, type GetMentionError, type GetMentionErrors, type GetMentionResponse, type GetMentionResponses, type GetPersonData, type GetPersonError, type GetPersonErrors, type GetPersonResponse, type GetPersonResponses, type GetReviewsReportData, type GetReviewsReportError, type GetReviewsReportErrors, type GetReviewsReportResponse, type GetReviewsReportResponses, type GetSegmentData, type GetSegmentError, type GetSegmentErrors, type GetSegmentResponse, type GetSegmentResponses, type GetShareOfVoiceData, type GetShareOfVoiceError, type GetShareOfVoiceErrors, type GetShareOfVoiceResponse, type GetShareOfVoiceResponses, type GetUsageBreakdownData, type GetUsageBreakdownError, type GetUsageBreakdownErrors, type GetUsageBreakdownResponse, type GetUsageBreakdownResponses, type GetUsageData, type GetUsageError, type GetUsageErrors, type GetUsageResponse, type GetUsageResponses, type GetViewData, type GetViewError, type GetViewErrors, type GetViewResponse, type GetViewResponses, type GetWalletData, type GetWalletError, type GetWalletErrors, type GetWalletResponse, type GetWalletResponses, type Group, type GroupRef, type Invitation, type InvoiceList, type Keyword, type KeywordFeed, type KeywordHealth, type KeywordNoisyEventData, type KeywordSuggestion, type LedgerList, type ListAlertsData, type ListAlertsError, type ListAlertsErrors, type ListAlertsResponse, type ListAlertsResponses, type ListApiKeysData, type ListApiKeysError, type ListApiKeysErrors, type ListApiKeysResponse, type ListApiKeysResponses, type ListAttentionData, type ListAttentionError, type ListAttentionErrors, type ListAttentionResponse, type ListAttentionResponses, type ListChannelDeliveriesData, type ListChannelDeliveriesError, type ListChannelDeliveriesErrors, type ListChannelDeliveriesResponse, type ListChannelDeliveriesResponses, type ListChannelsData, type ListChannelsError, type ListChannelsErrors, type ListChannelsResponse, type ListChannelsResponses, type ListGroupsData, type ListGroupsError, type ListGroupsErrors, type ListGroupsResponse, type ListGroupsResponses, type ListInvitationsData, type ListInvitationsError, type ListInvitationsErrors, type ListInvitationsResponse, type ListInvitationsResponses, type ListInvoicesData, type ListInvoicesError, type ListInvoicesErrors, type ListInvoicesResponse, type ListInvoicesResponses, type ListKeywordsData, type ListKeywordsError, type ListKeywordsErrors, type ListKeywordsResponse, type ListKeywordsResponses, type ListLedgerData, type ListLedgerError, type ListLedgerErrors, type ListLedgerResponse, type ListLedgerResponses, type ListMembersData, type ListMembersError, type ListMembersErrors, type ListMembersResponse, type ListMembersResponses, type ListMentionCommentsData, type ListMentionCommentsError, type ListMentionCommentsErrors, type ListMentionCommentsResponse, type ListMentionCommentsResponses, type ListPeopleData, type ListPeopleError, type ListPeopleErrors, type ListPeopleResponse, type ListPeopleResponses, type ListPersonActivitiesData, type ListPersonActivitiesError, type ListPersonActivitiesErrors, type ListPersonActivitiesResponse, type ListPersonActivitiesResponses, type ListSegmentsData, type ListSegmentsError, type ListSegmentsErrors, type ListSegmentsResponse, type ListSegmentsResponses, type ListViewsData, type ListViewsError, type ListViewsErrors, type ListViewsResponse, type ListViewsResponses, type LogPersonActivityData, type LogPersonActivityError, type LogPersonActivityErrors, type LogPersonActivityResponse, type LogPersonActivityResponses, type Member, type Mentio, type MentioOptions, type Mention, type MentionComment, type MentionSpikeEventData, type MergePeopleData, type MergePeopleError, type MergePeopleErrors, type MergePeopleResponse, type MergePeopleResponses, type MuteAlertAuthorsData, type MuteAlertAuthorsError, type MuteAlertAuthorsErrors, type MuteAlertAuthorsResponse, type MuteAlertAuthorsResponses, type NegativeSpikeEventData, type Options, type Person, type PersonActivity, type RemoveMemberData, type RemoveMemberError, type RemoveMemberErrors, type RemoveMemberResponse, type RemoveMemberResponses, type RequestResult, type ReviewSource, type ReviewsReport, type RevokeApiKeyData, type RevokeApiKeyError, type RevokeApiKeyErrors, type RevokeApiKeyResponse, type RevokeApiKeyResponses, type RevokeInvitationData, type RevokeInvitationError, type RevokeInvitationErrors, type RevokeInvitationResponse, type RevokeInvitationResponses, type RotateWebhookSecretData, type RotateWebhookSecretError, type RotateWebhookSecretErrors, type RotateWebhookSecretResponse, type RotateWebhookSecretResponses, type RunAlertDigestData, type RunAlertDigestError, type RunAlertDigestErrors, type RunAlertDigestResponse, type RunAlertDigestResponses, type SearchMentionsData, type SearchMentionsError, type SearchMentionsErrors, type SearchMentionsResponse, type SearchMentionsResponses, type Segment, type ShareOfVoice, type SlackChannel, type SplitPersonData, type SplitPersonError, type SplitPersonErrors, type SplitPersonResponse, type SplitPersonResponses, type TelegramChannel, type TestAlertData, type TestAlertError, type TestAlertErrors, type TestAlertResponse, type TestAlertResponses, type TestChannelData, type TestChannelError, type TestChannelErrors, type TestChannelResponse, type TestChannelResponses, type UnmuteAlertAuthorsData, type UnmuteAlertAuthorsError, type UnmuteAlertAuthorsErrors, type UnmuteAlertAuthorsResponse, type UnmuteAlertAuthorsResponses, type UpdateAlertData, type UpdateAlertError, type UpdateAlertErrors, type UpdateAlertResponse, type UpdateAlertResponses, type UpdateChannelData, type UpdateChannelError, type UpdateChannelErrors, type UpdateChannelResponse, type UpdateChannelResponses, type UpdateCompanyData, type UpdateCompanyError, type UpdateCompanyErrors, type UpdateCompanyResponse, type UpdateCompanyResponses, type UpdateFiltersData, type UpdateFiltersError, type UpdateFiltersErrors, type UpdateFiltersResponse, type UpdateFiltersResponses, type UpdateGroupData, type UpdateGroupError, type UpdateGroupErrors, type UpdateGroupResponse, type UpdateGroupResponses, type UpdateKeywordData, type UpdateKeywordError, type UpdateKeywordErrors, type UpdateKeywordResponse, type UpdateKeywordResponses, type UpdateMentionData, type UpdateMentionError, type UpdateMentionErrors, type UpdateMentionResponse, type UpdateMentionResponses, type UpdatePersonData, type UpdatePersonError, type UpdatePersonErrors, type UpdatePersonResponse, type UpdatePersonResponses, type UpdateSegmentData, type UpdateSegmentError, type UpdateSegmentErrors, type UpdateSegmentResponse, type UpdateSegmentResponses, type UpdateViewData, type UpdateViewError, type UpdateViewErrors, type UpdateViewResponse, type UpdateViewResponses, type UsageBreakdown, type UsageSummary, type View, type Wallet, type WebhookChannel, type Whoami, type WhoamiData, type WhoamiError, type WhoamiErrors, type WhoamiResponse, type WhoamiResponses, type WorkspaceFilters, createAlert, createApiKey, createChannel, createClient, createConfig, createGroup, createInvitation, createKeyword, createMentio, createSegment, createTopUp, createView, deleteAlert, deleteChannel, deleteGroup, deleteKeyword, deletePersonActivity, deleteSegment, deleteView, dismissAttention, exportMentionsCsv, exportMentionsJson, exportPeopleCsv, getAlert, getAnalyticsBreakdown, getAnalyticsSeries, getAnalyticsSummary, getChannel, getCompany, getFilters, getGroup, getHealth, getInvoiceUrl, getKeyword, getKeywordHealth, getMention, getPerson, getReviewsReport, getSegment, getShareOfVoice, getUsage, getUsageBreakdown, getView, getWallet, listAlerts, listApiKeys, listAttention, listChannelDeliveries, listChannels, listGroups, listInvitations, listInvoices, listKeywords, listLedger, listMembers, listMentionComments, listPeople, listPersonActivities, listSegments, listViews, logPersonActivity, mergePeople, muteAlertAuthors, removeMember, revokeApiKey, revokeInvitation, rotateWebhookSecret, runAlertDigest, searchMentions, splitPerson, testAlert, testChannel, unmuteAlertAuthors, updateAlert, updateChannel, updateCompany, updateFilters, updateGroup, updateKeyword, updateMention, updatePerson, updateSegment, updateView, whoami };