orangeslice 2.1.5 → 2.3.0-beta.0

package/docs/services/predictLeads/companyJobOpenings.ts

@@ -1,102 +1,176 @@
 /**
  * Retrieve company's Job Openings
  * Returns a list of company's Job Openings.
+ *
+ * Use this as a prospecting/enrichment signal, not as source-of-truth validation
+ * that a known company is currently hiring. For current validation, prefer the
+ *
+ * company's official careers page / ATS via services.company.findCareersPage and
+ * services.company.scrapeCareersPage.
  * HTTP GET /companies/{company_id_or_domain}/job_openings
  */
 type companyJobOpenings = (params: {
-  /** Company's ID or domain. */
-  company_id_or_domain: string;
-  /** Set to true if you'd like to receive JobOpenings that are not closed, have last_seen_at more recent than 5 days and were found in the last year. */
-  active_only?: boolean;
-  /** Similar to `active_only`, but without considering `last_seen_at` timestamp. */
-  not_closed?: boolean;
-  /** Only return `JobOpenings` first seen after given date (ISO 8601). */
-  first_seen_at_from?: string;
-  /** Only return `JobOpenings` first seen before given date (ISO 8601). */
-  first_seen_at_until?: string;
-  /** Only return `JobOpenings` last seen after given date (ISO 8601). */
-  last_seen_at_from?: string;
-  /** Only return `JobOpenings` last seen before given date (ISO 8601). */
-  last_seen_at_until?: string;
-  /** Only return JobOpenings that have description. */
-  with_description_only?: boolean;
-  /** Only return JobOpenings that have location. */
-  with_location_only?: boolean;
-  /** Comma-separated (,) `JobOpening` categories. */
-  categories?: Array<"administration" | "consulting" | "data_analysis" | "design" | "directors" | "education" | "engineering" | "finance" | "healthcare_services" | "human_resources" | "information_technology" | "internship" | "legal" | "management" | "marketing" | "military_and_protective_services" | "operations" | "purchasing" | "product_management" | "quality_assurance" | "real_estate" | "research" | "sales" | "software_development" | "support" | "manual_work" | "food">;
-  /** Page number of shown items. **NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for performance reasons. */
-  page?: number;
-  /** Limit the number of shown items per page. */
-  limit?: number;
+   /** Company's ID or domain. */
+   company_id_or_domain: string;
+   /** Set to true if you'd like to receive JobOpenings that are not closed, have last_seen_at more recent than 5 days and were found in the last year. */
+   active_only?: boolean;
+   /** Similar to `active_only`, but without considering `last_seen_at` timestamp. */
+   not_closed?: boolean;
+   /** Only return `JobOpenings` first seen after given date (ISO 8601). */
+   first_seen_at_from?: string;
+   /** Only return `JobOpenings` first seen before given date (ISO 8601). */
+   first_seen_at_until?: string;
+   /** Only return `JobOpenings` last seen after given date (ISO 8601). */
+   last_seen_at_from?: string;
+   /** Only return `JobOpenings` last seen before given date (ISO 8601). */
+   last_seen_at_until?: string;
+   /** Only return JobOpenings that have description. */
+   with_description_only?: boolean;
+   /** Only return JobOpenings that have location. */
+   with_location_only?: boolean;
+   /** Comma-separated (,) `JobOpening` categories. */
+   categories?: Array<
+      | "administration"
+      | "consulting"
+      | "data_analysis"
+      | "design"
+      | "directors"
+      | "education"
+      | "engineering"
+      | "finance"
+      | "healthcare_services"
+      | "human_resources"
+      | "information_technology"
+      | "internship"
+      | "legal"
+      | "management"
+      | "marketing"
+      | "military_and_protective_services"
+      | "operations"
+      | "purchasing"
+      | "product_management"
+      | "quality_assurance"
+      | "real_estate"
+      | "research"
+      | "sales"
+      | "software_development"
+      | "support"
+      | "manual_work"
+      | "food"
+   >;
+   /** Page number of shown items. **NOTE**: If the parameter is not provided, the meta property `count` will be omitted from response for performance reasons. */
+   page?: number;
+   /** Limit the number of shown items per page. */
+   limit?: number;
 }) => Promise<{
-  data: Array<{
-  id: string;
-  type: "job_opening";
-  attributes: {
-  title: string;
-  description: string | null;
-  url: string;
-  first_seen_at: string;
-  last_seen_at: string;
-  last_processed_at: string;
-  contract_types: Array<Record<string, unknown>>;
-  categories: Array<"administration" | "consulting" | "data_analysis" | "design" | "directors" | "education" | "engineering" | "finance" | "healthcare_services" | "human_resources" | "information_technology" | "internship" | "legal" | "management" | "marketing" | "military_and_protective_services" | "operations" | "purchasing" | "product_management" | "quality_assurance" | "real_estate" | "research" | "sales" | "software_development" | "support" | "manual_work" | "food">;
-  onet_data: {
-  code: string | null;
-  family: string | null;
-  occupation_name: string | null;
-};
-  posted_at: string | null;
-  recruiter_data: {
-  name: string | null;
-  title: string | null;
-  contact: string | null;
-};
-  salary: string | null;
-  salary_data: {
-  salary_low: number | null;
-  salary_high: number | null;
-  salary_currency: string | null;
-  salary_low_usd: number | null;
-  salary_high_usd: number | null;
-  salary_time_unit: "hour" | "day" | "week" | "month" | "year" | null;
-};
-  seniority: "not_set" | "founder" | "c_level" | "partner" | "president" | "vice_president" | "head" | "director" | "manager" | "mid_senior" | "junior" | "non_manager";
-  status: "closed" | null;
-  language: string | null;
-  location: string | null;
-  location_data: Array<{
-  city: unknown;
-  state: unknown;
-  zip_code: unknown;
-  country: unknown;
-  region: unknown;
-  continent: unknown;
-  fuzzy_match: unknown;
+   data: Array<{
+      id: string;
+      type: "job_opening";
+      attributes: {
+         title: string;
+         description: string | null;
+         url: string;
+         first_seen_at: string;
+         last_seen_at: string;
+         last_processed_at: string;
+         contract_types: Array<Record<string, unknown>>;
+         categories: Array<
+            | "administration"
+            | "consulting"
+            | "data_analysis"
+            | "design"
+            | "directors"
+            | "education"
+            | "engineering"
+            | "finance"
+            | "healthcare_services"
+            | "human_resources"
+            | "information_technology"
+            | "internship"
+            | "legal"
+            | "management"
+            | "marketing"
+            | "military_and_protective_services"
+            | "operations"
+            | "purchasing"
+            | "product_management"
+            | "quality_assurance"
+            | "real_estate"
+            | "research"
+            | "sales"
+            | "software_development"
+            | "support"
+            | "manual_work"
+            | "food"
+         >;
+         onet_data: {
+            code: string | null;
+            family: string | null;
+            occupation_name: string | null;
+         };
+         posted_at: string | null;
+         recruiter_data: {
+            name: string | null;
+            title: string | null;
+            contact: string | null;
+         };
+         salary: string | null;
+         salary_data: {
+            salary_low: number | null;
+            salary_high: number | null;
+            salary_currency: string | null;
+            salary_low_usd: number | null;
+            salary_high_usd: number | null;
+            salary_time_unit: "hour" | "day" | "week" | "month" | "year" | null;
+         };
+         seniority:
+            | "not_set"
+            | "founder"
+            | "c_level"
+            | "partner"
+            | "president"
+            | "vice_president"
+            | "head"
+            | "director"
+            | "manager"
+            | "mid_senior"
+            | "junior"
+            | "non_manager";
+         status: "closed" | null;
+         language: string | null;
+         location: string | null;
+         location_data: Array<{
+            city: unknown;
+            state: unknown;
+            zip_code: unknown;
+            country: unknown;
+            region: unknown;
+            continent: unknown;
+            fuzzy_match: unknown;
+         }>;
+         tags: Array<Record<string, unknown>>;
+      };
+      relationships: {
+         company: {
+            data: {
+               id: string;
+               type: "company";
+            };
+         };
+      };
+   }>;
+   included: Array<{
+      id: string;
+      type: "company";
+      attributes: {
+         domain: string;
+         company_name: string | null;
+         ticker: string | null;
+      };
+   }>;
+   meta?: {
+      schema_version: string;
+      record_state: "active";
+      count?: number;
+   };
 }>;
-  tags: Array<Record<string, unknown>>;
-};
-  relationships: {
-  company: {
-  data: {
-  id: string;
-  type: "company";
-};
-};
-};
-}>;
-  included: Array<{
-  id: string;
-  type: "company";
-  attributes: {
-  domain: string;
-  company_name: string | null;
-  ticker: string | null;
-};
-}>;
-  meta?: {
-  schema_version: string;
-  record_state: "active";
-  count?: number;
-};
-}>;

