@getanyapi/sdk 0.9.2 → 0.9.6

package/dist/index.d.cts

@@ -65,6 +65,8 @@ interface RequestOptions {
     signal?: AbortSignal;
     /** Override the client maxRetries for this call. */
     maxRetries?: number;
+    /** Override the generated Idempotency-Key for this billed POST. */
+    idempotencyKey?: string;
 }
 /**
  * Client construction options. See SPEC 2.1.
@@ -76,10 +78,12 @@ interface ClientOptions {
     baseUrl?: string;
     /** Custom fetch implementation. Defaults to globalThis.fetch. */
     fetch?: typeof fetch;
-    /** Max retry attempts for retryable failures (429 + network). Default 2. */
+    /** Max retry attempts for retryable failures (429 + retry-safe network). Default 2. */
     maxRetries?: number;
     /** Per-request timeout in milliseconds. Default 60000. */
     timeoutMs?: number;
+    /** Send Idempotency-Key on billed POSTs. Default "auto"; use "off" as a kill switch. */
+    idempotency?: "auto" | "off";
 }
 /**
  * Account profile returned by /v1/me (internal-only fields dropped). See SPEC 2.7.
@@ -209,6 +213,7 @@ declare class AnyAPI$1 implements ClientCore {
     private readonly fetchImpl;
     private readonly maxRetries;
     private readonly timeoutMs;
+    private readonly idempotency;
     /**
      * The network seam the generated per-platform namespaces target. The base client IS a
      * ClientCore (it implements `run`), so the generated subclass hands `this._core` to each
@@ -245,6 +250,7 @@ declare class AnyAPI$1 implements ClientCore {
         timeoutMs: number;
         maxRetries: number;
         signal?: AbortSignal;
+        idempotencyKey?: string;
     }): Promise<T>;
     /** Internal accessor for GET helpers in account.ts (same base URL / machinery). */
     protected get gatewayBaseUrl(): string;
