@getanyapi/sdk 0.35.3 → 0.37.0

package/dist/index.cjs

@@ -897,9 +897,22 @@ var AnyAPI = class {
     );
     return mapCatalogList(raw);
   }
-  /** Ranked catalog search. GET /catalog/search. Browse never accepts a query. */
+  /**
+   * Ranked catalog search. GET /catalog/search. Browse never accepts a query.
+   *
+   * The gateway needs at least one of query, category or platform, in any
+   * combination, so a scope with no query at all is a valid search. An absent or
+   * empty query omits `q` entirely, because an empty `q` is a different request.
+   */
   async search(options) {
-    const search = new URLSearchParams({ q: options.query });
+    if (!options.query && !options.category && !options.platform) {
+      throw new AnyAPIError(
+        "search needs at least one of query, category, or platform",
+        0
+      );
+    }
+    const search = new URLSearchParams();
+    if (options.query) search.set("q", options.query);
     if (options.category) search.set("category", options.category);
     if (options.platform) search.set("platform", options.platform);
     if (options.limit !== void 0) search.set("limit", String(options.limit));
@@ -3115,7 +3128,7 @@ var GoogleNamespace = class {
    *
    * Run a Google web search and get the organic results (title, link, snippet, position) as clean JSON. Returns about 10 results per call - Google stopped honoring bulk result counts in September 2025, so a limit above 10 is accepted but returns no more than a page. Pass the returned nextCursor back as cursor to walk further, or use google.search_100 for up to 100 ranked results in one call, which is cheaper past roughly 20 results.
    *
-   * Price: $0.00099 per request.
+   * Price: $0.0009 per request.
    *
    * @example
    * const res = await client.google.search({ query: "best coffee maker", gl: "us", hl: "en", limit: 10 });
@@ -3616,7 +3629,7 @@ var InstagramNamespace = class {
    *
    * Fetch a single Instagram post or reel by URL (media URLs, like count, owner, type) as normalized JSON.
    *
-   * Price: $0.0009 per request.
+   * Price: $0.0015 per request.
    *
    * @example
    * const res = await client.instagram.post({ url: "https://www.instagram.com/reel/DWzrfE2kaY8/" });
@@ -3629,7 +3642,7 @@ var InstagramNamespace = class {
    *
    * List the comments on an Instagram post or reel by URL with cursor pagination (text, author, likes).
    *
-   * Price: $0.0015 per request.
+   * Price: $0.00144 per request.
    *
    * @example
    * const res = await client.instagram.postComments({ url: "https://www.instagram.com/reel/DWzrfE2kaY8/" });
@@ -3721,7 +3734,7 @@ var InstagramNamespace = class {
   /**
    * Instagram Hashtag Search
    *
-   * Search posts under an Instagram hashtag through a web search index rather than Instagram's own hashtag feed. That is what lets it filter by date and media type and return reels whose like counts have settled, and it is also why results skew older (median around three months) and stop at roughly 110 per hashtag. For Instagram's own live ranking of a tag use instagram.hashtag_top_posts, and for the chronological feed use instagram.hashtag_recent_posts.
+   * Search posts under an Instagram hashtag through a web search index rather than Instagram's own hashtag feed. That is what lets it filter by date and media type and return reels whose like counts have settled, and it is also why results skew older (median around three months) and stop at roughly 110 per hashtag. If that web search index is unavailable, a first-page request that sets no date and no media type is served from Instagram's own live top feed instead. For Instagram's own live ranking of a tag use instagram.hashtag_top_posts, and for the chronological feed use instagram.hashtag_recent_posts.
    *
    * Price: $0.002 per request.
    *
@@ -4337,10 +4350,10 @@ var MapsNamespace = class {
    *
    * Fetch up to 100 Google Maps reviews for a place by place ID, sorted the way you need, in one normalized response.
    *
-   * Price: $0.00006 per request plus $0.00044 per result (maximum $0.0441).
+   * Price: $0.0035 per request.
    *
    * @example
-   * const res = await client.maps.reviews({ placeId: "ChIJN1t_tDeuEmsRUsoyG83frY4", limit: 3, postedLimit: "year" });
+   * const res = await client.maps.reviews({ placeId: "ChIJN1t_tDeuEmsRUsoyG83frY4", limit: 3 });
    */
   reviews(input, options) {
     return this._core.run("maps.reviews", input, options);
@@ -4617,7 +4630,7 @@ var PerplexityNamespace = class {
    *
    * Ask Perplexity a web-grounded question and receive an answer with source citations.
    *
-   * Price: $0.00006 per request plus $0.011 per result (maximum $0.0111).
+   * Price: $0.0036 per request.
    *
    * @example
    * const res = await client.perplexity.search({ prompt: "What is AnyAPI at getanyapi.com, and what does it offer?" });
@@ -4859,7 +4872,7 @@ var RedditNamespace = class {
    *
    * Fetch a single Reddit post by URL, including its full body text, score, comment count, upvote ratio, and subreddit, as normalized JSON.
    *
-   * Price: $0.0009 per request.
+   * Price: $0.0012 per request.
    *
    * @example
    * const res = await client.reddit.post({ url: "https://www.reddit.com/r/IAmA/comments/z1c9z/i_am_barack_obama_president_of_the_united_states/" });
@@ -4927,7 +4940,7 @@ var RedditNamespace = class {
    *
    * Search Reddit posts across all subreddits by query.
    *
-   * Price: $0.0009 per request.
+   * Price: $0.0012 per request.
    *
    * @example
    * const res = await client.reddit.search({ query: "mechanical keyboard" });
@@ -6544,7 +6557,7 @@ var TripadvisorNamespace = class {
    *
    * Fetch the latest reviews for any Tripadvisor hotel, restaurant, or attraction by its page URL: rating, text, date, and trip details as normalized JSON.
    *
-   * Price: $0.0036 per request.
+   * Price: $0.003 per request.
    *
    * @example
    * const res = await client.tripadvisor.reviews({ url: "https://www.tripadvisor.com/Hotel_Review-g60763-d93450-Reviews-The_Plaza-New_York_City_New_York.html", limit: 3 });
@@ -6557,7 +6570,7 @@ var TripadvisorNamespace = class {
    *
    * Search Tripadvisor for hotels, restaurants, and attractions in any destination and get rich place records (ratings, review counts, contact details, pricing) as normalized JSON.
    *
-   * Price: $0.0036 per request.
+   * Price: $0.003 per request.
    *
    * @example
    * const res = await client.tripadvisor.search({ query: "Paris", limit: 3 });
@@ -7215,7 +7228,7 @@ var YelpNamespace = class {
    *
    * Search Yelp for businesses by keyword and location: up to 20 listings with ratings, categories, and core business info per request.
    *
-   * Price: $0.044 per request plus $0.00083 per result (maximum $0.0605).
+   * Price: $0.0035 per request.
    *
    * @example
    * const res = await client.yelp.search({ location: "Chicago, IL", query: "pizza", limit: 5 });
@@ -7499,6 +7512,35 @@ var YoutubeNamespace = class {
       options
     );
   }
+  /**
+   * YouTube Shorts Search
+   *
+   * Search YouTube Shorts by keyword and get matching Shorts (title, views, URL) with cursor pagination as normalized JSON.
+   *
+   * Price: $0.002 per request.
+   *
+   * @example
+   * const res = await client.youtube.searchShorts({ query: "cats" });
+   */
+  searchShorts(input, options) {
+    return this._core.run("youtube.search_shorts", input, options);
+  }
+  /**
+   * Iterate every result of YouTube Shorts Search across pages.
+   *
+   * Yields items directly; call `.pages()` on the return value to walk whole
+   * result pages instead (each carries its own costUsd).
+   */
+  iterSearchShorts(input, options) {
+    return paginate(
+      this._core,
+      "youtube.search_shorts",
+      input,
+      "shorts",
+      false,
+      options
+    );
+  }
   /**
    * YouTube Trending Shorts
    *
@@ -7515,7 +7557,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Video
    *
-   * Fetch a YouTube video's metadata (title, channel, views, likes, duration, publish date) by URL or ID.
+   * Fetch a YouTube video or Short's metadata (title, channel, views, likes, duration, publish date) by URL or ID.
    *
    * Price: $0.00125 per request.
    *
@@ -7528,7 +7570,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Video Comments
    *
-   * List the comments on a YouTube video by URL with cursor pagination (text, author, likes, reply count).
+   * List the comments on a YouTube video or Short by URL with cursor pagination (text, author, likes, reply count).
    *
    * Price: $0.002 per request.
    *
@@ -7570,7 +7612,7 @@ var YoutubeNamespace = class {
   /**
    * YouTube Video Transcript
    *
-   * Fetch the transcript/captions of a YouTube video by URL or ID.
+   * Fetch the transcript/captions of a YouTube video or Short by URL or ID.
    *
    * Price: $0.00125 per request.
    *
@@ -7583,9 +7625,9 @@ var YoutubeNamespace = class {
   /**
    * YouTube Video Transcript (Provenance)
    *
-   * Fetch a YouTube transcript with timed segments and its provenance: whether the words are creator-written captions or machine speech recognition.
+   * Fetch a YouTube video or Short transcript with timed segments and its provenance: whether the words are creator-written captions or machine speech recognition.
    *
-   * Price: $0.00308 per request plus $0 per result (maximum $0.00308).
+   * Price: $0.001 per request.
    *
    * @example
    * const res = await client.youtube.videoTranscriptFull({ url: "https://www.youtube.com/watch?v=dQw4w9WgXcQ" });