scavio 0.9.0 → 0.10.0

package/README.md

@@ -205,29 +205,36 @@ await client.x.trending({ country: "UnitedStates" });
 ### LinkedIn
 
 ```typescript
-// Person profile, about, posts, and contact
+// Person profile, about, and posts. A handle or a full LinkedIn URL works
+// anywhere a reference is taken.
 await client.linkedin.person({ username: "williamhgates" });
-await client.linkedin.personAbout({ username: "williamhgates" });
+await client.linkedin.personAbout({ url: "https://www.linkedin.com/in/williamhgates/" });
 await client.linkedin.personPosts({ username: "williamhgates" });
-await client.linkedin.personContact({ username: "williamhgates" });
 
-// Company profile, posts, people, and jobs
+// Company profile and posts
 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" });
+
+// Jobs: search, then pull detail for one listing
+await client.linkedin.searchJobs({ search: "software engineer", location: "United States" });
+await client.linkedin.job({ job_id: "4415427228" });
+
+// A post and its comments (10 per page)
+await client.linkedin.post({ post_id: "7488618410256523265" });
+await client.linkedin.postComments({ post_id: "7488618410256523265", page: 1 });
 ```
 
+All LinkedIn endpoints cost 1 credit.
+
+> **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
+> billed. `company()` returns `featured_employees` (a small sample of staff), and
+> `searchJobs()` with a company name substitutes for `companyJobs()`.
+>
+> `personPosts` and `companyPosts` return up to 50 posts; the provider exposes no
+> further pages, so those endpoints no longer take a cursor.
+
 ### TikTok
 
 ```typescript

package/dist/index.cjs

@@ -756,48 +756,78 @@ var LinkedInNamespace = class {
     this.client = client;
   }
   client;
+  /** Full profile: about text, experience, education, honours and links. */
   async person(options) {
     return this.client._post("/api/v1/linkedin/person", options);
   }
+  /** The about-only slice of the profile payload. */
   async personAbout(options) {
     return this.client._post("/api/v1/linkedin/person/about", options);
   }
+  /** Recent posts, up to 50. Upstream exposes no further pages. */
   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);
-  }
+  /** Company profile, including locations and featured employees. */
   async company(options) {
     return this.client._post("/api/v1/linkedin/company", options);
   }
+  /** Recent company posts, up to 50. Upstream exposes no further pages. */
   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);
-  }
+  /** Job search. Upstream rotates its result set, so repeat calls differ. */
   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);
-  }
+  /** Full detail for one job listing, including the hiring company. */
   async job(options) {
     return this.client._post("/api/v1/linkedin/job", options);
   }
+  /** Full detail for one post, including its top visible comments. */
   async post(options) {
     return this.client._post("/api/v1/linkedin/post", options);
   }
+  /** Comments with their replies, 10 per page. */
   async postComments(options) {
     return this.client._post("/api/v1/linkedin/post/comments", options);
   }
+  /**
+   * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+   * never billed.
+   */
+  async personContact(options) {
+    return this.client._post("/api/v1/linkedin/person/contact", options);
+  }
+  /**
+   * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+   * never billed. `company()` returns `featured_employees`, a small sample of
+   * staff profiles.
+   */
+  async companyPeople(options) {
+    return this.client._post("/api/v1/linkedin/company/people", options);
+  }
+  /**
+   * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+   * never billed. Use `searchJobs()` with the company name as the search term.
+   */
+  async companyJobs(options) {
+    return this.client._post("/api/v1/linkedin/company/jobs", options);
+  }
+  /**
+   * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+   * never billed.
+   */
+  async searchPeople(options) {
+    return this.client._post("/api/v1/linkedin/search/people", options);
+  }
+  /**
+   * @deprecated Retired by the upstream provider. Always returns HTTP 410 and is
+   * never billed.
+   */
+  async searchPosts(options) {
+    return this.client._post("/api/v1/linkedin/search/posts", options);
+  }
 };
 
 // src/client.ts