scavio 0.5.0 → 0.7.0

package/README.md

@@ -1,6 +1,6 @@
 # Scavio
 
-TypeScript SDK for the [Scavio Search API](https://scavio.dev) — real-time Google, Amazon, Walmart, YouTube, Reddit, TikTok, and Instagram data.
+TypeScript SDK for the [Scavio Search API](https://scavio.dev) — real-time Google, Amazon, Walmart, YouTube, Reddit, TikTok, Instagram, Twitter, and LinkedIn data.
 
 ## Install
 
@@ -104,31 +104,128 @@ await client.walmart.product({
 // Search videos
 await client.youtube.search({
   query: "typescript tutorial",
-  upload_date: "week",     // optional
-  sort_by: "relevance",   // optional
-  hd: true,                // optional
+  upload_date: "this_week",       // optional
+  sort_by: "relevance",           // optional
+  features: ["hd", "4k"],         // optional
+  cursor: "...",                  // optional (pagination)
 });
 
-// Get video metadata
-await client.youtube.metadata({
+// Search Shorts
+await client.youtube.shorts({ query: "cooking" });
+
+// Search-as-you-type suggestions
+await client.youtube.suggestions({ query: "how to" });
+
+// Get video details (accepts an id or a full watch URL)
+await client.youtube.video({ video_id: "dQw4w9WgXcQ" });
+// youtube.metadata() is a deprecated alias of youtube.video()
+
+// Video comments and threaded replies
+await client.youtube.comments({ video_id: "dQw4w9WgXcQ" });
+await client.youtube.commentReplies({
   video_id: "dQw4w9WgXcQ",
+  reply_cursor: "...",            // from a comment's reply_cursor
 });
+
+// Transcript / subtitles (format: 'text' or 'srt')
+await client.youtube.transcript({ video_id: "dQw4w9WgXcQ", format: "srt" });
+
+// Related videos
+await client.youtube.related({ video_id: "dQw4w9WgXcQ" });
+
+// Playable / downloadable stream URLs
+await client.youtube.streams({ video_id: "dQw4w9WgXcQ" });
+
+// Channels
+await client.youtube.channelSearch({ query: "mkbhd" });
+await client.youtube.channel({ channel_id: "@mkbhd" }); // id, @handle, or URL
+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
 ```
 
 ### Reddit
 
 ```typescript
 // Search posts
-await client.reddit.search({
-  query: "typescript",
-  sort: "relevance",       // optional
-  type: "link",            // optional
-});
+await client.reddit.search({ query: "typescript", cursor: "..." });
+
+// Search-as-you-type suggestions
+await client.reddit.searchSuggestions({ query: "python" });
 
-// Get specific post
-await client.reddit.post({
-  url: "https://reddit.com/r/typescript/comments/abc123",
+// Post detail (by post_id or url)
+await client.reddit.post({ post_id: "t3_1v6ngaf" });
+await client.reddit.post({ url: "https://reddit.com/r/typescript/comments/abc123" });
+
+// Post comments and threaded replies
+await client.reddit.postComments({ post_id: "t3_1v6ngaf", sort: "TOP" });
+await client.reddit.commentReplies({
+  post_id: "t3_1v6ngaf",
+  cursor: "...",            // reply_cursor from a comment
 });
+
+// Subreddit info and feed
+await client.reddit.subreddit({ subreddit: "AskReddit" });
+await client.reddit.subredditPosts({ subreddit: "AskReddit", sort: "HOT" });
+
+// Redditor profile, posts, and comments
+await client.reddit.user({ username: "spez" });
+await client.reddit.userPosts({ username: "spez", sort: "NEW" });
+await client.reddit.userComments({ username: "spez" });
+
+// Site-wide popular feed and trending searches
+await client.reddit.popular();
+await client.reddit.trending();
+```
+
+### Twitter
+
+```typescript
+// Search tweets and people
+await client.twitter.search({ search: "artificial intelligence", search_type: "Latest" });
+
+// Tweet detail, comments, and retweeters
+await client.twitter.tweet({ tweet_id: "1808168603721650364" });
+await client.twitter.tweetComments({ tweet_id: "1808168603721650364", rank: "top" });
+await client.twitter.tweetRetweeters({ tweet_id: "1808168603721650364" });
+
+// User profile and feeds
+await client.twitter.user({ screen_name: "elonmusk" });
+await client.twitter.userTweets({ screen_name: "elonmusk" });
+await client.twitter.userReplies({ screen_name: "elonmusk" });
+await client.twitter.userMedia({ screen_name: "elonmusk" });
+await client.twitter.userFollowers({ screen_name: "elonmusk" });
+await client.twitter.userFollowings({ screen_name: "elonmusk" });
+
+// Trending topics
+await client.twitter.trending({ country: "UnitedStates" });
+```
+
+### LinkedIn
+
+```typescript
+// Person profile, about, posts, and contact
+await client.linkedin.person({ username: "williamhgates" });
+await client.linkedin.personAbout({ username: "williamhgates" });
+await client.linkedin.personPosts({ username: "williamhgates" });
+await client.linkedin.personContact({ username: "williamhgates" });
+
+// Company profile, posts, people, and jobs
+await client.linkedin.company({ company: "microsoft" });
+await client.linkedin.companyPosts({ company: "microsoft" });
+await client.linkedin.companyPeople({ company: "microsoft" });
+await client.linkedin.companyJobs({ company: "microsoft" });
+
+// Search people, jobs, and posts
+await client.linkedin.searchPeople({ search: "john", title: "engineer" });
+await client.linkedin.searchJobs({ search: "software engineer" });
+await client.linkedin.searchPosts({ search: "AI agents" });
+
+// Job, post, and post comments
+await client.linkedin.job({ job_id: "3900000000" });
+await client.linkedin.post({ post_id: "7486820977411145728" });
+await client.linkedin.postComments({ post_id: "7486820977411145728", sort_order: "relevance" });
 ```
 
 ### TikTok
@@ -246,11 +343,14 @@ MIT
 
 ## About Scavio
 
-[Scavio](https://scavio.dev) is a unified [search API](https://scavio.dev/docs/search-api) built for AI agents — one API key, structured JSON, no scraping or proxies. A real-time [Tavily alternative](https://scavio.dev) and [SerpAPI alternative](https://scavio.dev) with data from:
+[Scavio](https://scavio.dev) is a unified [search API for AI agents](https://scavio.dev/search-api-for-ai-agents) — one API key, structured JSON, no scraping or proxies. A real-time [Tavily alternative](https://scavio.dev/alternatives/tavily) and [SerpAPI alternative](https://scavio.dev/alternatives/serpapi) with data from:
+
+- [Google Search API](https://scavio.dev/google-search-api) — SERP results, news, images, maps, and knowledge graph
+- [Amazon Product API](https://scavio.dev/amazon-product-api) and [Walmart Product API](https://scavio.dev/walmart-product-api) — product search and details
+- [YouTube API](https://scavio.dev/youtube-transcript-api), [TikTok API](https://scavio.dev/tiktok-api), and [Instagram API](https://scavio.dev/instagram-api) — video and social media data
+- [Reddit API](https://scavio.dev/reddit-api) — posts and threaded comments
+- [Twitter API](https://scavio.dev/twitter-api) and [LinkedIn API](https://scavio.dev/linkedin-api) — tweets, profiles, companies, and jobs
 
-- [Google Search API](https://scavio.dev/docs/search-api) — SERP results, news, images, maps, and knowledge graph
-- [Amazon Product API](https://scavio.dev/docs/amazon-api) and [Walmart API](https://scavio.dev/docs/walmart-api) — product search and details
-- [YouTube API](https://scavio.dev/docs/youtube-api), [TikTok API](https://scavio.dev/docs/tiktok-api), and [Instagram API](https://scavio.dev/docs/instagram-api) — video and social media data
-- [Reddit API](https://scavio.dev/docs/reddit-api) — posts and threaded comments
+Teams choosing between providers can [compare Scavio vs alternatives](https://scavio.dev/compare) side by side.
 
 Get a free [API key](https://dashboard.scavio.dev) and explore the [documentation](https://scavio.dev/docs/introduction).

package/dist/index.cjs

@@ -390,9 +390,39 @@ var RedditNamespace = class {
   async search(options) {
     return this.client._post("/api/v1/reddit/search", options);
   }
+  async searchSuggestions(options) {
+    return this.client._post("/api/v1/reddit/search/suggestions", options);
+  }
   async post(options) {
     return this.client._post("/api/v1/reddit/post", options);
   }
+  async postComments(options) {
+    return this.client._post("/api/v1/reddit/post/comments", options);
+  }
+  async commentReplies(options) {
+    return this.client._post("/api/v1/reddit/post/comments/replies", options);
+  }
+  async subreddit(options) {
+    return this.client._post("/api/v1/reddit/subreddit", options);
+  }
+  async subredditPosts(options) {
+    return this.client._post("/api/v1/reddit/subreddit/posts", options);
+  }
+  async user(options) {
+    return this.client._post("/api/v1/reddit/user", options);
+  }
+  async userPosts(options) {
+    return this.client._post("/api/v1/reddit/user/posts", options);
+  }
+  async userComments(options) {
+    return this.client._post("/api/v1/reddit/user/comments", options);
+  }
+  async popular(options = {}) {
+    return this.client._post("/api/v1/reddit/popular", options);
+  }
+  async trending() {
+    return this.client._post("/api/v1/reddit/trending", {});
+  }
 };
 
 // src/namespaces/tiktok.ts
@@ -511,8 +541,154 @@ var YouTubeNamespace = class {
     if (video_3d !== void 0) body["3d"] = video_3d;
     return this.client._post("/api/v1/youtube/search", body);
   }
+  async shorts(options) {
+    const { query, ...rest } = options;
+    return this.client._post("/api/v1/youtube/shorts", {
+      search: query,
+      ...rest
+    });
+  }
+  async suggestions(options) {
+    const { query, ...rest } = options;
+    return this.client._post("/api/v1/youtube/suggestions", {
+      search: query,
+      ...rest
+    });
+  }
+  async video(options) {
+    return this.client._post("/api/v1/youtube/video", options);
+  }
+  /** @deprecated Use youtube.video(). Alias kept for backward compatibility. */
   async metadata(options) {
-    return this.client._post("/api/v1/youtube/metadata", options);
+    return this.video(options);
+  }
+  async comments(options) {
+    return this.client._post("/api/v1/youtube/comments", options);
+  }
+  async commentReplies(options) {
+    return this.client._post("/api/v1/youtube/comments/replies", options);
+  }
+  async transcript(options) {
+    return this.client._post("/api/v1/youtube/transcript", options);
+  }
+  async related(options) {
+    return this.client._post("/api/v1/youtube/related", options);
+  }
+  async channelSearch(options) {
+    const { query, ...rest } = options;
+    return this.client._post("/api/v1/youtube/channel/search", {
+      search: query,
+      ...rest
+    });
+  }
+  async channel(options) {
+    return this.client._post("/api/v1/youtube/channel", options);
+  }
+  async channelVideos(options) {
+    return this.client._post("/api/v1/youtube/channel/videos", options);
+  }
+  async channelShorts(options) {
+    return this.client._post("/api/v1/youtube/channel/shorts", options);
+  }
+  async channelCommunity(options) {
+    return this.client._post("/api/v1/youtube/channel/community", options);
+  }
+  async channelResolve(options) {
+    return this.client._post("/api/v1/youtube/channel/resolve", options);
+  }
+  async streams(options) {
+    return this.client._post("/api/v1/youtube/streams", options);
+  }
+};
+
+// src/namespaces/twitter.ts
+var TwitterNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async search(options) {
+    return this.client._post("/api/v1/twitter/search", options);
+  }
+  async tweet(options) {
+    return this.client._post("/api/v1/twitter/tweet", options);
+  }
+  async tweetComments(options) {
+    return this.client._post("/api/v1/twitter/tweet/comments", options);
+  }
+  async tweetRetweeters(options) {
+    return this.client._post("/api/v1/twitter/tweet/retweeters", options);
+  }
+  async user(options) {
+    return this.client._post("/api/v1/twitter/user", options);
+  }
+  async userTweets(options) {
+    return this.client._post("/api/v1/twitter/user/tweets", options);
+  }
+  async userReplies(options) {
+    return this.client._post("/api/v1/twitter/user/replies", options);
+  }
+  async userMedia(options) {
+    return this.client._post("/api/v1/twitter/user/media", options);
+  }
+  async userFollowers(options) {
+    return this.client._post("/api/v1/twitter/user/followers", options);
+  }
+  async userFollowings(options) {
+    return this.client._post("/api/v1/twitter/user/followings", options);
+  }
+  async trending(options = {}) {
+    return this.client._post("/api/v1/twitter/trending", options);
+  }
+};
+
+// src/namespaces/linkedin.ts
+var LinkedInNamespace = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async person(options) {
+    return this.client._post("/api/v1/linkedin/person", options);
+  }
+  async personAbout(options) {
+    return this.client._post("/api/v1/linkedin/person/about", options);
+  }
+  async personPosts(options) {
+    return this.client._post("/api/v1/linkedin/person/posts", options);
+  }
+  async personContact(options) {
+    return this.client._post("/api/v1/linkedin/person/contact", options);
+  }
+  async company(options) {
+    return this.client._post("/api/v1/linkedin/company", options);
+  }
+  async companyPosts(options) {
+    return this.client._post("/api/v1/linkedin/company/posts", options);
+  }
+  async companyPeople(options) {
+    return this.client._post("/api/v1/linkedin/company/people", options);
+  }
+  async companyJobs(options) {
+    return this.client._post("/api/v1/linkedin/company/jobs", options);
+  }
+  async searchPeople(options) {
+    return this.client._post("/api/v1/linkedin/search/people", options);
+  }
+  async searchJobs(options) {
+    return this.client._post("/api/v1/linkedin/search/jobs", options);
+  }
+  async searchPosts(options) {
+    return this.client._post("/api/v1/linkedin/search/posts", options);
+  }
+  async job(options) {
+    return this.client._post("/api/v1/linkedin/job", options);
+  }
+  async post(options) {
+    return this.client._post("/api/v1/linkedin/post", options);
+  }
+  async postComments(options) {
+    return this.client._post("/api/v1/linkedin/post/comments", options);
   }
 };
 
@@ -525,6 +701,8 @@ var Scavio = class {
   reddit;
   tiktok;
   instagram;
+  twitter;
+  linkedin;
   apiKey;
   baseUrl;
   timeout;
@@ -550,6 +728,8 @@ var Scavio = class {
     this.reddit = new RedditNamespace(this);
     this.tiktok = new TikTokNamespace(this);
     this.instagram = new InstagramNamespace(this);
+    this.twitter = new TwitterNamespace(this);
+    this.linkedin = new LinkedInNamespace(this);
   }
   /** @internal */
   async _post(path, body) {