scavio 0.21.0 → 0.22.0

package/README.md

@@ -1,11 +1,10 @@
 # Scavio
 
-TypeScript SDK for the [Scavio API](https://scavio.dev?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme) — real-time web scraping
-and data extraction across 36 platforms on one API key, plus `extract()` to read
+TypeScript SDK for the [Scavio API](https://scavio.dev?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme) — real-time structured web
+data across 36 platforms on one API key, plus `extract()` to read
 any URL as clean Markdown.
 
-Structured JSON in, structured JSON out. No proxies, no headless browsers, no
-per-site parsers to maintain.
+Structured JSON in, structured JSON out. No per-site parsers to maintain.
 
 - **Search and SERP** — Google (organic, news, maps, shopping, flights, hotels, trends, AI Mode)
 - **E-commerce** — Amazon, Walmart, Costco, Mercado Libre, eBay, Target, Home Depot, TikTok Shop
@@ -93,11 +92,11 @@ Credits depend on `mode`, not on a flat per-call price: `normal` costs 1,
 `advanced` costs 1, `ultra` costs 2. Billing happens only on a successful
 extraction — a dead link, bot wall or timeout costs nothing.
 
-- `normal` is a plain datacenter fetch. Start here.
-- `advanced` renders the page in a headless browser. Use it when the content is
-  built client-side.
-- `ultra` goes through residential IPs. Use it only when a bot wall blocks the
-  other two.
+- `normal` is the default. Start here.
+- `advanced` renders the page's JavaScript. Use it when the content is built
+  client-side.
+- `ultra` is the hardest-page tier. Use it only when a page blocks the other
+  two.
 
 `html` is the raw page. `markdown` is a readability extraction with the
 boilerplate stripped. `text` is that markdown flattened to plain text. URLs are
@@ -169,8 +168,8 @@ silently does nothing.
 
 #### Amazon changed in 0.12.0 (breaking)
 
-Amazon moved to a new upstream and the API now returns a normalized shape
-instead of the previous raw provider payload.
+The Amazon API now returns a normalized shape instead of the previous raw
+payload.
 
 - `search` returns `{query, page, total_results, total_results_text, count, products[], filters[], related_searches[]}`.
   Each product is `{asin, title, url, image, price, currency, rating, reviews_count, is_sponsored, position, badge, sales_volume, delivery{is_free, date, fastest_date}}`.
@@ -308,12 +307,12 @@ warehouses on us and 2 per warehouse on ca). The clearance price codes are the
 member-community decode of Costco shelf prices; Costco does not publish them,
 and only items Costco lists online are covered.
 
-### Mercado Libre
+### [Mercado Libre](https://scavio.dev/docs/mercadolibre-search?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme)
 
 Five endpoints, new in 0.21.0: `reviews` costs 1 credit, the other four 2. The
 `best-sellers` endpoint is `bestSellers()`. Mexico (`mx`), Brazil (`br`,
 Mercado Livre), Argentina (`ar`) and Colombia (`co`); prices come back in MXN,
-BRL, ARS or COP. Chile is not supported.
+BRL, ARS or COP. Chile is not supported. Docs: [search](https://scavio.dev/docs/mercadolibre-search?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme), [product](https://scavio.dev/docs/mercadolibre-product?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme), [reviews](https://scavio.dev/docs/mercadolibre-reviews?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme), [questions](https://scavio.dev/docs/mercadolibre-questions?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme), [best sellers](https://scavio.dev/docs/mercadolibre-best-sellers?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme); overview at the [Mercado Libre API](https://scavio.dev/mercadolibre-api?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme) page.
 
 ```typescript
 // Keyword search: about 48 rows per page, up to 42 pages.
@@ -357,7 +356,7 @@ nickname, or a listing with no public questions, is a billed 404.
 
 ### YouTube
 
-Credit cost varies by endpoint: `transcript` costs 8; `streams` costs 3;
+Credit cost varies by endpoint: `transcript` costs 5; `streams` costs 3;
 `search` and `shorts` cost 2; every other YouTube endpoint costs 1.
 
 ```typescript
@@ -403,6 +402,10 @@ await client.youtube.channelVideos({ channel_id: "UC..." });
 await client.youtube.channelShorts({ channel_id: "UC..." });
 await client.youtube.channelCommunity({ channel_id: "UC..." });
 await client.youtube.channelResolve({ channel: "@mkbhd" }); // handle/URL -> id
+
+// One community post (text, author, likes, images, comments_cursor) and its comments
+await client.youtube.communityPost({ post_id: "Ugkx_PqHZYEoCCP7e8WIOrh-1HCvtKoFMzVp" });
+await client.youtube.communityPostComments({ post_id: "Ugkx_PqHZYEoCCP7e8WIOrh-1HCvtKoFMzVp" });
 ```
 
 ### Reddit
@@ -410,7 +413,8 @@ await client.youtube.channelResolve({ channel: "@mkbhd" }); // handle/URL -> id
 Every Reddit endpoint costs 1 credit.
 
 `search()` takes only `query` and `cursor` — there is no result-type or sort
-filter upstream, so anything else is dropped server-side. It returns
+filter, so anything else is dropped server-side. `searchComments()` does sort
+(`RELEVANCE`, `HOT`, `TOP` or `NEW`). It returns
 `data.results` with `next_cursor` and `has_more`. `post()` returns a flat post
 object under `data` and carries no comments; use `postComments()` for those.
 The subreddit and user feeds return `data.posts`.
@@ -445,6 +449,10 @@ await client.reddit.userComments({ username: "spez" });
 // Site-wide popular feed and trending searches
 await client.reddit.popular();
 await client.reddit.trending();
+
+// Comment search (each result carries its post and subreddit) and subreddit search
+await client.reddit.searchComments({ query: "web scraping api", sort: "NEW" });
+await client.reddit.searchSubreddits({ query: "web scraping" });
 ```
 
 ### X
@@ -468,8 +476,15 @@ await client.x.userFollowings({ screen_name: "elonmusk" });
 
 // Trending topics
 await client.x.trending({ country: "UnitedStates" });
+
+// Communities: search, details (rules, member count), and posts
+await client.x.searchCommunities({ keyword: "crypto" });
+await client.x.community({ community_id: "1508567430188126209" });
+await client.x.communityTweets({ community_id: "1508567430188126209", ranking: "Recency" });
 ```
 
+Every X endpoint costs 1 credit.
+
 ### LinkedIn
 
 ```typescript
@@ -496,9 +511,9 @@ Credit cost varies by endpoint: `job` costs 30; `personPosts`, `companyPosts`,
 `searchJobs` and `postComments` cost 10 per page; `person`, `personAbout`,
 `company` and `post` cost 1.
 
-> **Retired endpoints.** The upstream provider withdrew the datasets behind
-> `personContact`, `companyPeople`, `companyJobs`, `searchPeople` and
-> `searchPosts`. They remain callable but always return HTTP 410 and are never
+> **Retired endpoints.** The LinkedIn data behind `personContact`,
+> `companyPeople`, `companyJobs`, `searchPeople` and `searchPosts` is no longer
+> available. They remain callable but always return HTTP 410 and are never
 > billed. `company()` returns `featured_employees` (a small sample of staff), and
 > `searchJobs()` with a company name substitutes for `companyJobs()`.
 
@@ -542,14 +557,45 @@ await client.tiktok.userFollowers({ sec_user_id: "abc123" });
 
 // User followings
 await client.tiktok.userFollowings({ sec_user_id: "abc123" });
+
+// Trending searches and a sample of trending videos (about 6 per call)
+await client.tiktok.trendingSearches();
+await client.tiktok.trendingVideos();
+
+// Search autocomplete
+await client.tiktok.searchSuggestions({ keyword: "cooking" });
+
+// Sounds: detail, videos using a sound, search, Top 50 / Viral 50 chart
+await client.tiktok.music({ music_id: "7364498342501435408" });
+await client.tiktok.musicVideos({ music_id: "7364498342501435408" });
+await client.tiktok.searchMusic({ keyword: "espresso" });
+await client.tiktok.musicChart({ chart: "viral" });
+
+// Similar creators, playlists and the videos in one
+await client.tiktok.userSimilar({ sec_user_id: "abc123" });
+await client.tiktok.userPlaylists({ sec_user_id: "abc123" });
+await client.tiktok.playlistVideos({ playlist_id: "7596415294902389534" });
+
+// Live status and account region (region also returns sec_user_id)
+await client.tiktok.userLive({ username: "mrbeast" });
+await client.tiktok.userRegion({ username: "mrbeast" });
 ```
 
+Every TikTok endpoint costs 1 credit. The trending, sound, similar, playlist,
+live and region endpoints return TikTok's raw payload: large numeric ids can
+lose precision when parsed as JSON numbers, so use the string forms (`id_str`,
+`sec_uid`, `sec_user_id`). `trendingVideos()` returns about 6 videos per call
+whatever `count` is set to, and `musicVideos()` ignores `count` (about 14 per
+page). Search suggestions can be empty for long-tail keywords and still bill.
+An unknown username is a billed 404 on `userLive()` and an unbilled 404 on
+`userRegion()`.
+
 ### TikTok Shop
 
 Every TikTok Shop endpoint costs 1 credit. Two limits to design around:
 
 - `product()` resolves only about 44% of the product ids returned by `search()`.
-  Upstream has no detail data for the rest, so an HTTP 404 is a normal outcome, not an
+  TikTok Shop has no detail data for the rest, so an HTTP 404 is a normal outcome, not an
   error — skip the item instead of retrying. Search to product is not a reliable
   pipeline. `product()` **throws** `NotFoundError` on that 404 (there is no `data`
   field in the body to test), so a loop over search ids must catch it:
@@ -561,7 +607,7 @@ Every TikTok Shop endpoint costs 1 credit. Two limits to design around:
     try {
       const detail = await client.tiktokShop.product({ product_id: productId });
     } catch (e) {
-      if (e instanceof NotFoundError) continue; // no detail upstream; skip
+      if (e instanceof NotFoundError) continue; // no detail data; skip
       throw e;
     }
   }
@@ -570,7 +616,7 @@ Every TikTok Shop endpoint costs 1 credit. Two limits to design around:
   `productReviews()` often works for ids `product()` cannot resolve: of 8 such ids
   tested, 8 returned HTTP 200 and 7 carried at least one review, so it is a useful
   fallback source of product detail.
-- `product()` does not return a price; upstream masks it on the product page. Exact
+- `product()` does not return a price; TikTok masks it on the product page. Exact
   prices come from `search()`, `shopProducts()`, and `categoryProducts()`.
 
 ```typescript
@@ -613,9 +659,6 @@ Credit cost varies by endpoint, in three tiers:
 | 8 | `post`, `commentReplies` |
 | 10 | `profile`, `userReels`, `userTagged`, `userStories`, `postComments`, `searchUsers`, `searchHashtags`, `userFollowers`, `userFollowings` |
 
-The 10-credit endpoints run two upstream providers in parallel and bill both
-legs; the 8-credit ones have no fallback leg to hedge against.
-
 ```typescript
 // User profile
 await client.instagram.profile({ username: "instagram" });
@@ -647,8 +690,8 @@ await client.instagram.userFollowings({ username: "instagram" });
 ### Threads
 
 Six endpoints, and the credit cost is a function of the body: **2 credits when
-you address a user by `user_id`, 4 when you address them by `username`.** The
-upstream handle lookup is dead, so a handle buys a second call. Only `profile`,
+you address a user by `user_id`, 4 when you address them by `username`.** A
+handle needs an extra lookup, so it costs a second call. Only `profile`,
 `userPosts` and `userReplies` are username-keyed; `post`, `postComments` and
 `searchUsers` always cost 2.
 
@@ -856,8 +899,8 @@ await client.booking.reviews({ hotel: "the-independente" });
 1 credit per call. `checkin` and `checkout` must be sent together — Booking
 ignores a lone check-in and prices its own date range. `hotel` and `reviews`
 take dates for the same reason: Booking prices a stay, and the response echoes
-whichever dates were used. `currency` defaults to USD; without it Booking prices
-off the proxy exit and two identical requests disagree. A search with neither
+whichever dates were used. `currency` defaults to USD; without it Booking picks
+a currency itself and two identical requests can disagree. A search with neither
 `destination` nor `dest_id` returns Booking's homepage and still costs a credit.
 
 ### Airbnb
@@ -909,7 +952,7 @@ await client.yelp.reviews({ business_id: "...", page: 2 });  // page 2, not 1
 ```
 
 2 credits per call. `location` is effectively required — without it Yelp
-geolocates off the proxy exit and the same request answers about a different
+picks a location itself and the same request can answer about a different
 metro run to run. **Reviews page 1 is redundant**: it re-fetches the document
 `business()` already returned and costs another 2 credits, so start at page 2.
 Page size is fixed at 10 and a page past the last is a 404.
@@ -944,7 +987,7 @@ only exists inside Glassdoor's `/Overview/` URLs.
 const hits = await client.glassdoor.companies({ query: "Stripe" });
 const company = await client.glassdoor.company({ employer_id: "671932" });
 
-// Pass the URLs the company response returns - halves the upstream work
+// Pass the URLs the company response returns - saves a lookup
 await client.glassdoor.reviews({ url: company.reviews_url as string });
 await client.glassdoor.salaries({ url: company.salaries_url as string });
 ```
@@ -952,8 +995,8 @@ await client.glassdoor.salaries({ url: company.salaries_url as string });
 1 credit per call. Glassdoor's login wall caps `reviews` at **three reviews per
 response** — there is deliberately no `page` param; move the window with
 `category` and `employment_status` and read `filtered_review_count` to see how
-many match. Addressing `reviews` or `salaries` by `employer_id` costs two
-upstream fetches because the slugs are case-sensitive and must be read off the
+many match. Addressing `reviews` or `salaries` by `employer_id` needs an
+extra lookup because the slugs are case-sensitive and must be read off the
 profile, so prefer the `reviews_url` / `salaries_url` the company response hands
 back. These endpoints are slow and flaky by nature (company about 3-47s, reviews
 about 75s, salaries about 41s) — raise `timeout` and keep retries on.
@@ -997,9 +1040,9 @@ await client.g2.product({ product_id: "notion" });
 await client.g2.reviews({ product_id: "notion", page: 2, company_size: "enterprise" });
 ```
 
-**5 credits per call — the most expensive platform in the SDK**, because g2.com
-bills 25 upstream credits per fetch. Retries are deliberately conservative for
-that reason, and a bot wall arrives as a billed 200 rather than an error. G2
+**5 credits per call — the most expensive platform in the SDK.** Retries are
+deliberately conservative for that reason, and a blocked page arrives as a
+billed 200 rather than an error. G2
 loads review text in a separate frame, so `product` carries no reviews — call
 `reviews`, which is also the only place with exact per-star counts, pros/cons by
 theme, and company-size / role / industry / region facets.
@@ -1080,9 +1123,9 @@ await client.sec.search({ query: "climate risk", form: "10-K" });
 ```
 
 1 credit per call, including `include_history: true`, which is the one call that
-can buy up to 10 upstream fetches. Both `cik` and `ticker` accept either
-spelling. XBRL concept tags are **case-sensitive** — `netincomeloss` is a 404
-upstream, so use `facts()` to see what a filer actually reports. EDGAR's
+can take up to 10 lookups. Both `cik` and `ticker` accept either
+spelling. XBRL concept tags are **case-sensitive** — `netincomeloss` is a 404,
+so use `facts()` to see what a filer actually reports. EDGAR's
 "recent" block is not a fixed window: a decade for a quiet filer, about a year
 for a prolific one.
 
@@ -1180,7 +1223,7 @@ All error classes:
 | `BadRequestError` | 400, 422 | Invalid request parameters |
 | `InvalidAPIKeyError` | 401 | Invalid API key |
 | `InsufficientCreditsError` | 402 | No credits remaining |
-| `NotFoundError` | 404 | No data upstream for that id (see TikTok Shop above) |
+| `NotFoundError` | 404 | No data for that id (see TikTok Shop above) |
 | `RateLimitError` | 429 | Rate limit exceeded |
 | `ScavioAPIError` | other | Catch-all (has `.statusCode`) |
 
@@ -1210,7 +1253,7 @@ MIT
 
 [Scavio](https://scavio.dev?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme) is a unified web data and
 [search API for AI agents](https://scavio.dev/search-api-for-ai-agents?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme) — one API
-key, structured JSON, no proxies or browser farms to run. It is a real-time
+key, structured JSON. It is a real-time
 [Tavily alternative](https://scavio.dev/alternatives/tavily?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme) and
 [SerpAPI alternative](https://scavio.dev/alternatives/serpapi?utm_source=npm-scavio-js&utm_medium=package&utm_campaign=readme), and with
 `extract()` it also covers the read-any-URL job people reach for Firecrawl to do.

package/dist/index.cjs

@@ -203,7 +203,7 @@ function parseRetryAfter(header) {
 var BASE_URL = "https://api.scavio.dev";
 var DEFAULT_TIMEOUT = 3e4;
 var DEFAULT_MAX_RETRIES = 2;
-var SDK_VERSION = true ? "0.21.0" : "0.0.0";
+var SDK_VERSION = true ? "0.22.0" : "0.0.0";
 var USER_AGENT = `scavio-js/${SDK_VERSION}`;
 function isServerRuntime() {
   const g = globalThis;
@@ -493,6 +493,21 @@ var RedditNamespace = class {
   async trending() {
     return this.client._post("/api/v1/reddit/trending", {});
   }
+  /**
+   * Search Reddit comments by keyword. Each result carries the comment text,
+   * author, score and date, plus the post and subreddit it was left on.
+   * Costs 1 credit.
+   */
+  async searchComments(options) {
+    return this.client._post("/api/v1/reddit/search/comments", options);
+  }
+  /**
+   * Find subreddits by keyword, with subscriber counts, descriptions and NSFW
+   * flags. Costs 1 credit.
+   */
+  async searchSubreddits(options) {
+    return this.client._post("/api/v1/reddit/search/subreddits", options);
+  }
 };
 
 // src/namespaces/tiktok.ts
@@ -534,6 +549,107 @@ var TikTokNamespace = class {
   async userFollowings(options) {
     return this.client._post("/api/v1/tiktok/user/followings", options);
   }
+  /**
+   * Search terms trending on TikTok now (about 90 per call, US-weighted, no
+   * region filter). Costs 1 credit.
+   */
+  async trendingSearches() {
+    return this.client._post("/api/v1/tiktok/trending/searches", {});
+  }
+  /**
+   * A sample of videos trending on TikTok now, with author, stats, sound and
+   * hashtags. Each call returns about 6 videos whatever `count` is set to;
+   * call again for a fresh sample. No region filter. Costs 1 credit.
+   * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+   * numbers, so use the string forms (`id_str`, `sec_uid`).
+   */
+  async trendingVideos(options = {}) {
+    return this.client._post("/api/v1/tiktok/trending/videos", options);
+  }
+  /**
+   * TikTok search autocomplete suggestions for a keyword. Long-tail keywords
+   * can return none, which is still a billed answer. Costs 1 credit.
+   */
+  async searchSuggestions(options) {
+    return this.client._post("/api/v1/tiktok/search/suggestions", options);
+  }
+  /**
+   * A TikTok sound by id: title, artist, album, duration, how many videos use
+   * it, original vs commercial, play URL, cover, and chart rank when charting.
+   * Costs 1 credit.
+   * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+   * numbers, so use the string forms (`id_str`, `sec_uid`).
+   */
+  async music(options) {
+    return this.client._post("/api/v1/tiktok/music", options);
+  }
+  /**
+   * Videos that use a TikTok sound, about 14 per page (`count` is ignored
+   * upstream). Costs 1 credit.
+   * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+   * numbers, so use the string forms (`id_str`, `sec_uid`).
+   */
+  async musicVideos(options) {
+    return this.client._post("/api/v1/tiktok/music/videos", options);
+  }
+  /**
+   * Search TikTok sounds by keyword: id, title, artist, duration, usage count
+   * and play URL. Costs 1 credit.
+   * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+   * numbers, so use the string forms (`id_str`, `sec_uid`).
+   */
+  async searchMusic(options) {
+    return this.client._post("/api/v1/tiktok/search/music", options);
+  }
+  /**
+   * TikTok's Top 50 or Viral 50 sound chart, with each sound's details and
+   * trend. One global chart, no region filter. Costs 1 credit.
+   * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+   * numbers, so use the string forms (`id_str`, `sec_uid`).
+   */
+  async musicChart(options = {}) {
+    return this.client._post("/api/v1/tiktok/music/chart", options);
+  }
+  /**
+   * Creators similar to a TikTok user (about 30 per page), with follower,
+   * following, video and like counts, bio and verification. Costs 1 credit.
+   * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+   * numbers, so use the string forms (`id_str`, `sec_uid`).
+   */
+  async userSimilar(options) {
+    return this.client._post("/api/v1/tiktok/user/similar", options);
+  }
+  /**
+   * A TikTok user's playlists (series): id, name, video count and cover.
+   * Accounts without playlists return an empty list. Costs 1 credit.
+   */
+  async userPlaylists(options) {
+    return this.client._post("/api/v1/tiktok/user/playlists", options);
+  }
+  /**
+   * Videos in a TikTok playlist, with pagination. Costs 1 credit.
+   * Returns TikTok's raw payload: large numeric ids can lose precision as JSON
+   * numbers, so use the string forms (`id_str`, `sec_uid`).
+   */
+  async playlistVideos(options) {
+    return this.client._post("/api/v1/tiktok/playlist/videos", options);
+  }
+  /**
+   * Whether a TikTok user is live now: the user, live room status (2 = live,
+   * 4 = not live), title, start time and viewer counts. An unknown username is
+   * a billed 404. Costs 1 credit.
+   */
+  async userLive(options) {
+    return this.client._post("/api/v1/tiktok/user/live", options);
+  }
+  /**
+   * The region a TikTok account is registered in (ISO country code, not the
+   * creator's nationality), plus its user id and sec_user_id. An unknown
+   * username is a 404 and is not billed. Costs 1 credit.
+   */
+  async userRegion(options) {
+    return this.client._post("/api/v1/tiktok/user/region", options);
+  }
 };
 
 // src/namespaces/tiktok-shop.ts
@@ -826,6 +942,7 @@ var YouTubeNamespace = class {
   async commentReplies(options) {
     return this.client._post("/api/v1/youtube/comments/replies", options);
   }
+  /** Transcript / captions for a YouTube video. Costs 5 credits. */
   async transcript(options) {
     return this.client._post("/api/v1/youtube/transcript", options);
   }
@@ -857,6 +974,21 @@ var YouTubeNamespace = class {
   async streams(options) {
     return this.client._post("/api/v1/youtube/streams", options);
   }
+  /**
+   * A single YouTube community post: text, author, likes, comment count,
+   * attached images, and a comments_cursor for communityPostComments.
+   * Costs 1 credit.
+   */
+  async communityPost(options) {
+    return this.client._post("/api/v1/youtube/community/post", options);
+  }
+  /**
+   * Comments on a YouTube community post, with likes, reply counts and
+   * pagination. Costs 1 credit.
+   */
+  async communityPostComments(options) {
+    return this.client._post("/api/v1/youtube/community/post/comments", options);
+  }
 };
 
 // src/namespaces/x.ts
@@ -898,6 +1030,27 @@ var XNamespace = class {
   async trending(options = {}) {
     return this.client._post("/api/v1/x/trending", options);
   }
+  /**
+   * Find X Communities by keyword, with member counts, topic and NSFW flag.
+   * Costs 1 credit.
+   */
+  async searchCommunities(options) {
+    return this.client._post("/api/v1/x/search/communities", options);
+  }
+  /**
+   * An X Community: name, description, creation date, member count, topic and
+   * rules. Costs 1 credit.
+   */
+  async community(options) {
+    return this.client._post("/api/v1/x/community", options);
+  }
+  /**
+   * Posts in an X Community, by relevance or recency, with pagination.
+   * Costs 1 credit.
+   */
+  async communityTweets(options) {
+    return this.client._post("/api/v1/x/community/tweets", options);
+  }
 };
 
 // src/namespaces/linkedin.ts