@getanyapi/sdk 0.9.5 → 0.9.7

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
@@ -10,6 +10,26 @@ interface RunResult<T> {
10
10
  costUsd: number;
11
11
  /** Number of result rows returned (present on per-result SKUs). */
12
12
  items?: number;
13
+ /**
14
+ * True when the gateway served a stored response for a repeated Idempotency-Key instead
15
+ * of running the SKU again. A replay is not billed twice. Always present on the wire.
16
+ *
17
+ * A replay whose stored payload is no longer retained (a 24h TTL expiry, or a payload
18
+ * that exceeded the storage size cap) arrives with the metadata only and `output` null,
19
+ * which {@link unwrap} rejects. See SPEC 2.3.
20
+ */
21
+ replayed: boolean;
22
+ /**
23
+ * Opaque handle to the full unshaped result, cached for about 15 minutes, so it can be
24
+ * re-read and re-shaped for free via GET /v1/results/{id}. Absent when the gateway did
25
+ * not cache the result.
26
+ */
27
+ resultId?: string;
28
+ /**
29
+ * Why a requested jq reshape did not apply. The run was still billed and `output` carries
30
+ * the full unshaped result. Absent when no jq was requested or it succeeded.
31
+ */
32
+ jqError?: string;
13
33
  /** Optional server nudge when a large result was returned untrimmed. */
14
34
  hint?: string;
15
35
  }
@@ -37,6 +57,26 @@ interface BareRunResult<T> {
37
57
  costUsd: number;
38
58
  /** Number of result rows returned (present on per-result SKUs). */
39
59
  items?: number;
60
+ /**
61
+ * True when the gateway served a stored response for a repeated Idempotency-Key instead
62
+ * of running the SKU again. A replay is not billed twice. Always present on the wire.
63
+ *
64
+ * A replay whose stored payload is no longer retained (a 24h TTL expiry, or a payload
65
+ * that exceeded the storage size cap) arrives with the metadata only and `output` null,
66
+ * which {@link unwrap} rejects. See SPEC 2.3.
67
+ */
68
+ replayed: boolean;
69
+ /**
70
+ * Opaque handle to the full unshaped result, cached for about 15 minutes, so it can be
71
+ * re-read and re-shaped for free via GET /v1/results/{id}. Absent when the gateway did
72
+ * not cache the result.
73
+ */
74
+ resultId?: string;
75
+ /**
76
+ * Why a requested jq reshape did not apply. The run was still billed and `output` carries
77
+ * the full unshaped result. Absent when no jq was requested or it succeeded.
78
+ */
79
+ jqError?: string;
40
80
  /** Optional server nudge when a large result was returned untrimmed. */
41
81
  hint?: string;
42
82
  }