package/docs/services/web/search.md

@@ -67,6 +67,22 @@ Web search returns URLs based on keywords, **not confirmed matches**. Scrape the
 
 ---
 
+## Company Subpage Discovery Rule
+
+To find pages on a company's own website, **never search Google by company name**. Always start from the verified domain and dork with `site:` plus `inurl:` hints.
+
+```ts
+await services.web.search({ query: "site:stripe.com inurl:team OR inurl:about OR inurl:careers" });
+```
+
+Never do this for subpage discovery:
+
+```ts
+await services.web.search({ query: '"Stripe" careers' });
+```
+
+---
+
 ## Parallel Query Permutations
 
 Always run multiple query variations for better coverage.
@@ -87,17 +103,17 @@ const allResults = await services.web.batchSearch({
 const uniqueLinks = [...new Set(allResults.flatMap((r) => r.results.map((x) => x.link)))];
 ```
 
-| Use Case       | Permutation Ideas                                        |
-| -------------- | -------------------------------------------------------- |
-| Person search  | Full name, initials, nicknames, with/without middle name |
-| Company search | Full name, abbreviations, domain, Inc/LLC variations     |
-| Title search   | CEO/Founder/Chief, VP/Director, formal/informal titles   |
+| Use Case       | Permutation Ideas                                                           |
+| -------------- | --------------------------------------------------------------------------- |
+| Person search  | Full name, initials, nicknames, with/without middle name                    |
+| Company search | Prefer verified domain first; use name variants only for off-site discovery |
+| Title search   | CEO/Founder/Chief, VP/Director, formal/informal titles                      |
 
 ---
 
 ## Google Dorking
 
-Use `site:` and `inurl:` to target specific platforms.
+Use `site:` and `inurl:` to target specific platforms and verified company domains.
 
 | Platform           | Dork                        | Example                                      |
 | ------------------ | --------------------------- | -------------------------------------------- |
@@ -107,20 +123,19 @@ Use `site:` and `inurl:` to target specific platforms.
 | Reddit             | `site:reddit.com`           | `site:reddit.com/r/sales "cold email"`       |
 
 ```ts
-// Find company employees with multiple dork variations
-const company = "Stripe";
+// Find company subpages from a verified domain
+const domain = "stripe.com";
 const queries = [
-   `"${company}" site:linkedin.com/in`,
-   `"${company}" CEO OR Founder site:linkedin.com/in`,
-   `"${company}" VP OR Director site:linkedin.com/in`,
-   `"${company}" Engineer site:linkedin.com/in`,
-   `stripe.com site:linkedin.com/in`
+   `site:${domain} inurl:team OR inurl:about OR inurl:leadership`,
+   `site:${domain} inurl:careers OR inurl:jobs`,
+   `site:${domain} inurl:blog OR inurl:news OR inurl:press`,
+   `site:${domain} inurl:contact OR inurl:locations`
 ];
 
 const results = await services.web.batchSearch({
    queries: queries.map((query) => ({ query }))
 });
-const profiles = [...new Set(results.flatMap((r) => r.results.map((x) => x.link)))];
+const subpages = [...new Set(results.flatMap((r) => r.results.map((x) => x.link)))];
 ```
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orangeslice",
-  "version": "2.1.5",
+  "version": "2.3.0-beta.0",
   "description": "B2B LinkedIn database prospector - 1.15B profiles, 85M companies",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",