@@ -290,7 +296,9 @@ declare class AnyAPIError extends Error {
     readonly status: number;
     /** The x-request-id response header when present, else undefined. */
     readonly requestId?: string;
-    constructor(message: string, status: number, requestId?: string);
+    /** Stable gateway error code when the JSON body includes one, else undefined. */
+    readonly code?: string;
+    constructor(message: string, status: number, requestId?: string, code?: string);
 }
 /** HTTP 400. */
 declare class BadRequestError extends AnyAPIError {
@@ -2658,7 +2666,7 @@ declare class BlueskyNamespace {
     /**
      * Bluesky User Posts
      *
-     * List a Bluesky account's recent posts (text, author handle, like, reply, and repost counts) by handle as clean JSON, normalized across providers.
+     * List a Bluesky account's recent posts (text, author handle, like, reply, and repost counts) by handle as clean JSON.
      *
      * Price: $0.002 per request.
      *
@@ -3982,7 +3990,7 @@ interface EmailFindData {
  */
 interface EmailVerifyInput {
     /**
-     * The email address to verify (e.g. jane.doe@acme.com).
+     * The email address to verify (e.g. jane.doe@acme.com). Exactly one @, a dotted domain, no whitespace or angle brackets. Addresses on reserved, never-deliverable TLDs (.invalid, .test, .example, .localhost, .local, .internal, .blink) and HTML/JSON escape artifacts (a u003e prefix) are rejected locally with no charge.
      */
     email: string;
 }
@@ -4021,7 +4029,7 @@ interface EmailVerifyItem {
  */
 interface EmailVerifyData {
     /**
-     * Verification records: the email address with its deliverability verdict and syntax, domain, and mailbox check details. Populated whenever the provider has data for the entity.
+     * Verification records: the email address with its deliverability verdict and the domain, mailbox, and reputation signals behind it. A record is returned for every syntactically valid address, including ones the verdict marks undeliverable. Populated whenever the provider has data for the entity.
      */
     items: EmailVerifyItem[];
 }
@@ -4046,7 +4054,7 @@ declare class EmailNamespace {
     /**
      * Email Verifier
      *
-     * Verify any email address for deliverability: syntax, domain, and mailbox checks in one normalized response.
+     * Verify an email address for deliverability: a status verdict (valid, risky, or invalid) with domain, mailbox, catch-all, disposable, and role signals plus a confidence score. Malformed addresses are rejected by the input schema with no charge; every syntactically valid address returns a billed verdict, including undeliverable ones.
      *
      * Price: $0 per request plus $0.0008 per result (maximum $0.0008).
      *
@@ -4364,7 +4372,7 @@ interface FacebookCommentRepliesData {
  */
 interface FacebookCompanyAdsInput {
     /**
-     * Company name to search (e.g. "nike"). Provide either pageId or companyName.
+     * Company name to search (e.g. "nike"). Exact-match and case-sensitive against the Meta Ad Library index; an advertiser with no indexed page returns found:false.
      */
     companyName?: string;
     /**
@@ -5558,7 +5566,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Ad Search
      *
-     * 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.
+     * Search the Meta Ad Library by keyword and get matching ads (advertiser, creative text, CTA, platforms, and run dates) with cursor pagination.
      *
      * Price: $0.002 per request.
      *
@@ -5576,7 +5584,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Comment Replies
      *
-     * List the replies to a Facebook post comment (text, author, reactions, and timestamps) as normalized JSON at a.
+     * List the replies to a Facebook post comment (text, author, reactions, and timestamps) as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -5612,7 +5620,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Event Details
      *
-     * Fetch full details for a single Facebook event by ID or URL (name, schedule, venue, hosts, and attendance) as normalized JSON at a.
+     * Fetch full details for a single Facebook event by ID or URL (name, schedule, venue, hosts, and attendance) as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -5623,7 +5631,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Events
      *
-     * 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.
+     * List public Facebook events for a city or place by its events-page URL (event name, date, venue, and attendance) as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -5641,7 +5649,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Events Search
      *
-     * Search public Facebook events by keyword and get structured event records (name, schedule, venue, pricing, and attendance) as normalized JSON at a.
+     * Search public Facebook events by keyword and get structured event records (name, schedule, venue, pricing, and attendance) as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -5706,7 +5714,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Marketplace Item
      *
-     * Fetch full details for a single Facebook Marketplace listing by ID or URL (title, price, location, photos, and attributes) as normalized JSON at a.
+     * Fetch full details for a single Facebook Marketplace listing by ID or URL (title, price, location, photos, and attributes) as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -5717,7 +5725,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Marketplace Location Search
      *
-     * Resolve a place name to Facebook Marketplace locations with coordinates and metadata as normalized JSON at a.
+     * Resolve a place name to Facebook Marketplace locations with coordinates and metadata as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -5739,7 +5747,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Page Photos
      *
-     * Fetch recent photos posted by any public Facebook page or profile (image URLs, captions, and dimensions) as normalized JSON at a.
+     * Fetch recent photos posted by any public Facebook page or profile (image URLs, captions, and dimensions) as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -5757,7 +5765,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Post
      *
-     * Fetch a single Facebook post by URL with its text and engagement counts (likes, comments, shares, views), normalized across providers.
+     * Fetch a single Facebook post by URL with its text and engagement counts (likes, comments, shares, views).
      *
      * Price: $0.002 per request.
      *
@@ -5768,7 +5776,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Post Comments
      *
-     * List the comments on a Facebook post by URL with cursor pagination (text, author, reactions, reply count), normalized across providers.
+     * List the comments on a Facebook post by URL with cursor pagination (text, author, reactions, reply count).
      *
      * Price: $0.002 per request.
      *
@@ -5786,7 +5794,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Post Transcript
      *
-     * Get the spoken-word transcript of any public Facebook video post by URL as normalized JSON at a.
+     * Get the spoken-word transcript of any public Facebook video post by URL as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -5797,7 +5805,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Profile
      *
-     * Fetch a Facebook page's public profile (likes, followers, category, about) by URL or handle, normalized across providers.
+     * Fetch a Facebook page's public profile (likes, followers, category, about) by URL or handle.
      *
      * Price: $0.002 per request.
      *
@@ -5808,7 +5816,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Page Events
      *
-     * List upcoming and past events hosted by any public Facebook page by URL (name, schedule, venue, and host) as normalized JSON at a.
+     * List upcoming and past events hosted by any public Facebook page by URL (name, schedule, venue, and host) as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -5826,7 +5834,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Profile Posts
      *
-     * List a Facebook page's recent posts by URL or page id with cursor pagination (text, author, permalink), normalized across providers.
+     * List a Facebook page's recent posts by URL or page id with cursor pagination (text, author, permalink).
      *
      * Price: $0.002 per request.
      *
@@ -5837,7 +5845,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Profile Reels
      *
-     * List a Facebook page's reels by URL with cursor pagination (caption, view count, permalink, thumbnail), normalized across providers.
+     * List a Facebook page's reels by URL with cursor pagination (caption, view count, permalink, thumbnail).
      *
      * Price: $0.002 per request.
      *
@@ -5859,7 +5867,7 @@ declare class FacebookNamespace {
     /**
      * Facebook Page Search
      *
-     * Search Facebook Pages by keyword, optionally narrowed to a location, and get structured page profiles (name, category, followers, contact details) at a.
+     * Search Facebook Pages by keyword, optionally narrowed to a location, and get structured page profiles (name, category, followers, contact details).
      *
      * Price: $0.001 per request plus $0.011 per result (maximum $0.111).
      *
@@ -6551,7 +6559,7 @@ declare class GithubNamespace {
     /**
      * GitHub Repository
      *
-     * Fetch a GitHub repository's metadata by URL (stars, forks, language, topics, license, and timestamps), normalized across providers with transparent failover.
+     * Fetch a GitHub repository's metadata by URL (stars, forks, language, topics, license, and timestamps).
      *
      * Price: $0.002 per request.
      *
@@ -6573,7 +6581,7 @@ declare class GithubNamespace {
     /**
      * GitHub Trending Repositories
      *
-     * List GitHub Trending repositories (rank, stars, stars gained today, language, and description), filterable by language and time window, normalized across providers.
+     * List GitHub Trending repositories (rank, stars, stars gained today, language, and description), filterable by language and time window.
      *
      * Price: $0.002 per request.
      *
@@ -6584,7 +6592,7 @@ declare class GithubNamespace {
     /**
      * GitHub User
      *
-     * Fetch a GitHub user's public profile by handle (name, bio, company, location, followers, and repo counts), normalized across providers with transparent failover.
+     * Fetch a GitHub user's public profile by handle (name, bio, company, location, followers, and repo counts).
      *
      * Price: $0.002 per request.
      *
@@ -6613,7 +6621,7 @@ declare class GithubNamespace {
     /**
      * GitHub User Contributions
      *
-     * 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.
+     * Fetch a GitHub user's contribution graph for a year (total contributions plus per-day counts and heatmap intensity).
      *
      * Price: $0.002 per request.
      *
@@ -6678,7 +6686,7 @@ declare class GithubNamespace {
     /**
      * GitHub User Repositories
      *
-     * List a GitHub user's public repositories (name, description, language, stars, and forks) with sorting and cursor pagination, normalized across providers.
+     * List a GitHub user's public repositories (name, description, language, stars, and forks) with sorting and cursor pagination.
      *
      * Price: $0.002 per request.
      *
@@ -9400,7 +9408,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Reels by Audio
      *
-     * List Instagram reels that use a given audio track by audio id, normalized across providers with transparent failover.
+     * List Instagram reels that use a given audio track by audio id.
      *
      * Price: $0.002 per request.
      *
@@ -9418,7 +9426,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Basic Profile
      *
-     * Fetch an Instagram account's core public profile fields (followers, posts, bio, verification) by user id, normalized across providers with transparent failover.
+     * Fetch an Instagram account's core public profile fields (followers, posts, bio, verification) by user id.
      *
      * Price: $0.002 per request.
      *
@@ -9429,7 +9437,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Profile Embed
      *
-     * Fetch the public embed HTML for an Instagram profile by handle, normalized across providers with transparent failover.
+     * Fetch the public embed HTML for an Instagram profile by handle.
      *
      * Price: $0.002 per request.
      *
@@ -9476,7 +9484,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Hashtag Analytics
      *
-     * Get analytics for any Instagram hashtag (total post count, related hashtags, and usage signals), normalized.
+     * Get analytics for any Instagram hashtag (total post count, related hashtags, and usage signals).
      *
      * Price: $0.001 per request plus $0.0017 per result (maximum $0.035).
      *
@@ -9487,7 +9495,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Highlight Detail
      *
-     * Fetch the details and media items of a single Instagram story highlight by id, normalized across providers with transparent failover.
+     * Fetch the details and media items of a single Instagram story highlight by id.
      *
      * Price: $0.002 per request.
      *
@@ -9498,7 +9506,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Media Transcript
      *
-     * Get the spoken-audio transcript text for an Instagram post or reel by URL, normalized across providers with transparent failover.
+     * Get the spoken-audio transcript text for an Instagram post or reel by URL.
      *
      * Price: $0.002 per request.
      *
@@ -9509,7 +9517,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Post
      *
-     * Fetch a single Instagram post or reel by URL (media URLs, like count, owner, type) as normalized JSON, across providers with transparent failover.
+     * Fetch a single Instagram post or reel by URL (media URLs, like count, owner, type) as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -9520,7 +9528,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Post Comments
      *
-     * List the comments on an Instagram post or reel by URL with cursor pagination (text, author, likes), normalized across providers.
+     * List the comments on an Instagram post or reel by URL with cursor pagination (text, author, likes).
      *
      * Price: $0.002 per request.
      *
@@ -9531,7 +9539,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Profile
      *
-     * Fetch an Instagram account's public profile (followers, posts, bio, verification) by handle, normalized across providers with transparent failover.
+     * Fetch an Instagram account's public profile (followers, posts, bio, verification) by handle.
      *
      * Price: $0.002 per request.
      *
@@ -9553,7 +9561,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Reels Search
      *
-     * Search Instagram Reels by keyword and get matching reels (caption, views, likes, creator, and duration), normalized across providers with transparent failover.
+     * 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).
      *
      * Price: $0.002 per request.
      *
@@ -9575,7 +9583,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Hashtag Search
      *
-     * List recent Instagram posts under a hashtag (caption, type, media URL), normalized across providers with transparent failover.
+     * 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.
      *
      * Price: $0.002 per request.
      *
@@ -9586,7 +9594,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Profile Search
      *
-     * Search public Instagram profiles by a bio or caption keyword, normalized across providers with transparent failover.
+     * Search public Instagram profiles by a bio or caption keyword.
      *
      * Price: $0.002 per request.
      *
@@ -9626,7 +9634,7 @@ declare class InstagramNamespace {
     /**
      * Instagram Trending Reels
      *
-     * List currently trending Instagram reels, normalized across providers with transparent failover.
+     * List currently trending Instagram reels.
      *
      * Price: $0.002 per request.
      *
@@ -9637,7 +9645,7 @@ declare class InstagramNamespace {
     /**
      * Instagram User Highlights
      *
-     * List an Instagram account's story highlight reels by handle, normalized across providers with transparent failover.
+     * List an Instagram account's story highlight reels by handle.
      *
      * Price: $0.002 per request.
      *
@@ -9648,7 +9656,7 @@ declare class InstagramNamespace {
     /**
      * Instagram User Posts
      *
-     * List an Instagram account's recent posts (likes, comments, captions) by handle with cursor pagination, normalized across providers.
+     * List an Instagram account's recent posts (likes, comments, captions) by handle with cursor pagination.
      *
      * Price: $0.002 per request.
      *
@@ -9666,7 +9674,7 @@ declare class InstagramNamespace {
     /**
      * Instagram User Reels
      *
-     * List an Instagram account's reels by handle with cursor pagination (caption, plays, likes, comments), normalized across providers.
+     * List an Instagram account's reels by handle with cursor pagination (caption, plays, likes, comments).
      *
      * Price: $0.002 per request.
      *
@@ -11928,7 +11936,7 @@ declare class LinkedinNamespace {
     /**
      * LinkedIn Post
      *
-     * Fetch a single LinkedIn post or article by URL (title, text, author, like and comment counts, publish date), normalized across providers.
+     * Fetch a single LinkedIn post or article by URL (title, text, author, like and comment counts, publish date).
      *
      * Price: $0.001 per request.
      *
@@ -12005,7 +12013,7 @@ declare class LinkedinNamespace {
     /**
      * LinkedIn Post Search
      *
-     * Search public LinkedIn posts by keyword (text, link, publish date), normalized across providers with transparent failover.
+     * Search public LinkedIn posts by keyword (text, link, publish date).
      *
      * Price: $0.002 per request.
      *
@@ -13789,7 +13797,7 @@ declare class RedditNamespace {
     /**
      * Reddit Post Comments
      *
-     * List the top-level comments on a Reddit post by URL (author, body, score, timestamp), normalized across providers with transparent failover.
+     * List the top-level comments on a Reddit post by URL (author, body, score, timestamp).
      *
      * Price: $0.002 per request.
      *
@@ -13800,7 +13808,7 @@ declare class RedditNamespace {
     /**
      * Reddit Post Transcript
      *
-     * Extract the spoken transcript from a Reddit video post by URL, normalized across providers with transparent failover.
+     * Extract the spoken transcript from a Reddit video post by URL.
      *
      * Price: $0.002 per request.
      *
@@ -13811,7 +13819,7 @@ declare class RedditNamespace {
     /**
      * Reddit Search
      *
-     * Search Reddit posts across all subreddits by query, normalized across providers with transparent failover.
+     * Search Reddit posts across all subreddits by query.
      *
      * Price: $0.001 per request.
      *
@@ -13829,7 +13837,7 @@ declare class RedditNamespace {
     /**
      * Reddit Subreddit Details
      *
-     * Fetch a subreddit's metadata (weekly active users, description, and category), normalized across providers with transparent failover.
+     * Fetch a subreddit's metadata (weekly active users, description, and category).
      *
      * Price: $0.001 per request.
      *
@@ -13840,7 +13848,7 @@ declare class RedditNamespace {
     /**
      * Reddit Subreddit Posts
      *
-     * Fetch posts from a subreddit listing (hot, new, or top), normalized across providers with transparent failover.
+     * Fetch posts from a subreddit listing (hot, new, or top).
      *
      * Price: $0.002 per request.
      *
@@ -13851,7 +13859,7 @@ declare class RedditNamespace {
     /**
      * Reddit Subreddit Search
      *
-     * Search posts within a single subreddit by query, sort, and timeframe, normalized across providers with transparent failover.
+     * Search posts within a single subreddit by query, sort, and timeframe.
      *
      * Price: $0.002 per request.
      *
@@ -18064,7 +18072,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Ad Library Ad
      *
-     * Fetch full details for a single TikTok ad (brand, title, spend, CTR, objectives, landing page, and video info), normalized across providers with transparent failover.
+     * Fetch full details for a single TikTok ad (brand, title, spend, CTR, objectives, landing page, and video info).
      *
      * Price: $0.002 per request.
      *
@@ -18075,7 +18083,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Ad Library Search
      *
-     * Search TikTok's ad library by keyword (top ads with brand, title, spend, CTR, likes, and video info), normalized across providers with transparent failover.
+     * Search TikTok's ad library by keyword (top ads with brand, title, spend, CTR, likes, and video info).
      *
      * Price: $0.002 per request.
      *
@@ -18093,7 +18101,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Audience Demographics
      *
-     * Get the audience country breakdown (follower count and share per country) for a TikTok creator by handle, normalized across providers.
+     * Get the audience country breakdown (follower count and share per country) for a TikTok creator by handle.
      *
      * Price: $0.01625 per request.
      *
@@ -18104,7 +18112,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Comment Replies
      *
-     * List the replies to a TikTok comment with cursor pagination (text, author, likes), normalized across providers.
+     * List the replies to a TikTok comment with cursor pagination (text, author, likes).
      *
      * Price: $0.002 per request.
      *
@@ -18140,7 +18148,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Following
      *
-     * List the accounts a TikTok user follows (handle, display name, follower count, bio) by username, normalized across providers.
+     * List the accounts a TikTok user follows (handle, display name, follower count, bio) by username.
      *
      * Price: $0.002 per request.
      *
@@ -18151,7 +18159,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Hashtag Videos
      *
-     * List recent TikTok videos for a hashtag (creator, caption, views, likes, shares), normalized output.
+     * List recent TikTok videos for a hashtag (creator, caption, views, likes, shares).
      *
      * Price: $0.00325 per request.
      *
@@ -18162,7 +18170,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Live
      *
-     * Check whether a TikTok creator is live and get the current live room (title, viewers, start time) by handle, normalized across providers.
+     * Check whether a TikTok creator is live and get the current live room (title, viewers, start time) by handle.
      *
      * Price: $0.002 per request.
      *
@@ -18173,7 +18181,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Profile
      *
-     * Fetch a TikTok creator's public profile (followers, likes, bio, verification) by handle, normalized across providers with transparent failover.
+     * Fetch a TikTok creator's public profile (followers, likes, bio, verification) by handle.
      *
      * Price: $0.001 per request.
      *
@@ -18184,7 +18192,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Profile Region
      *
-     * Resolve the home region (country) of a TikTok creator by handle, normalized across providers with transparent failover.
+     * Resolve the home region (country) of a TikTok creator by handle.
      *
      * Price: $0.002 per request.
      *
@@ -18195,7 +18203,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Profile Videos
      *
-     * List a TikTok creator's recent videos (views, likes, comments) by handle with cursor pagination, normalized across providers.
+     * List a TikTok creator's recent videos (views, likes, comments) by handle with cursor pagination.
      *
      * Price: $0.001 per request.
      *
@@ -18213,7 +18221,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Hashtag Search
      *
-     * Search TikTok by hashtag and get matching videos (caption, views, likes, comments, shares) as normalized JSON, across providers with transparent failover.
+     * Search TikTok by hashtag and get matching videos (caption, views, likes, comments, shares) as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -18224,7 +18232,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Keyword Search
      *
-     * Search TikTok by keyword and get matching videos (caption, views, likes, comments, shares) as normalized JSON, across providers with transparent failover.
+     * Search TikTok by keyword and get matching videos (caption, views, likes, comments, shares) as normalized JSON.
      *
      * Price: $0.001 per request.
      *
@@ -18235,7 +18243,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Top Search
      *
-     * Search TikTok's top results for a keyword (caption, views, likes, comments, shares) with cursor pagination, normalized across providers.
+     * Search TikTok's top results for a keyword (caption, views, likes, comments, shares) with cursor pagination.
      *
      * Price: $0.002 per request.
      *
@@ -18253,7 +18261,7 @@ declare class TiktokNamespace {
     /**
      * TikTok User Search
      *
-     * Search TikTok accounts by keyword (handle, nickname, follower count) with cursor pagination, normalized across providers.
+     * Search TikTok accounts by keyword (handle, nickname, follower count) with cursor pagination.
      *
      * Price: $0.001 per request.
      *
@@ -18271,7 +18279,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Song
      *
-     * 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.
+     * Fetch details for a TikTok song or sound (title, author, duration, cover art, and how many videos use it).
      *
      * Price: $0.002 per request.
      *
@@ -18282,7 +18290,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Song Videos
      *
-     * List TikTok videos that use a given song or sound (with descriptions, authors, and engagement stats), normalized across providers with transparent failover.
+     * List TikTok videos that use a given song or sound (with descriptions, authors, and engagement stats).
      *
      * Price: $0.002 per request.
      *
@@ -18300,7 +18308,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Trending Feed
      *
-     * Get TikTok's trending feed for a region (caption, views, likes, comments, author) as normalized JSON, across providers with transparent failover.
+     * Get TikTok's trending feed for a region (caption, views, likes, comments, author) as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -18311,7 +18319,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Video
      *
-     * Fetch a single TikTok video by URL with its caption and engagement counts (views, likes, comments, shares, saves), normalized across providers with transparent failover.
+     * Fetch a single TikTok video by URL with its caption and engagement counts (views, likes, comments, shares, saves).
      *
      * Price: $0.001 per request.
      *
@@ -18322,7 +18330,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Video Comments
      *
-     * List the comments on a TikTok video by URL with cursor pagination (text, author, likes, reply count), normalized across providers.
+     * List the comments on a TikTok video by URL with cursor pagination (text, author, likes, reply count).
      *
      * Price: $0.002 per request.
      *
@@ -18340,7 +18348,7 @@ declare class TiktokNamespace {
     /**
      * TikTok Video Transcript
      *
-     * Fetch the spoken-word transcript of a TikTok video by URL, normalized across providers with transparent failover.
+     * Fetch the spoken-word transcript of a TikTok video by URL.
      *
      * Price: $0.002 per request.
      *
@@ -18676,7 +18684,7 @@ declare class TiktokShopNamespace {
     /**
      * TikTok Shop Product Reviews
      *
-     * Fetch customer reviews for a TikTok Shop product by URL (rating, text, reviewer, country, and verified-purchase flag), normalized across providers with transparent failover.
+     * Fetch customer reviews for a TikTok Shop product by URL (rating, text, reviewer, country, and verified-purchase flag).
      *
      * Price: $0.002 per request.
      *
@@ -18698,7 +18706,7 @@ declare class TiktokShopNamespace {
     /**
      * TikTok Shop Store Products
      *
-     * 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.
+     * List every product of a TikTok Shop store by URL (title, price, sales, and rating per product plus shop-level stats) with cursor pagination.
      *
      * Price: $0.002 per request.
      *
@@ -18716,7 +18724,7 @@ declare class TiktokShopNamespace {
     /**
      * TikTok Shop User Showcase
      *
-     * List the TikTok Shop products a creator showcases (title, price, rating, and sales per product), normalized across providers with transparent failover.
+     * List the TikTok Shop products a creator showcases (title, price, rating, and sales per product).
      *
      * Price: $0.002 per request.
      *
@@ -20126,7 +20134,7 @@ declare class TwitterNamespace {
     /**
      * Twitter Community
      *
-     * Fetch a Twitter/X community's public details (name, description, member count, join policy) by URL, normalized across providers with transparent failover.
+     * Fetch a Twitter/X community's public details (name, description, member count, join policy) by URL.
      *
      * Price: $0.002 per request.
      *
@@ -20137,7 +20145,7 @@ declare class TwitterNamespace {
     /**
      * Twitter Community Tweets
      *
-     * List recent tweets posted in a Twitter/X community by URL, normalized across providers with transparent failover.
+     * List recent tweets posted in a Twitter/X community by URL.
      *
      * Price: $0.002 per request.
      *
@@ -20184,7 +20192,7 @@ declare class TwitterNamespace {
     /**
      * Twitter Profile
      *
-     * Fetch a Twitter/X account's public profile (followers, tweets, bio, verification) by handle, normalized across providers with transparent failover.
+     * Fetch a Twitter/X account's public profile (followers, tweets, bio, verification) by handle.
      *
      * Price: $0.00075 per request.
      *
@@ -20235,7 +20243,7 @@ declare class TwitterNamespace {
     /**
      * Twitter Tweet
      *
-     * Fetch a single Twitter/X tweet by URL with its full text and engagement counts (likes, retweets, replies, quotes, bookmarks, views), normalized across providers.
+     * Fetch a single Twitter/X tweet by URL with its full text and engagement counts (likes, retweets, replies, quotes, bookmarks, views).
      *
      * Price: $0.00075 per request.
      *
@@ -20246,7 +20254,7 @@ declare class TwitterNamespace {
     /**
      * Twitter Tweet Transcript
      *
-     * Extract the spoken transcript from a Twitter/X video tweet by URL, normalized across providers with transparent failover.
+     * Extract the spoken transcript from a Twitter/X video tweet by URL.
      *
      * Price: $0.002 per request.
      *
@@ -22341,7 +22349,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Channel
      *
-     * Fetch a YouTube channel's stats (subscribers, video count, total views, description) by handle or channel ID, normalized across providers.
+     * Fetch a YouTube channel's stats (subscribers, video count, total views, description) by handle or channel ID.
      *
      * Price: $0.002 per request.
      *
@@ -22352,7 +22360,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Channel Community Posts
      *
-     * List a YouTube channel's community posts by handle or channel ID with cursor pagination (text, likes, image, publish time), normalized across providers.
+     * List a YouTube channel's community posts by handle or channel ID with cursor pagination (text, likes, image, publish time).
      *
      * Price: $0.002 per request.
      *
@@ -22370,7 +22378,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Channel Live Streams
      *
-     * 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.
+     * List a YouTube channel's live and past-live streams by handle or channel ID with cursor pagination (title, views, length, publish time).
      *
      * Price: $0.002 per request.
      *
@@ -22388,7 +22396,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Channel Playlists
      *
-     * List a YouTube channel's playlists by handle or channel ID with cursor pagination (title, video count, thumbnail), normalized across providers.
+     * List a YouTube channel's playlists by handle or channel ID with cursor pagination (title, video count, thumbnail).
      *
      * Price: $0.002 per request.
      *
@@ -22406,7 +22414,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Channel Shorts
      *
-     * List a YouTube channel's Shorts by handle or channel ID with cursor pagination (title, views, likes, duration), normalized across providers.
+     * List a YouTube channel's Shorts by handle or channel ID with cursor pagination (title, views, likes, duration).
      *
      * Price: $0.002 per request.
      *
@@ -22424,7 +22432,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Channel Videos
      *
-     * List a YouTube channel's videos by handle or channel ID with cursor pagination (title, views, length, publish time), normalized across providers.
+     * List a YouTube channel's videos by handle or channel ID with cursor pagination (title, views, length, publish time).
      *
      * Price: $0.002 per request.
      *
@@ -22442,7 +22450,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Comment Replies
      *
-     * List replies to a YouTube comment using a continuation token with cursor pagination (text, author, likes, publish time), normalized across providers.
+     * List replies to a YouTube comment using a continuation token with cursor pagination (text, author, likes, publish time).
      *
      * Price: $0.002 per request.
      *
@@ -22453,7 +22461,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Community Post
      *
-     * Fetch a single YouTube community post by URL (text, images, channel, publish time), normalized across providers.
+     * Fetch a single YouTube community post by URL (text, images, channel, publish time).
      *
      * Price: $0.002 per request.
      *
@@ -22464,7 +22472,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Playlist
      *
-     * List every video in a YouTube playlist (title, length, and channel per video plus playlist owner and totals), normalized across providers with transparent failover.
+     * List every video in a YouTube playlist (title, length, and channel per video plus playlist owner and totals).
      *
      * Price: $0.002 per request.
      *
@@ -22475,7 +22483,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Search
      *
-     * Search YouTube and get matching videos (title, channel, views, length, publish time) as normalized JSON, across providers with transparent failover.
+     * Search YouTube and get matching videos (title, channel, views, length, publish time) as normalized JSON.
      *
      * Price: $0.002 per request.
      *
@@ -22486,7 +22494,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Hashtag Search
      *
-     * Search YouTube videos by hashtag with cursor pagination (title, channel, views, length, publish time), normalized across providers.
+     * Search YouTube videos by hashtag with cursor pagination (title, channel, views, length, publish time).
      *
      * Price: $0.002 per request.
      *
@@ -22504,7 +22512,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Trending Shorts
      *
-     * List currently trending YouTube Shorts (title, channel, views, likes, duration), normalized across providers.
+     * List currently trending YouTube Shorts (title, channel, views, likes, duration).
      *
      * Price: $0.002 per request.
      *
@@ -22515,7 +22523,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Video
      *
-     * Fetch a YouTube video's metadata (title, channel, views, likes, duration, publish date) by URL or ID, normalized across providers.
+     * Fetch a YouTube video's metadata (title, channel, views, likes, duration, publish date) by URL or ID.
      *
      * Price: $0.002 per request.
      *
@@ -22526,7 +22534,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Video Comments
      *
-     * List the comments on a YouTube video by URL with cursor pagination (text, author, likes, reply count), normalized across providers.
+     * List the comments on a YouTube video by URL with cursor pagination (text, author, likes, reply count).
      *
      * Price: $0.002 per request.
      *
@@ -22544,7 +22552,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Video Sponsors
      *
-     * Detect suspected sponsors and paid promotions in a YouTube video by URL (sponsor names, websites, confidence), normalized across providers.
+     * Detect suspected sponsors and paid promotions in a YouTube video by URL (sponsor names, websites, confidence).
      *
      * Price: $0.002 per request.
      *
@@ -22555,7 +22563,7 @@ declare class YoutubeNamespace {
     /**
      * YouTube Video Transcript
      *
-     * Fetch the transcript/captions of a YouTube video by URL or ID, normalized across providers with transparent failover.
+     * Fetch the transcript/captions of a YouTube video by URL or ID.
      *
      * Price: $0.002 per request.
      *
@@ -24764,7 +24772,7 @@ declare class AnyAPI extends AnyAPI$1 {
      * result type from the SkuMap; any other string returns RunResult<unknown>.
      */
     run<K extends keyof SkuMap>(slug: K, input: SkuMap[K]["input"], options?: RequestOptions): Promise<SkuMap[K]["result"]>;
-    run<S extends string, T = unknown>(slug: S extends keyof SkuMap ? never : S, input: unknown, options?: RequestOptions): Promise<RunResult<T>>;
+    run<T = unknown, S extends string = string>(slug: S extends keyof SkuMap ? never : S, input: unknown, options?: RequestOptions): Promise<RunResult<T>>;
     /**
      * Typed methods for the ahrefs platform.
      */