@@ -45,7 +85,10 @@ interface BareRunResult<T> {
45
85
  * matching entity. Narrows Output<T> to T.
46
86
  *
47
87
  * Two overloads: a found-data RunResult may be empty (throws when found is false); a bare
48
- * result always carries its data (returns output directly, never throws).
88
+ * result always carries its data (returns output directly).
89
+ *
90
+ * Either shape throws AnyAPIError when `output` is null: an idempotent replay can outlive
91
+ * its stored payload, and the caller must not receive `null` typed as T. See SPEC 2.3.
49
92
  */
50
93
  declare function unwrap<T>(result: BareRunResult<T>): T;
51
94
  declare function unwrap<T>(result: RunResult<T>): T;
@@ -2666,7 +2709,7 @@ declare class BlueskyNamespace {
2666
2709
  /**
2667
2710
  * Bluesky User Posts
2668
2711
  *
2669
- * List a Bluesky account's recent posts (text, author handle, like, reply, and repost counts) by handle as clean JSON, normalized across providers.
2712
+ * List a Bluesky account's recent posts (text, author handle, like, reply, and repost counts) by handle as clean JSON.
2670
2713
  *
2671
2714
  * Price: $0.002 per request.
2672
2715
  *
@@ -5566,7 +5609,7 @@ declare class FacebookNamespace {
5566
5609
  /**
5567
5610
  * Facebook Ad Search
5568
5611
  *
5569
- * Search the Meta Ad Library by keyword and get matching ads (advertiser, creative text, CTA, platforms, and run dates) with cursor pagination and transparent failover.
5612
+ * Search the Meta Ad Library by keyword and get matching ads (advertiser, creative text, CTA, platforms, and run dates) with cursor pagination.
5570
5613
  *
5571
5614
  * Price: $0.002 per request.
5572
5615
  *
@@ -5584,7 +5627,7 @@ declare class FacebookNamespace {
5584
5627
  /**
5585
5628
  * Facebook Comment Replies
5586
5629
  *
5587
- * List the replies to a Facebook post comment (text, author, reactions, and timestamps) as normalized JSON at a.
5630
+ * List the replies to a Facebook post comment (text, author, reactions, and timestamps) as normalized JSON.
5588
5631
  *
5589
5632
  * Price: $0.002 per request.
5590
5633
  *
@@ -5620,7 +5663,7 @@ declare class FacebookNamespace {
5620
5663
  /**
5621
5664
  * Facebook Event Details
5622
5665
  *
5623
- * Fetch full details for a single Facebook event by ID or URL (name, schedule, venue, hosts, and attendance) as normalized JSON at a.
5666
+ * Fetch full details for a single Facebook event by ID or URL (name, schedule, venue, hosts, and attendance) as normalized JSON.
5624
5667
  *
5625
5668
  * Price: $0.002 per request.
5626
5669
  *
@@ -5631,7 +5674,7 @@ declare class FacebookNamespace {
5631
5674
  /**
5632
5675
  * Facebook Events
5633
5676
  *
5634
- * List public Facebook events for a city or place by its events-page URL (event name, date, venue, and attendance) as normalized JSON at a.
5677
+ * List public Facebook events for a city or place by its events-page URL (event name, date, venue, and attendance) as normalized JSON.
5635
5678
  *
5636
5679
  * Price: $0.002 per request.
5637
5680
  *
@@ -5649,7 +5692,7 @@ declare class FacebookNamespace {
5649
5692
  /**
5650
5693
  * Facebook Events Search
5651
5694
  *
5652
- * Search public Facebook events by keyword and get structured event records (name, schedule, venue, pricing, and attendance) as normalized JSON at a.
5695
+ * Search public Facebook events by keyword and get structured event records (name, schedule, venue, pricing, and attendance) as normalized JSON.
5653
5696
  *
5654
5697
  * Price: $0.002 per request.
5655
5698
  *
@@ -5714,7 +5757,7 @@ declare class FacebookNamespace {
5714
5757
  /**
5715
5758
  * Facebook Marketplace Item
5716
5759
  *
5717
- * Fetch full details for a single Facebook Marketplace listing by ID or URL (title, price, location, photos, and attributes) as normalized JSON at a.
5760
+ * Fetch full details for a single Facebook Marketplace listing by ID or URL (title, price, location, photos, and attributes) as normalized JSON.
5718
5761
  *
5719
5762
  * Price: $0.002 per request.
5720
5763
  *
@@ -5725,7 +5768,7 @@ declare class FacebookNamespace {
5725
5768
  /**
5726
5769
  * Facebook Marketplace Location Search
5727
5770
  *
5728
- * Resolve a place name to Facebook Marketplace locations with coordinates and metadata as normalized JSON at a.
5771
+ * Resolve a place name to Facebook Marketplace locations with coordinates and metadata as normalized JSON.
5729
5772
  *
5730
5773
  * Price: $0.002 per request.
5731
5774
  *
@@ -5747,7 +5790,7 @@ declare class FacebookNamespace {
5747
5790
  /**
5748
5791
  * Facebook Page Photos
5749
5792
  *
5750
- * Fetch recent photos posted by any public Facebook page or profile (image URLs, captions, and dimensions) as normalized JSON at a.
5793
+ * Fetch recent photos posted by any public Facebook page or profile (image URLs, captions, and dimensions) as normalized JSON.
5751
5794
  *
5752
5795
  * Price: $0.002 per request.
5753
5796
  *
@@ -5765,7 +5808,7 @@ declare class FacebookNamespace {
5765
5808
  /**
5766
5809
  * Facebook Post
5767
5810
  *
5768
- * Fetch a single Facebook post by URL with its text and engagement counts (likes, comments, shares, views), normalized across providers.
5811
+ * Fetch a single Facebook post by URL with its text and engagement counts (likes, comments, shares, views).
5769
5812
  *
5770
5813
  * Price: $0.002 per request.
5771
5814
  *
@@ -5776,7 +5819,7 @@ declare class FacebookNamespace {
5776
5819
  /**
5777
5820
  * Facebook Post Comments
5778
5821
  *
5779
- * List the comments on a Facebook post by URL with cursor pagination (text, author, reactions, reply count), normalized across providers.
5822
+ * List the comments on a Facebook post by URL with cursor pagination (text, author, reactions, reply count).
5780
5823
  *
5781
5824
  * Price: $0.002 per request.
5782
5825
  *
@@ -5794,7 +5837,7 @@ declare class FacebookNamespace {
5794
5837
  /**
5795
5838
  * Facebook Post Transcript
5796
5839
  *
5797
- * Get the spoken-word transcript of any public Facebook video post by URL as normalized JSON at a.
5840
+ * Get the spoken-word transcript of any public Facebook video post by URL as normalized JSON.
5798
5841
  *
5799
5842
  * Price: $0.002 per request.
5800
5843
  *
@@ -5805,7 +5848,7 @@ declare class FacebookNamespace {
5805
5848
  /**
5806
5849
  * Facebook Profile
5807
5850
  *
5808
- * Fetch a Facebook page's public profile (likes, followers, category, about) by URL or handle, normalized across providers.
5851
+ * Fetch a Facebook page's public profile (likes, followers, category, about) by URL or handle.
5809
5852
  *
5810
5853
  * Price: $0.002 per request.
5811
5854
  *
@@ -5816,7 +5859,7 @@ declare class FacebookNamespace {
5816
5859
  /**
5817
5860
  * Facebook Page Events
5818
5861
  *
5819
- * List upcoming and past events hosted by any public Facebook page by URL (name, schedule, venue, and host) as normalized JSON at a.
5862
+ * List upcoming and past events hosted by any public Facebook page by URL (name, schedule, venue, and host) as normalized JSON.
5820
5863
  *
5821
5864
  * Price: $0.002 per request.
5822
5865
  *
@@ -5834,7 +5877,7 @@ declare class FacebookNamespace {
5834
5877
  /**
5835
5878
  * Facebook Profile Posts
5836
5879
  *
5837
- * List a Facebook page's recent posts by URL or page id with cursor pagination (text, author, permalink), normalized across providers.
5880
+ * List a Facebook page's recent posts by URL or page id with cursor pagination (text, author, permalink).
5838
5881
  *
5839
5882
  * Price: $0.002 per request.
5840
5883
  *
@@ -5845,7 +5888,7 @@ declare class FacebookNamespace {
5845
5888
  /**
5846
5889
  * Facebook Profile Reels
5847
5890
  *
5848
- * List a Facebook page's reels by URL with cursor pagination (caption, view count, permalink, thumbnail), normalized across providers.
5891
+ * List a Facebook page's reels by URL with cursor pagination (caption, view count, permalink, thumbnail).
5849
5892
  *
5850
5893
  * Price: $0.002 per request.
5851
5894
  *
@@ -5867,7 +5910,7 @@ declare class FacebookNamespace {
5867
5910
  /**
5868
5911
  * Facebook Page Search
5869
5912
  *
5870
- * Search Facebook Pages by keyword, optionally narrowed to a location, and get structured page profiles (name, category, followers, contact details) at a.
5913
+ * Search Facebook Pages by keyword, optionally narrowed to a location, and get structured page profiles (name, category, followers, contact details).
5871
5914
  *
5872
5915
  * Price: $0.001 per request plus $0.011 per result (maximum $0.111).
5873
5916
  *
@@ -6559,7 +6602,7 @@ declare class GithubNamespace {
6559
6602
  /**
6560
6603
  * GitHub Repository
6561
6604
  *
6562
- * Fetch a GitHub repository's metadata by URL (stars, forks, language, topics, license, and timestamps), normalized across providers with transparent failover.
6605
+ * Fetch a GitHub repository's metadata by URL (stars, forks, language, topics, license, and timestamps).
6563
6606
  *
6564
6607
  * Price: $0.002 per request.
6565
6608
  *
@@ -6581,7 +6624,7 @@ declare class GithubNamespace {
6581
6624
  /**
6582
6625
  * GitHub Trending Repositories
6583
6626
  *
6584
- * List GitHub Trending repositories (rank, stars, stars gained today, language, and description), filterable by language and time window, normalized across providers.
6627
+ * List GitHub Trending repositories (rank, stars, stars gained today, language, and description), filterable by language and time window.
6585
6628
  *
6586
6629
  * Price: $0.002 per request.
6587
6630
  *
@@ -6592,7 +6635,7 @@ declare class GithubNamespace {
6592
6635
  /**
6593
6636
  * GitHub User
6594
6637
  *
6595
- * Fetch a GitHub user's public profile by handle (name, bio, company, location, followers, and repo counts), normalized across providers with transparent failover.
6638
+ * Fetch a GitHub user's public profile by handle (name, bio, company, location, followers, and repo counts).
6596
6639
  *
6597
6640
  * Price: $0.002 per request.
6598
6641
  *
@@ -6621,7 +6664,7 @@ declare class GithubNamespace {
6621
6664
  /**
6622
6665
  * GitHub User Contributions
6623
6666
  *
6624
- * Fetch a GitHub user's contribution graph for a year (total contributions plus per-day counts and heatmap intensity), normalized across providers with transparent failover.
6667
+ * Fetch a GitHub user's contribution graph for a year (total contributions plus per-day counts and heatmap intensity).
6625
6668
  *
6626
6669
  * Price: $0.002 per request.
6627
6670
  *
@@ -6686,7 +6729,7 @@ declare class GithubNamespace {
6686
6729
  /**
6687
6730
  * GitHub User Repositories
6688
6731
  *
6689
- * List a GitHub user's public repositories (name, description, language, stars, and forks) with sorting and cursor pagination, normalized across providers.
6732
+ * List a GitHub user's public repositories (name, description, language, stars, and forks) with sorting and cursor pagination.
6690
6733
  *
6691
6734
  * Price: $0.002 per request.
6692
6735
  *
@@ -9408,7 +9451,7 @@ declare class InstagramNamespace {
9408
9451
  /**
9409
9452
  * Instagram Reels by Audio
9410
9453
  *
9411
- * List Instagram reels that use a given audio track by audio id, normalized across providers with transparent failover.
9454
+ * List Instagram reels that use a given audio track by audio id.
9412
9455
  *
9413
9456
  * Price: $0.002 per request.
9414
9457
  *
@@ -9426,7 +9469,7 @@ declare class InstagramNamespace {
9426
9469
  /**
9427
9470
  * Instagram Basic Profile
9428
9471
  *
9429
- * Fetch an Instagram account's core public profile fields (followers, posts, bio, verification) by user id, normalized across providers with transparent failover.
9472
+ * Fetch an Instagram account's core public profile fields (followers, posts, bio, verification) by user id.
9430
9473
  *
9431
9474
  * Price: $0.002 per request.
9432
9475
  *
@@ -9437,7 +9480,7 @@ declare class InstagramNamespace {
9437
9480
  /**
9438
9481
  * Instagram Profile Embed
9439
9482
  *
9440
- * Fetch the public embed HTML for an Instagram profile by handle, normalized across providers with transparent failover.
9483
+ * Fetch the public embed HTML for an Instagram profile by handle.
9441
9484
  *
9442
9485
  * Price: $0.002 per request.
9443
9486
  *
@@ -9484,7 +9527,7 @@ declare class InstagramNamespace {
9484
9527
  /**
9485
9528
  * Instagram Hashtag Analytics
9486
9529
  *
9487
- * Get analytics for any Instagram hashtag (total post count, related hashtags, and usage signals), normalized.
9530
+ * Get analytics for any Instagram hashtag (total post count, related hashtags, and usage signals).
9488
9531
  *
9489
9532
  * Price: $0.001 per request plus $0.0017 per result (maximum $0.035).
9490
9533
  *
@@ -9495,7 +9538,7 @@ declare class InstagramNamespace {
9495
9538
  /**
9496
9539
  * Instagram Highlight Detail
9497
9540
  *
9498
- * Fetch the details and media items of a single Instagram story highlight by id, normalized across providers with transparent failover.
9541
+ * Fetch the details and media items of a single Instagram story highlight by id.
9499
9542
  *
9500
9543
  * Price: $0.002 per request.
9501
9544
  *
@@ -9506,7 +9549,7 @@ declare class InstagramNamespace {
9506
9549
  /**
9507
9550
  * Instagram Media Transcript
9508
9551
  *
9509
- * Get the spoken-audio transcript text for an Instagram post or reel by URL, normalized across providers with transparent failover.
9552
+ * Get the spoken-audio transcript text for an Instagram post or reel by URL.
9510
9553
  *
9511
9554
  * Price: $0.002 per request.
9512
9555
  *
@@ -9517,7 +9560,7 @@ declare class InstagramNamespace {
9517
9560
  /**
9518
9561
  * Instagram Post
9519
9562
  *
9520
- * Fetch a single Instagram post or reel by URL (media URLs, like count, owner, type) as normalized JSON, across providers with transparent failover.
9563
+ * Fetch a single Instagram post or reel by URL (media URLs, like count, owner, type) as normalized JSON.
9521
9564
  *
9522
9565
  * Price: $0.002 per request.
9523
9566
  *
@@ -9528,7 +9571,7 @@ declare class InstagramNamespace {
9528
9571
  /**
9529
9572
  * Instagram Post Comments
9530
9573
  *
9531
- * List the comments on an Instagram post or reel by URL with cursor pagination (text, author, likes), normalized across providers.
9574
+ * List the comments on an Instagram post or reel by URL with cursor pagination (text, author, likes).
9532
9575
  *
9533
9576
  * Price: $0.002 per request.
9534
9577
  *
@@ -9539,7 +9582,7 @@ declare class InstagramNamespace {
9539
9582
  /**
9540
9583
  * Instagram Profile
9541
9584
  *
9542
- * Fetch an Instagram account's public profile (followers, posts, bio, verification) by handle, normalized across providers with transparent failover.
9585
+ * Fetch an Instagram account's public profile (followers, posts, bio, verification) by handle.
9543
9586
  *
9544
9587
  * Price: $0.002 per request.
9545
9588
  *
@@ -9561,7 +9604,7 @@ declare class InstagramNamespace {
9561
9604
  /**
9562
9605
  * Instagram Reels Search
9563
9606
  *
9564
- * Search Instagram Reels by keyword and get matching reels (caption, views, likes, creator, and duration), normalized across providers with transparent failover.
9607
+ * Search Instagram Reels by keyword and get matching reels (caption, views, likes, creator, and duration). Paging tops out around 110 reels per query (11 pages of 10).
9565
9608
  *
9566
9609
  * Price: $0.002 per request.
9567
9610
  *
@@ -9583,7 +9626,7 @@ declare class InstagramNamespace {
9583
9626
  /**
9584
9627
  * Instagram Hashtag Search
9585
9628
  *
9586
- * List recent Instagram posts under a hashtag (caption, type, media URL), normalized across providers with transparent failover.
9629
+ * Search Instagram posts under a hashtag (caption, type, media URL). Results are relevance-ranked by Instagram, not date-ordered, so a page can mix recent and older posts.
9587
9630
  *
9588
9631
  * Price: $0.002 per request.
9589
9632
  *
@@ -9594,7 +9637,7 @@ declare class InstagramNamespace {
9594
9637
  /**
9595
9638
  * Instagram Profile Search
9596
9639
  *
9597
- * Search public Instagram profiles by a bio or caption keyword, normalized across providers with transparent failover.
9640
+ * Search public Instagram profiles by a bio or caption keyword.
9598
9641
  *
9599
9642
  * Price: $0.002 per request.
9600
9643
  *
@@ -9634,7 +9677,7 @@ declare class InstagramNamespace {
9634
9677
  /**
9635
9678
  * Instagram Trending Reels
9636
9679
  *
9637
- * List currently trending Instagram reels, normalized across providers with transparent failover.
9680
+ * List currently trending Instagram reels.
9638
9681
  *
9639
9682
  * Price: $0.002 per request.
9640
9683
  *
@@ -9645,7 +9688,7 @@ declare class InstagramNamespace {
9645
9688
  /**
9646
9689
  * Instagram User Highlights
9647
9690
  *
9648
- * List an Instagram account's story highlight reels by handle, normalized across providers with transparent failover.
9691
+ * List an Instagram account's story highlight reels by handle.
9649
9692
  *
9650
9693
  * Price: $0.002 per request.
9651
9694
  *
@@ -9656,7 +9699,7 @@ declare class InstagramNamespace {
9656
9699
  /**
9657
9700
  * Instagram User Posts
9658
9701
  *
9659
- * List an Instagram account's recent posts (likes, comments, captions) by handle with cursor pagination, normalized across providers.
9702
+ * List an Instagram account's recent posts (likes, comments, captions) by handle with cursor pagination.
9660
9703
  *
9661
9704
  * Price: $0.002 per request.
9662
9705
  *
@@ -9674,7 +9717,7 @@ declare class InstagramNamespace {
9674
9717
  /**
9675
9718
  * Instagram User Reels
9676
9719
  *
9677
- * List an Instagram account's reels by handle with cursor pagination (caption, plays, likes, comments), normalized across providers.
9720
+ * List an Instagram account's reels by handle with cursor pagination (caption, plays, likes, comments).
9678
9721
  *
9679
9722
  * Price: $0.002 per request.
9680
9723
  *
@@ -11936,7 +11979,7 @@ declare class LinkedinNamespace {
11936
11979
  /**
11937
11980
  * LinkedIn Post
11938
11981
  *
11939
- * Fetch a single LinkedIn post or article by URL (title, text, author, like and comment counts, publish date), normalized across providers.
11982
+ * Fetch a single LinkedIn post or article by URL (title, text, author, like and comment counts, publish date).
11940
11983
  *
11941
11984
  * Price: $0.001 per request.
11942
11985
  *
@@ -12013,7 +12056,7 @@ declare class LinkedinNamespace {
12013
12056
  /**
12014
12057
  * LinkedIn Post Search
12015
12058
  *
12016
- * Search public LinkedIn posts by keyword (text, link, publish date), normalized across providers with transparent failover.
12059
+ * Search public LinkedIn posts by keyword (text, link, publish date).
12017
12060
  *
12018
12061
  * Price: $0.002 per request.
12019
12062
  *
@@ -13797,7 +13840,7 @@ declare class RedditNamespace {
13797
13840
  /**
13798
13841
  * Reddit Post Comments
13799
13842
  *
13800
- * List the top-level comments on a Reddit post by URL (author, body, score, timestamp), normalized across providers with transparent failover.
13843
+ * List the top-level comments on a Reddit post by URL (author, body, score, timestamp).
13801
13844
  *
13802
13845
  * Price: $0.002 per request.
13803
13846
  *
@@ -13808,7 +13851,7 @@ declare class RedditNamespace {
13808
13851
  /**
13809
13852
  * Reddit Post Transcript
13810
13853
  *
13811
- * Extract the spoken transcript from a Reddit video post by URL, normalized across providers with transparent failover.
13854
+ * Extract the spoken transcript from a Reddit video post by URL.
13812
13855
  *
13813
13856
  * Price: $0.002 per request.
13814
13857
  *
@@ -13819,7 +13862,7 @@ declare class RedditNamespace {
13819
13862
  /**
13820
13863
  * Reddit Search
13821
13864
  *
13822
- * Search Reddit posts across all subreddits by query, normalized across providers with transparent failover.
13865
+ * Search Reddit posts across all subreddits by query.
13823
13866
  *
13824
13867
  * Price: $0.001 per request.
13825
13868
  *
@@ -13837,7 +13880,7 @@ declare class RedditNamespace {
13837
13880
  /**
13838
13881
  * Reddit Subreddit Details
13839
13882
  *
13840
- * Fetch a subreddit's metadata (weekly active users, description, and category), normalized across providers with transparent failover.
13883
+ * Fetch a subreddit's metadata (weekly active users, description, and category).
13841
13884
  *
13842
13885
  * Price: $0.001 per request.
13843
13886
  *
@@ -13848,7 +13891,7 @@ declare class RedditNamespace {
13848
13891
  /**
13849
13892
  * Reddit Subreddit Posts
13850
13893
  *
13851
- * Fetch posts from a subreddit listing (hot, new, or top), normalized across providers with transparent failover.
13894
+ * Fetch posts from a subreddit listing (hot, new, or top).
13852
13895
  *
13853
13896
  * Price: $0.002 per request.
13854
13897
  *
@@ -13859,7 +13902,7 @@ declare class RedditNamespace {
13859
13902
  /**
13860
13903
  * Reddit Subreddit Search
13861
13904
  *
13862
- * Search posts within a single subreddit by query, sort, and timeframe, normalized across providers with transparent failover.
13905
+ * Search posts within a single subreddit by query, sort, and timeframe.
13863
13906
  *
13864
13907
  * Price: $0.002 per request.
13865
13908
  *
@@ -18072,7 +18115,7 @@ declare class TiktokNamespace {
18072
18115
  /**
18073
18116
  * TikTok Ad Library Ad
18074
18117
  *
18075
- * Fetch full details for a single TikTok ad (brand, title, spend, CTR, objectives, landing page, and video info), normalized across providers with transparent failover.
18118
+ * Fetch full details for a single TikTok ad (brand, title, spend, CTR, objectives, landing page, and video info).
18076
18119
  *
18077
18120
  * Price: $0.002 per request.
18078
18121
  *
@@ -18083,7 +18126,7 @@ declare class TiktokNamespace {
18083
18126
  /**
18084
18127
  * TikTok Ad Library Search
18085
18128
  *
18086
- * Search TikTok's ad library by keyword (top ads with brand, title, spend, CTR, likes, and video info), normalized across providers with transparent failover.
18129
+ * Search TikTok's ad library by keyword (top ads with brand, title, spend, CTR, likes, and video info).
18087
18130
  *
18088
18131
  * Price: $0.002 per request.
18089
18132
  *
@@ -18101,7 +18144,7 @@ declare class TiktokNamespace {
18101
18144
  /**
18102
18145
  * TikTok Audience Demographics
18103
18146
  *
18104
- * Get the audience country breakdown (follower count and share per country) for a TikTok creator by handle, normalized across providers.
18147
+ * Get the audience country breakdown (follower count and share per country) for a TikTok creator by handle.
18105
18148
  *
18106
18149
  * Price: $0.01625 per request.
18107
18150
  *
@@ -18112,7 +18155,7 @@ declare class TiktokNamespace {
18112
18155
  /**
18113
18156
  * TikTok Comment Replies
18114
18157
  *
18115
- * List the replies to a TikTok comment with cursor pagination (text, author, likes), normalized across providers.
18158
+ * List the replies to a TikTok comment with cursor pagination (text, author, likes).
18116
18159
  *
18117
18160
  * Price: $0.002 per request.
18118
18161
  *
@@ -18148,7 +18191,7 @@ declare class TiktokNamespace {
18148
18191
  /**
18149
18192
  * TikTok Following
18150
18193
  *
18151
- * List the accounts a TikTok user follows (handle, display name, follower count, bio) by username, normalized across providers.
18194
+ * List the accounts a TikTok user follows (handle, display name, follower count, bio) by username.
18152
18195
  *
18153
18196
  * Price: $0.002 per request.
18154
18197
  *
@@ -18159,7 +18202,7 @@ declare class TiktokNamespace {
18159
18202
  /**
18160
18203
  * TikTok Hashtag Videos
18161
18204
  *
18162
- * List recent TikTok videos for a hashtag (creator, caption, views, likes, shares), normalized output.
18205
+ * List recent TikTok videos for a hashtag (creator, caption, views, likes, shares).
18163
18206
  *
18164
18207
  * Price: $0.00325 per request.
18165
18208
  *
@@ -18170,7 +18213,7 @@ declare class TiktokNamespace {
18170
18213
  /**
18171
18214
  * TikTok Live
18172
18215
  *
18173
- * Check whether a TikTok creator is live and get the current live room (title, viewers, start time) by handle, normalized across providers.
18216
+ * Check whether a TikTok creator is live and get the current live room (title, viewers, start time) by handle.
18174
18217
  *
18175
18218
  * Price: $0.002 per request.
18176
18219
  *
@@ -18181,7 +18224,7 @@ declare class TiktokNamespace {
18181
18224
  /**
18182
18225
  * TikTok Profile
18183
18226
  *
18184
- * Fetch a TikTok creator's public profile (followers, likes, bio, verification) by handle, normalized across providers with transparent failover.
18227
+ * Fetch a TikTok creator's public profile (followers, likes, bio, verification) by handle.
18185
18228
  *
18186
18229
  * Price: $0.001 per request.
18187
18230
  *
@@ -18192,7 +18235,7 @@ declare class TiktokNamespace {
18192
18235
  /**
18193
18236
  * TikTok Profile Region
18194
18237
  *
18195
- * Resolve the home region (country) of a TikTok creator by handle, normalized across providers with transparent failover.
18238
+ * Resolve the home region (country) of a TikTok creator by handle.
18196
18239
  *
18197
18240
  * Price: $0.002 per request.
18198
18241
  *
@@ -18203,7 +18246,7 @@ declare class TiktokNamespace {
18203
18246
  /**
18204
18247
  * TikTok Profile Videos
18205
18248
  *
18206
- * List a TikTok creator's recent videos (views, likes, comments) by handle with cursor pagination, normalized across providers.
18249
+ * List a TikTok creator's recent videos (views, likes, comments) by handle with cursor pagination.
18207
18250
  *
18208
18251
  * Price: $0.001 per request.
18209
18252
  *
@@ -18221,7 +18264,7 @@ declare class TiktokNamespace {
18221
18264
  /**
18222
18265
  * TikTok Hashtag Search
18223
18266
  *
18224
- * Search TikTok by hashtag and get matching videos (caption, views, likes, comments, shares) as normalized JSON, across providers with transparent failover.
18267
+ * Search TikTok by hashtag and get matching videos (caption, views, likes, comments, shares) as normalized JSON.
18225
18268
  *
18226
18269
  * Price: $0.002 per request.
18227
18270
  *
@@ -18232,7 +18275,7 @@ declare class TiktokNamespace {
18232
18275
  /**
18233
18276
  * TikTok Keyword Search
18234
18277
  *
18235
- * Search TikTok by keyword and get matching videos (caption, views, likes, comments, shares) as normalized JSON, across providers with transparent failover.
18278
+ * Search TikTok by keyword and get matching videos (caption, views, likes, comments, shares) as normalized JSON.
18236
18279
  *
18237
18280
  * Price: $0.001 per request.
18238
18281
  *
@@ -18243,7 +18286,7 @@ declare class TiktokNamespace {
18243
18286
  /**
18244
18287
  * TikTok Top Search
18245
18288
  *
18246
- * Search TikTok's top results for a keyword (caption, views, likes, comments, shares) with cursor pagination, normalized across providers.
18289
+ * Search TikTok's top results for a keyword (caption, views, likes, comments, shares) with cursor pagination.
18247
18290
  *
18248
18291
  * Price: $0.002 per request.
18249
18292
  *
@@ -18261,7 +18304,7 @@ declare class TiktokNamespace {
18261
18304
  /**
18262
18305
  * TikTok User Search
18263
18306
  *
18264
- * Search TikTok accounts by keyword (handle, nickname, follower count) with cursor pagination, normalized across providers.
18307
+ * Search TikTok accounts by keyword (handle, nickname, follower count) with cursor pagination.
18265
18308
  *
18266
18309
  * Price: $0.001 per request.
18267
18310
  *
@@ -18279,7 +18322,7 @@ declare class TiktokNamespace {
18279
18322
  /**
18280
18323
  * TikTok Song
18281
18324
  *
18282
- * Fetch details for a TikTok song or sound (title, author, duration, cover art, and how many videos use it), normalized across providers with transparent failover.
18325
+ * Fetch details for a TikTok song or sound (title, author, duration, cover art, and how many videos use it).
18283
18326
  *
18284
18327
  * Price: $0.002 per request.
18285
18328
  *
@@ -18290,7 +18333,7 @@ declare class TiktokNamespace {
18290
18333
  /**
18291
18334
  * TikTok Song Videos
18292
18335
  *
18293
- * List TikTok videos that use a given song or sound (with descriptions, authors, and engagement stats), normalized across providers with transparent failover.
18336
+ * List TikTok videos that use a given song or sound (with descriptions, authors, and engagement stats).
18294
18337
  *
18295
18338
  * Price: $0.002 per request.
18296
18339
  *
@@ -18308,7 +18351,7 @@ declare class TiktokNamespace {
18308
18351
  /**
18309
18352
  * TikTok Trending Feed
18310
18353
  *
18311
- * Get TikTok's trending feed for a region (caption, views, likes, comments, author) as normalized JSON, across providers with transparent failover.
18354
+ * Get TikTok's trending feed for a region (caption, views, likes, comments, author) as normalized JSON.
18312
18355
  *
18313
18356
  * Price: $0.002 per request.
18314
18357
  *
@@ -18319,7 +18362,7 @@ declare class TiktokNamespace {
18319
18362
  /**
18320
18363
  * TikTok Video
18321
18364
  *
18322
- * Fetch a single TikTok video by URL with its caption and engagement counts (views, likes, comments, shares, saves), normalized across providers with transparent failover.
18365
+ * Fetch a single TikTok video by URL with its caption and engagement counts (views, likes, comments, shares, saves).
18323
18366
  *
18324
18367
  * Price: $0.001 per request.
18325
18368
  *
@@ -18330,7 +18373,7 @@ declare class TiktokNamespace {
18330
18373
  /**
18331
18374
  * TikTok Video Comments
18332
18375
  *
18333
- * List the comments on a TikTok video by URL with cursor pagination (text, author, likes, reply count), normalized across providers.
18376
+ * List the comments on a TikTok video by URL with cursor pagination (text, author, likes, reply count).
18334
18377
  *
18335
18378
  * Price: $0.002 per request.
18336
18379
  *
@@ -18348,7 +18391,7 @@ declare class TiktokNamespace {
18348
18391
  /**
18349
18392
  * TikTok Video Transcript
18350
18393
  *
18351
- * Fetch the spoken-word transcript of a TikTok video by URL, normalized across providers with transparent failover.
18394
+ * Fetch the spoken-word transcript of a TikTok video by URL.
18352
18395
  *
18353
18396
  * Price: $0.002 per request.
18354
18397
  *
@@ -18684,7 +18727,7 @@ declare class TiktokShopNamespace {
18684
18727
  /**
18685
18728
  * TikTok Shop Product Reviews
18686
18729
  *
18687
- * Fetch customer reviews for a TikTok Shop product by URL (rating, text, reviewer, country, and verified-purchase flag), normalized across providers with transparent failover.
18730
+ * Fetch customer reviews for a TikTok Shop product by URL (rating, text, reviewer, country, and verified-purchase flag).
18688
18731
  *
18689
18732
  * Price: $0.002 per request.
18690
18733
  *
@@ -18706,7 +18749,7 @@ declare class TiktokShopNamespace {
18706
18749
  /**
18707
18750
  * TikTok Shop Store Products
18708
18751
  *
18709
- * List every product of a TikTok Shop store by URL (title, price, sales, and rating per product plus shop-level stats) with cursor pagination and transparent failover.
18752
+ * List every product of a TikTok Shop store by URL (title, price, sales, and rating per product plus shop-level stats) with cursor pagination.
18710
18753
  *
18711
18754
  * Price: $0.002 per request.
18712
18755
  *
@@ -18724,7 +18767,7 @@ declare class TiktokShopNamespace {
18724
18767
  /**
18725
18768
  * TikTok Shop User Showcase
18726
18769
  *
18727
- * List the TikTok Shop products a creator showcases (title, price, rating, and sales per product), normalized across providers with transparent failover.
18770
+ * List the TikTok Shop products a creator showcases (title, price, rating, and sales per product).
18728
18771
  *
18729
18772
  * Price: $0.002 per request.
18730
18773
  *
@@ -20134,7 +20177,7 @@ declare class TwitterNamespace {
20134
20177
  /**
20135
20178
  * Twitter Community
20136
20179
  *
20137
- * Fetch a Twitter/X community's public details (name, description, member count, join policy) by URL, normalized across providers with transparent failover.
20180
+ * Fetch a Twitter/X community's public details (name, description, member count, join policy) by URL.
20138
20181
  *
20139
20182
  * Price: $0.002 per request.
20140
20183
  *
@@ -20145,7 +20188,7 @@ declare class TwitterNamespace {
20145
20188
  /**
20146
20189
  * Twitter Community Tweets
20147
20190
  *
20148
- * List recent tweets posted in a Twitter/X community by URL, normalized across providers with transparent failover.
20191
+ * List recent tweets posted in a Twitter/X community by URL.
20149
20192
  *
20150
20193
  * Price: $0.002 per request.
20151
20194
  *
@@ -20192,7 +20235,7 @@ declare class TwitterNamespace {
20192
20235
  /**
20193
20236
  * Twitter Profile
20194
20237
  *
20195
- * Fetch a Twitter/X account's public profile (followers, tweets, bio, verification) by handle, normalized across providers with transparent failover.
20238
+ * Fetch a Twitter/X account's public profile (followers, tweets, bio, verification) by handle.
20196
20239
  *
20197
20240
  * Price: $0.00075 per request.
20198
20241
  *
@@ -20243,7 +20286,7 @@ declare class TwitterNamespace {
20243
20286
  /**
20244
20287
  * Twitter Tweet
20245
20288
  *
20246
- * Fetch a single Twitter/X tweet by URL with its full text and engagement counts (likes, retweets, replies, quotes, bookmarks, views), normalized across providers.
20289
+ * Fetch a single Twitter/X tweet by URL with its full text and engagement counts (likes, retweets, replies, quotes, bookmarks, views).
20247
20290
  *
20248
20291
  * Price: $0.00075 per request.
20249
20292
  *
@@ -20254,7 +20297,7 @@ declare class TwitterNamespace {
20254
20297
  /**
20255
20298
  * Twitter Tweet Transcript
20256
20299
  *
20257
- * Extract the spoken transcript from a Twitter/X video tweet by URL, normalized across providers with transparent failover.
20300
+ * Extract the spoken transcript from a Twitter/X video tweet by URL.
20258
20301
  *
20259
20302
  * Price: $0.002 per request.
20260
20303
  *
@@ -22349,7 +22392,7 @@ declare class YoutubeNamespace {
22349
22392
  /**
22350
22393
  * YouTube Channel
22351
22394
  *
22352
- * Fetch a YouTube channel's stats (subscribers, video count, total views, description) by handle or channel ID, normalized across providers.
22395
+ * Fetch a YouTube channel's stats (subscribers, video count, total views, description) by handle or channel ID.
22353
22396
  *
22354
22397
  * Price: $0.002 per request.
22355
22398
  *
@@ -22360,7 +22403,7 @@ declare class YoutubeNamespace {
22360
22403
  /**
22361
22404
  * YouTube Channel Community Posts
22362
22405
  *
22363
- * List a YouTube channel's community posts by handle or channel ID with cursor pagination (text, likes, image, publish time), normalized across providers.
22406
+ * List a YouTube channel's community posts by handle or channel ID with cursor pagination (text, likes, image, publish time).
22364
22407
  *
22365
22408
  * Price: $0.002 per request.
22366
22409
  *
@@ -22378,7 +22421,7 @@ declare class YoutubeNamespace {
22378
22421
  /**
22379
22422
  * YouTube Channel Live Streams
22380
22423
  *
22381
- * List a YouTube channel's live and past-live streams by handle or channel ID with cursor pagination (title, views, length, publish time), normalized across providers.
22424
+ * List a YouTube channel's live and past-live streams by handle or channel ID with cursor pagination (title, views, length, publish time).
22382
22425
  *
22383
22426
  * Price: $0.002 per request.
22384
22427
  *
@@ -22396,7 +22439,7 @@ declare class YoutubeNamespace {
22396
22439
  /**
22397
22440
  * YouTube Channel Playlists
22398
22441
  *
22399
- * List a YouTube channel's playlists by handle or channel ID with cursor pagination (title, video count, thumbnail), normalized across providers.
22442
+ * List a YouTube channel's playlists by handle or channel ID with cursor pagination (title, video count, thumbnail).
22400
22443
  *
22401
22444
  * Price: $0.002 per request.
22402
22445
  *
@@ -22414,7 +22457,7 @@ declare class YoutubeNamespace {
22414
22457
  /**
22415
22458
  * YouTube Channel Shorts
22416
22459
  *
22417
- * List a YouTube channel's Shorts by handle or channel ID with cursor pagination (title, views, likes, duration), normalized across providers.
22460
+ * List a YouTube channel's Shorts by handle or channel ID with cursor pagination (title, views, likes, duration).
22418
22461
  *
22419
22462
  * Price: $0.002 per request.
22420
22463
  *
@@ -22432,7 +22475,7 @@ declare class YoutubeNamespace {
22432
22475
  /**
22433
22476
  * YouTube Channel Videos
22434
22477
  *
22435
- * List a YouTube channel's videos by handle or channel ID with cursor pagination (title, views, length, publish time), normalized across providers.
22478
+ * List a YouTube channel's videos by handle or channel ID with cursor pagination (title, views, length, publish time).
22436
22479
  *
22437
22480
  * Price: $0.002 per request.
22438
22481
  *
@@ -22450,7 +22493,7 @@ declare class YoutubeNamespace {
22450
22493
  /**
22451
22494
  * YouTube Comment Replies
22452
22495
  *
22453
- * List replies to a YouTube comment using a continuation token with cursor pagination (text, author, likes, publish time), normalized across providers.
22496
+ * List replies to a YouTube comment using a continuation token with cursor pagination (text, author, likes, publish time).
22454
22497
  *
22455
22498
  * Price: $0.002 per request.
22456
22499
  *
@@ -22461,7 +22504,7 @@ declare class YoutubeNamespace {
22461
22504
  /**
22462
22505
  * YouTube Community Post
22463
22506
  *
22464
- * Fetch a single YouTube community post by URL (text, images, channel, publish time), normalized across providers.
22507
+ * Fetch a single YouTube community post by URL (text, images, channel, publish time).
22465
22508
  *
22466
22509
  * Price: $0.002 per request.
22467
22510
  *
@@ -22472,7 +22515,7 @@ declare class YoutubeNamespace {
22472
22515
  /**
22473
22516
  * YouTube Playlist
22474
22517
  *
22475
- * List every video in a YouTube playlist (title, length, and channel per video plus playlist owner and totals), normalized across providers with transparent failover.
22518
+ * List every video in a YouTube playlist (title, length, and channel per video plus playlist owner and totals).
22476
22519
  *
22477
22520
  * Price: $0.002 per request.
22478
22521
  *
@@ -22483,7 +22526,7 @@ declare class YoutubeNamespace {
22483
22526
  /**
22484
22527
  * YouTube Search
22485
22528
  *
22486
- * Search YouTube and get matching videos (title, channel, views, length, publish time) as normalized JSON, across providers with transparent failover.
22529
+ * Search YouTube and get matching videos (title, channel, views, length, publish time) as normalized JSON.
22487
22530
  *
22488
22531
  * Price: $0.002 per request.
22489
22532
  *
@@ -22494,7 +22537,7 @@ declare class YoutubeNamespace {
22494
22537
  /**
22495
22538
  * YouTube Hashtag Search
22496
22539
  *
22497
- * Search YouTube videos by hashtag with cursor pagination (title, channel, views, length, publish time), normalized across providers.
22540
+ * Search YouTube videos by hashtag with cursor pagination (title, channel, views, length, publish time).
22498
22541
  *
22499
22542
  * Price: $0.002 per request.
22500
22543
  *
@@ -22512,7 +22555,7 @@ declare class YoutubeNamespace {
22512
22555
  /**
22513
22556
  * YouTube Trending Shorts
22514
22557
  *
22515
- * List currently trending YouTube Shorts (title, channel, views, likes, duration), normalized across providers.
22558
+ * List currently trending YouTube Shorts (title, channel, views, likes, duration).
22516
22559
  *
22517
22560
  * Price: $0.002 per request.
22518
22561
  *
@@ -22523,7 +22566,7 @@ declare class YoutubeNamespace {
22523
22566
  /**
22524
22567
  * YouTube Video
22525
22568
  *
22526
- * Fetch a YouTube video's metadata (title, channel, views, likes, duration, publish date) by URL or ID, normalized across providers.
22569
+ * Fetch a YouTube video's metadata (title, channel, views, likes, duration, publish date) by URL or ID.
22527
22570
  *
22528
22571
  * Price: $0.002 per request.
22529
22572
  *
@@ -22534,7 +22577,7 @@ declare class YoutubeNamespace {
22534
22577
  /**
22535
22578
  * YouTube Video Comments
22536
22579
  *
22537
- * List the comments on a YouTube video by URL with cursor pagination (text, author, likes, reply count), normalized across providers.
22580
+ * List the comments on a YouTube video by URL with cursor pagination (text, author, likes, reply count).
22538
22581
  *
22539
22582
  * Price: $0.002 per request.
22540
22583
  *
@@ -22552,7 +22595,7 @@ declare class YoutubeNamespace {
22552
22595
  /**
22553
22596
  * YouTube Video Sponsors
22554
22597
  *
22555
- * Detect suspected sponsors and paid promotions in a YouTube video by URL (sponsor names, websites, confidence), normalized across providers.
22598
+ * Detect suspected sponsors and paid promotions in a YouTube video by URL (sponsor names, websites, confidence).
22556
22599
  *
22557
22600
  * Price: $0.002 per request.
22558
22601
  *
@@ -22563,7 +22606,7 @@ declare class YoutubeNamespace {
22563
22606
  /**
22564
22607
  * YouTube Video Transcript
22565
22608
  *
22566
- * Fetch the transcript/captions of a YouTube video by URL or ID, normalized across providers with transparent failover.
22609
+ * Fetch the transcript/captions of a YouTube video by URL or ID.
22567
22610
  *
22568
22611
  * Price: $0.002 per request.
22569
22612
  *