scrapebadger 0.19.0 → 0.21.0

package/dist/index.js

@@ -6558,6 +6558,172 @@ var DepopClient = class {
   }
 };
 
+// src/linkedin/client.ts
+var LinkedInClient = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Search LinkedIn jobs (guest search API).
+   *
+   * @param options - Optional parameters (keywords, location, geoId, companyId,
+   *   datePosted, experience, jobType, workplace, sort, start, country).
+   * @returns Jobs search response with matching job cards and pagination meta.
+   * @throws AuthenticationError - If the API key is invalid.
+   * @throws ValidationError - If the parameters are invalid.
+   */
+  async jobsSearch(options = {}) {
+    return this.client.request("/v1/linkedin/jobs/search", {
+      params: {
+        keywords: options.keywords,
+        location: options.location,
+        geo_id: options.geoId,
+        company_id: options.companyId,
+        date_posted: options.datePosted,
+        experience: options.experience,
+        job_type: options.jobType,
+        workplace: options.workplace,
+        sort: options.sort,
+        start: options.start ?? 0,
+        country: options.country ?? "us"
+      }
+    });
+  }
+  /**
+   * Get full detail for one LinkedIn job posting.
+   *
+   * @param jobId - The numeric LinkedIn job id.
+   * @param options - Optional parameters (country).
+   * @returns Full job detail.
+   * @throws NotFoundError - If the job doesn't exist.
+   */
+  async getJob(jobId, options = {}) {
+    return this.client.request(`/v1/linkedin/jobs/${jobId}`, {
+      params: { country: options.country ?? "us" }
+    });
+  }
+  /**
+   * Get a company's job postings.
+   *
+   * @param companyId - The numeric LinkedIn company id.
+   * @param options - Optional parameters (start, country).
+   * @returns Jobs search response with the company's job cards and pagination meta.
+   * @throws NotFoundError - If the company doesn't exist.
+   */
+  async companyJobs(companyId, options = {}) {
+    return this.client.request(
+      `/v1/linkedin/companies/${companyId}/jobs`,
+      {
+        params: {
+          start: options.start ?? 0,
+          country: options.country ?? "us"
+        }
+      }
+    );
+  }
+  /**
+   * Get a public LinkedIn company page.
+   *
+   * @param universalName - The company's universal name (URL slug).
+   * @param options - Optional parameters (country).
+   * @returns Company profile.
+   * @throws NotFoundError - If the company doesn't exist.
+   */
+  async getCompany(universalName, options = {}) {
+    return this.client.request(`/v1/linkedin/companies/${universalName}`, {
+      params: { country: options.country ?? "us" }
+    });
+  }
+  /**
+   * Get a public LinkedIn school page.
+   *
+   * @param universalName - The school's universal name (URL slug).
+   * @param options - Optional parameters (country).
+   * @returns School profile.
+   * @throws NotFoundError - If the school doesn't exist.
+   */
+  async getSchool(universalName, options = {}) {
+    return this.client.request(`/v1/linkedin/schools/${universalName}`, {
+      params: { country: options.country ?? "us" }
+    });
+  }
+  /**
+   * Get a public LinkedIn profile.
+   *
+   * @param publicId - The profile's public id (URL slug).
+   * @param options - Optional parameters (country).
+   * @returns Public profile.
+   * @throws NotFoundError - If the profile doesn't exist.
+   */
+  async getProfile(publicId, options = {}) {
+    return this.client.request(`/v1/linkedin/profiles/${publicId}`, {
+      params: { country: options.country ?? "us" }
+    });
+  }
+  /**
+   * Get a public LinkedIn post (activity share).
+   *
+   * @param postSlug - The post slug (last URL segment).
+   * @param options - Optional parameters (country).
+   * @returns Post detail.
+   * @throws NotFoundError - If the post doesn't exist.
+   */
+  async getPost(postSlug, options = {}) {
+    return this.client.request(`/v1/linkedin/posts/${postSlug}`, {
+      params: { country: options.country ?? "us" }
+    });
+  }
+  /**
+   * Get a public LinkedIn article (`/pulse/`).
+   *
+   * @param articleSlug - The article slug (last URL segment).
+   * @param options - Optional parameters (country).
+   * @returns Article detail (Post shape).
+   * @throws NotFoundError - If the article doesn't exist.
+   */
+  async getArticle(articleSlug, options = {}) {
+    return this.client.request(`/v1/linkedin/articles/${articleSlug}`, {
+      params: { country: options.country ?? "us" }
+    });
+  }
+  /**
+   * Get a public LinkedIn Learning course.
+   *
+   * @param courseSlug - The course slug (last URL segment).
+   * @param options - Optional parameters (country).
+   * @returns Course detail.
+   * @throws NotFoundError - If the course doesn't exist.
+   */
+  async getCourse(courseSlug, options = {}) {
+    return this.client.request(`/v1/linkedin/learning/${courseSlug}`, {
+      params: { country: options.country ?? "us" }
+    });
+  }
+  /**
+   * Suggest geo / company ids for a query (typeahead).
+   *
+   * @param query - Location or company name, e.g. "London".
+   * @param type - "geo" | "company" (default: "geo").
+   * @returns Geo-suggest response with matching suggestions.
+   */
+  async geoSuggest(query, type = "geo") {
+    return this.client.request("/v1/linkedin/geo/suggest", {
+      params: { query, type }
+    });
+  }
+  /**
+   * LinkedIn scraper health check.
+   *
+   * Free — this endpoint costs no credits.
+   *
+   * @returns Health payload (status, service, version, products).
+   */
+  async health() {
+    return this.client.request("/v1/linkedin/health");
+  }
+};
+
 // src/client.ts
 var ScrapeBadger = class {
   baseClient;
@@ -6595,6 +6761,8 @@ var ScrapeBadger = class {
   loopnet;
   /** Depop scraper API client — search, product, user, user products, markets (www.depop.com, 10 markets) */
   depop;
+  /** LinkedIn scraper API client — 11 no-auth endpoints (jobs, company, school, profile, post, article, learning, geo) */
+  linkedin;
   /**
    * Create a new ScrapeBadger client.
    *
@@ -6646,6 +6814,7 @@ var ScrapeBadger = class {
     this.immobiliare = new ImmobiliareClient(this.baseClient);
     this.loopnet = new LoopNetClient(this.baseClient);
     this.depop = new DepopClient(this.baseClient);
+    this.linkedin = new LinkedInClient(this.baseClient);
   }
 };
 
@@ -6693,6 +6862,7 @@ exports.LeboncoinClient = LeboncoinClient;
 exports.LeboncoinReferenceClient = ReferenceClient8;
 exports.LeboncoinSearchClient = SearchClient10;
 exports.LeboncoinSellersClient = SellersClient3;
+exports.LinkedInClient = LinkedInClient;
 exports.ListsClient = ListsClient;
 exports.LoopNetBrokersClient = BrokersClient;
 exports.LoopNetClient = LoopNetClient;